Agent Loops
Prebuilt multi-agent workflows that chain sequential and parallel steps, with real output passing between agents.
Description
Agent Loops orchestrates multi-step agent pipelines. Each workflow defines a sequence of steps; each step runs via claude -p with a role-specific system prompt and agent-swarm model routing. Outputs chain between steps so each agent builds on the previous one's work.
Use when the user wants to:
- Build, create, or ship anything — apps, webapps, websites, mobile apps (iPhone/Android), desktop apps, APIs, CLIs, bots, dashboards, landing pages, SaaS products, MVPs, prototypes, plugins, extensions, microservices
- Fix, debug, troubleshoot, or diagnose bugs, errors, crashes, or failing tests
- Review, audit, or inspect code for bugs, security vulnerabilities, or quality issues
- Research, investigate, compare, or write reports on any topic
- Refactor, restructure, clean up, optimize, or modernize code
- Test, review, and publish a skill to ClawHub
Installation
clawhub install agent-loops
Or clone into your skills directory:
git clone https://github.com/OpenClaw/agent-loops.git workspace/skills/agent-loops
Requires PyYAML for YAML workflows:
pip install pyyaml
Usage
Workflow selection — match the user's intent to a workflow:
| User says something like... |
Workflow |
| "build me an app", "create a webapp", "make a website", "ship this feature", "develop a mobile app", "launch a SaaS", "make an iPhone app", "build an Android app", "create a desktop app", "make a CLI tool", "build an API", "create a bot", "make a dashboard", "build a landing page", "create an MVP", "prototype X", "add dark mode", "implement Y", "build a plugin", "make an extension", "create a service", "spin up a microservice", "scaffold a project" |
ship_feature |
| "fix this bug", "debug X", "why is Y broken", "troubleshoot this error", "diagnose the crash", "this isn't working", "something's wrong with X", "getting an error when", "it crashes on", "the build is failing", "tests are broken", "patch this issue", "hotfix for X" |
bug_fix |
| "review this code", "audit the codebase", "check for security issues", "inspect this PR", "find bugs in X", "analyze this module", "is this code safe", "check for vulnerabilities", "look over my changes", "do a security review", "scan for issues", "evaluate code quality" |
code_review |
| "research X", "compare A vs B", "write a report on", "investigate Y", "explore options for", "what are the best practices for", "study the landscape of", "deep dive into", "summarize the state of", "pros and cons of", "analyze the market for", "write up findings on" |
research_report |
| "refactor X", "clean up this code", "restructure Y", "reorganize the codebase", "optimize this module", "modernize the architecture", "reduce tech debt", "simplify this", "extract a service", "decouple X from Y", "improve code structure", "make this more maintainable" |
refactor |
| "publish this skill", "push to ClawHub", "release this skill", "deploy to ClawHub", "ship this skill", "get this skill ready for publish" |
skill_publish |
Command pattern:
python3 workspace/skills/agent-loops/scripts/run_workflow.py <workflow> "<user's request>" --apply
Pass the user's natural language request as the input. The workflow handles scoping, delegation, and output chaining automatically.
Examples
Example 1: Ship a feature
Scenario: You want to scope, implement, and document a new feature.
Action: python3 workspace/skills/agent-loops/scripts/run_workflow.py ship_feature "Add dark mode toggle to settings" --apply
Outcome: PM scopes tasks, Dev implements with tests, Editor writes docs and changelog.
Example 2: Fix a bug
Scenario: A bug needs diagnosis, a fix, and regression tests.
Action: python3 workspace/skills/agent-loops/scripts/run_workflow.py bug_fix "Login page crashes on empty password" --apply
Outcome: Dev diagnoses root cause, Dev implements fix, Tester writes regression test, Editor documents the change.
Example 3: Parallel code review
Scenario: You want a code review and security audit run simultaneously.
Action: python3 workspace/skills/agent-loops/scripts/run_workflow.py code_review "Review the auth module" --apply
Outcome: Reviewer and Security auditor run in parallel, then Editor synthesizes a unified summary.
Example 4: Override model
Scenario: You want all steps to use a specific model.
Action: python3 workspace/skills/agent-loops/scripts/run_workflow.py research_report "Compare REST vs GraphQL" --apply --model sonnet
Outcome: All steps run with the specified model instead of agent-swarm routing.
Commands
python3 workspace/skills/agent-loops/scripts/run_workflow.py <workflow> "<input>" # Dry-run a workflow
python3 workspace/skills/agent-loops/scripts/run_workflow.py <workflow> "<input>" --apply # Run agents for real
python3 workspace/skills/agent-loops/scripts/run_workflow.py --list # List available workflows
python3 workspace/skills/agent-loops/scripts/run_workflow.py --list --json # List workflows as JSON
python3 workspace/skills/agent-loops/scripts/run_workflow.py <workflow> "<input>" --apply --json # Output results as JSON
python3 workspace/skills/agent-loops/scripts/run_workflow.py <workflow> "<input>" --model sonnet # Override model for all steps
python3 workspace/skills/agent-loops/scripts/run_workflow.py <workflow> "<input>" --timeout 900 # Set per-step timeout (seconds)
python3 workspace/skills/agent-loops/scripts/run_workflow.py <workflow> "<input>" -v # Verbose output
<workflow> — Workflow id: ship_feature, bug_fix, code_review, research_report, refactor, skill_publish--apply — Actually spawn agents (default is dry-run)--list — List all available workflows--json — Output results as JSON for programmatic use--model — Override agent-swarm routing with a specific model--timeout — Per-step timeout in seconds (default: 600)-v — Show full task text per step
1---2name: agent-loops3description: Multi-agent workflow orchestrator. Use when the user asks to build, create, make, ship, develop, or launch any software (apps, webapps, websites, mobile apps, APIs, tools, bots, dashboards, SaaS, MVPs); fix or debug bugs; review or audit code; research topics; refactor code; or publish skills.4---56# Agent Loops78Prebuilt multi-agent workflows that chain sequential and parallel steps, with real output passing between agents.910## Description1112Agent Loops orchestrates multi-step agent pipelines. Each workflow defines a sequence of steps; each step runs via `claude -p` with a role-specific system prompt and agent-swarm model routing. Outputs chain between steps so each agent builds on the previous one's work.1314Use when the user wants to:15- Build, create, or ship anything — apps, webapps, websites, mobile apps (iPhone/Android), desktop apps, APIs, CLIs, bots, dashboards, landing pages, SaaS products, MVPs, prototypes, plugins, extensions, microservices16- Fix, debug, troubleshoot, or diagnose bugs, errors, crashes, or failing tests17- Review, audit, or inspect code for bugs, security vulnerabilities, or quality issues18- Research, investigate, compare, or write reports on any topic19- Refactor, restructure, clean up, optimize, or modernize code20- Test, review, and publish a skill to ClawHub2122## Installation2324```bash25clawhub install agent-loops26```2728Or clone into your skills directory:2930```bash31git clone https://github.com/OpenClaw/agent-loops.git workspace/skills/agent-loops32```3334Requires PyYAML for YAML workflows:3536```bash37pip install pyyaml38```3940## Usage4142**Workflow selection — match the user's intent to a workflow:**4344| User says something like... | Workflow |45|------------------------------|----------|46| "build me an app", "create a webapp", "make a website", "ship this feature", "develop a mobile app", "launch a SaaS", "make an iPhone app", "build an Android app", "create a desktop app", "make a CLI tool", "build an API", "create a bot", "make a dashboard", "build a landing page", "create an MVP", "prototype X", "add dark mode", "implement Y", "build a plugin", "make an extension", "create a service", "spin up a microservice", "scaffold a project" | `ship_feature` |47| "fix this bug", "debug X", "why is Y broken", "troubleshoot this error", "diagnose the crash", "this isn't working", "something's wrong with X", "getting an error when", "it crashes on", "the build is failing", "tests are broken", "patch this issue", "hotfix for X" | `bug_fix` |48| "review this code", "audit the codebase", "check for security issues", "inspect this PR", "find bugs in X", "analyze this module", "is this code safe", "check for vulnerabilities", "look over my changes", "do a security review", "scan for issues", "evaluate code quality" | `code_review` |49| "research X", "compare A vs B", "write a report on", "investigate Y", "explore options for", "what are the best practices for", "study the landscape of", "deep dive into", "summarize the state of", "pros and cons of", "analyze the market for", "write up findings on" | `research_report` |50| "refactor X", "clean up this code", "restructure Y", "reorganize the codebase", "optimize this module", "modernize the architecture", "reduce tech debt", "simplify this", "extract a service", "decouple X from Y", "improve code structure", "make this more maintainable" | `refactor` |51| "publish this skill", "push to ClawHub", "release this skill", "deploy to ClawHub", "ship this skill", "get this skill ready for publish" | `skill_publish` |5253**Command pattern:**54```bash55python3 workspace/skills/agent-loops/scripts/run_workflow.py <workflow> "<user's request>" --apply56```5758Pass the user's natural language request as the input. The workflow handles scoping, delegation, and output chaining automatically.5960## Examples6162**Example 1: Ship a feature**63*Scenario:* You want to scope, implement, and document a new feature.64*Action:* `python3 workspace/skills/agent-loops/scripts/run_workflow.py ship_feature "Add dark mode toggle to settings" --apply`65*Outcome:* PM scopes tasks, Dev implements with tests, Editor writes docs and changelog.6667**Example 2: Fix a bug**68*Scenario:* A bug needs diagnosis, a fix, and regression tests.69*Action:* `python3 workspace/skills/agent-loops/scripts/run_workflow.py bug_fix "Login page crashes on empty password" --apply`70*Outcome:* Dev diagnoses root cause, Dev implements fix, Tester writes regression test, Editor documents the change.7172**Example 3: Parallel code review**73*Scenario:* You want a code review and security audit run simultaneously.74*Action:* `python3 workspace/skills/agent-loops/scripts/run_workflow.py code_review "Review the auth module" --apply`75*Outcome:* Reviewer and Security auditor run in parallel, then Editor synthesizes a unified summary.7677**Example 4: Override model**78*Scenario:* You want all steps to use a specific model.79*Action:* `python3 workspace/skills/agent-loops/scripts/run_workflow.py research_report "Compare REST vs GraphQL" --apply --model sonnet`80*Outcome:* All steps run with the specified model instead of agent-swarm routing.8182## Commands8384```bash85python3 workspace/skills/agent-loops/scripts/run_workflow.py <workflow> "<input>" # Dry-run a workflow86python3 workspace/skills/agent-loops/scripts/run_workflow.py <workflow> "<input>" --apply # Run agents for real87python3 workspace/skills/agent-loops/scripts/run_workflow.py --list # List available workflows88python3 workspace/skills/agent-loops/scripts/run_workflow.py --list --json # List workflows as JSON89python3 workspace/skills/agent-loops/scripts/run_workflow.py <workflow> "<input>" --apply --json # Output results as JSON90python3 workspace/skills/agent-loops/scripts/run_workflow.py <workflow> "<input>" --model sonnet # Override model for all steps91python3 workspace/skills/agent-loops/scripts/run_workflow.py <workflow> "<input>" --timeout 900 # Set per-step timeout (seconds)92python3 workspace/skills/agent-loops/scripts/run_workflow.py <workflow> "<input>" -v # Verbose output93```9495- **`<workflow>`** — Workflow id: `ship_feature`, `bug_fix`, `code_review`, `research_report`, `refactor`, `skill_publish`96- **`--apply`** — Actually spawn agents (default is dry-run)97- **`--list`** — List all available workflows98- **`--json`** — Output results as JSON for programmatic use99- **`--model`** — Override agent-swarm routing with a specific model100- **`--timeout`** — Per-step timeout in seconds (default: 600)101- **`-v`** — Show full task text per step
dvcrn