shark

Spawn parallel timed sub-agents to eliminate blocking I/O waits in AI coding agents.

12|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/keugenek/shark --skill shark
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shark
Source: https://github.com/keugenek/shark/tree/main
Command: npx skills add https://github.com/keugenek/shark --skill shark

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI coding agents waste the majority of their runtime waiting for slow tools like web searches, builds, and API calls, consuming expensive LLM compute while idle.

Core Features & Use Cases

  • Non-blocking execution model: Spawn parallel timed sub-agents called remoras for any operation expected to take longer than 30 seconds.
  • Pilot fish pre-analysis: Opportunistically pre-draft results when early remoras complete while others are still running.
  • Universal compatibility: Works with Claude Code, Codex, Gemini CLI, Cursor, Windsurf, Aider, and OpenClaw.
  • Progress tracking: Chat-friendly Unicode progress bars show remora status in real time.

Quick Start

Use the shark skill to decompose your task and spawn background remoras for any slow operation while continuing to reason in parallel.

Frequently Asked Questions about shark

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent AI coding agents from blocking during slow builds and web searches?

To prevent AI coding agents from blocking during slow builds and web searches, spawn parallel timed sub-agents for operations exceeding 30 seconds. This non-blocking execution model allows the primary agent to continue reasoning while waiting for I/O operations to complete.

How does parallel sub-agent execution work for multi-step coding tasks?

Parallel sub-agent execution works by spawning background remoras for slow operations while enforcing a 30-second maximum per LLM turn. It includes pilot fish pre-analysis to opportunistically pre-draft results when early remoras complete, ensuring continuous progress.

Can I use non-blocking sub-agents with Claude Code, Cursor, and Gemini CLI?

Yes, you can use non-blocking sub-agents with Claude Code, Cursor, and Gemini CLI. The execution model is universally compatible across multiple AI coding agents including Codex, Windsurf, Aider, and OpenClaw.

What happens when a background sub-agent times out or fails during execution?

When a background sub-agent times out or fails, the system enforces graceful degradation on failures. It uses explicit timeout budgets with a 30-second maximum per LLM turn and provides real-time progress reporting to track remora status.

Why does my AI agent consume high compute while idle during long API calls?

AI agents consume high compute while idle during long API calls because they block execution while waiting for I/O operations. Spawning parallel timed sub-agents for slow operations eliminates this waste by allowing concurrent reasoning.