shark-loop

Run shark.ps1/shark.sh loop enforcer with OS-level timeout per turn

9 stars

Best use case

shark-loop is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Run shark.ps1/shark.sh loop enforcer with OS-level timeout per turn

Teams using shark-loop should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/shark-loop/SKILL.md --create-dirs "https://raw.githubusercontent.com/keugenek/shark/main/commands/shark-loop/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/shark-loop/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How shark-loop Compares

Feature / Agentshark-loopStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Run shark.ps1/shark.sh loop enforcer with OS-level timeout per turn

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Shark Loop (External Enforcer)

Run the shark loop enforcer script which wraps `claude --print` with a hard OS-level timeout per turn.

## Instructions

Parse the arguments:
- The main text is the TASK_DESCRIPTION
- `--max-loops N` sets SHARK_MAX_LOOPS (default: 50)
- `--timeout S` sets SHARK_LOOP_TIMEOUT in seconds (default: 25)

On Windows (PowerShell), run:
```powershell
$env:SHARK_MAX_LOOPS = "<N>"
$env:SHARK_LOOP_TIMEOUT = "<S>"
& "$SKILL_DIR\..\shark.ps1" "<TASK_DESCRIPTION>"
```

On Linux/Mac, run:
```
SHARK_MAX_LOOPS=<N> SHARK_LOOP_TIMEOUT=<S> bash "$SKILL_DIR/../shark.sh" "<TASK_DESCRIPTION>"
```

Report the result when complete.

Related Skills

shark-exec

9
from keugenek/shark

No description provided.

shark-status

9
from keugenek/shark

Check status of shark-exec background jobs, .shark-done, and SHARK_LOG.md

shark-clean

9
from keugenek/shark

Clean up shark state files (.shark-done, SHARK_LOG.md, pending.json, timings.jsonl)

shark-autotune

9
from keugenek/shark

Analyse shark timing history and recommend optimal SHARK_LOOP_TIMEOUT and SHARK_MAX_LOOPS settings

shark

9
from keugenek/shark

No description provided.

performing-network-traffic-analysis-with-tshark

16
from plurigrid/asi

Automate network traffic analysis using tshark and pyshark for protocol statistics, suspicious flow detection, DNS anomaly identification, and IOC extraction from PCAP files

performing-network-forensics-with-wireshark

16
from plurigrid/asi

Capture and analyze network traffic using Wireshark and tshark to reconstruct network events, extract artifacts, and identify malicious communications.

catcolab-causal-loop

16
from plurigrid/asi

CatColab Causal Loop Diagrams - systems dynamics modeling with reinforcing (R) and balancing (B) feedback loops, delays, and Lotka-Volterra semantics for strategic analysis.

analyzing-network-traffic-with-wireshark

16
from plurigrid/asi

Captures and analyzes network packet data using Wireshark and tshark to identify malicious traffic patterns, diagnose protocol issues, extract artifacts, and support incident response investigations on authorized network segments.

self-validation-loop

16
from plurigrid/asi

Run self-validation loops for triadic color systems using prediction vs observation and error minimization.

repo-change-loop

16
from woojubb/robota

Runs the standard Robota change loop by identifying impact, building affected scope, running targeted verification, and summarizing residual risk. Use when making or reviewing repository changes that should end in an explicit verification result.

cfn-loop-validation

14
from masharratt/claude-flow-novice

Multi-layer validation and quality gates for CFN Loop workflows. Use when implementing gate checks, consensus validation, or enforcing clean agent exit patterns.