← Back to Skills Marketplace
131
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install shark
Description
Enables non-blocking AI agent execution by spawning parallel remora subagents for slow tasks, keeping the main agent responsive and efficient.
Usage Guidance
What this skill will actually do: it spawns background jobs, writes and reads state files (pending.json, timings.jsonl, .shark-done, SHARK_LOG.md), schedules a periodic poller/cron job, and may run arbitrary shell commands (gh, ssh, build/test commands, or launch an LLM runtime). These capabilities are coherent with 'non-blocking execution' but mean the skill can execute anything your agent/runtime user can — including commands that access SSH keys, GitHub tokens, or other workspace secrets. Before installing: (1) review the included scripts (shark.sh and poll-and-deliver.js) to ensure they do only what you expect; (2) run the skill in an isolated environment or a sandboxed agent first; (3) restrict runtime permissions if possible (avoid giving the skill access to secrets or global cron unless necessary); (4) be cautious about the calls that use 'powershell -ExecutionPolicy Bypass' and 'claude --permission-mode bypassPermissions' since those flags relax protections; (5) if you install, periodically check pending.json and any created cron jobs and remove them when not needed.
Capability Analysis
Type: OpenClaw Skill
Name: shark
Version: 0.1.0
The 'shark' skill implements a non-blocking execution framework for AI agents, referred to as the 'Shark Pattern.' It provides instructions and scripts (shark.sh, shark-exec/SKILL.md) to decompose slow tasks into parallel sub-agents ('remoras') or background processes, ensuring the main agent turn remains responsive (under 30 seconds). The skill utilizes standard OpenClaw features such as sessions_spawn, cron-based polling, and background execution to manage these tasks. While the implementation involves complex agent instructions for state management and process monitoring, the behavior is entirely consistent with the stated goal of optimizing agent performance and lacks any indicators of malicious intent or unauthorized data access.
Capability Assessment
Purpose & Capability
Name/description (non-blocking execution via remora subagents) matches the included SKILL.md, helper scripts (shark.sh) and the shark-exec poller. The skill asks for no unrelated credentials or env vars and its code implements the described background-exec + poller pattern.
Instruction Scope
The SKILL.md instructs the agent to spawn background processes, create/modify state files (pending.json, timings.jsonl, .shark-done, SHARK_LOG.md), schedule a recurring poller/cron worker, and kill or deliver outputs from jobs. All of this is coherent with the stated purpose, but it does grant the skill broad ability to execute arbitrary shell commands and read/write workspace files — behavior you should expect but verify you are comfortable granting.
Install Mechanism
This is instruction-only with included helper scripts; recommended install examples pull from GitHub raw URLs and git clones from the project's repo — standard and traceable. There is no opaque download+extract from unknown personal servers in the install spec.
Credentials
The skill declares no required env vars or credentials. However, its instructions explicitly run SSH commands, GH CLI, long-running shell commands, and call agent runtimes (claude with --permission-mode bypassPermissions / powershell -ExecutionPolicy Bypass). If those tools are present, the skill will execute commands with the user's runtime privileges and can therefore access any workspace secrets (SSH keys, GitHub tokens, env vars) available to that runtime. This is expected for a background-exec pattern but important to be aware of.
Persistence & Privilege
The skill schedules poller/cron jobs and writes state files so it can operate across turns. always:false (no forced inclusion) and disable-model-invocation:false (normal). Scheduling cron/poller jobs gives the skill an autonomous execution surface (periodic agent turns) which is required for its function but increases blast radius — review what privileges the runtime's cron/agent scheduler has before allowing it to create persistent pollers.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install shark - After installation, invoke the skill by name or use
/shark - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Shark Pattern skill initial release.
- Introduces the Shark Pattern for universal non-blocking execution in AI coding agents.
- Main agent never blocks on slow tools; instead, spawns "remora" subagents for parallel background execution.
- Outlines lifecycle, key rules, and clear examples for implementation.
- Defines progress reporting format and output conventions (e.g., Unicode progress bars).
- Describes "pilot fish" sub-pattern for opportunistic time-bounded sub-analysis during blocking waits.
- Provides guidelines for tool classification, timing budgets, and decision criteria for spawning subagents.
Metadata
Frequently Asked Questions
What is Shark?
Enables non-blocking AI agent execution by spawning parallel remora subagents for slow tasks, keeping the main agent responsive and efficient. It is an AI Agent Skill for Claude Code / OpenClaw, with 131 downloads so far.
How do I install Shark?
Run "/install shark" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Shark free?
Yes, Shark is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Shark support?
Shark is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Shark?
It is built and maintained by keugenek (@keugenek); the current version is v0.1.0.
More Skills