About loop-agent
A skill for running workflow agents iteratively to improve results until quality criteria are met. It supports fixed, criteria-based, convergence, and hybrid stopping modes for tasks such as code refinement, test-fix cycles, and performance optimization.
Key features
- 01Use four loop termination modes
- 02Apply common iterative workflow patterns
- 03Refine results against quality criteria
- 04Support test-fix and optimization cycles
Use cases
- 01Refine code over multiple passes to meet standards
- 02Repeat tests and fixes
- 03Improve performance progressively and assess gains
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/loop-agentin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
configuration.mdexamples.mdmodes.mdpatterns.mdevals/evals.jsonDetails
From the project READMELoop Agent Skill
Execute workflow agents iteratively for refinement and progressive improvement until quality criteria are met.
Quick Reference
- Modes - Loop termination modes (fixed, criteria, convergence, hybrid)
- Patterns - Common loop patterns (refinement, test-fix, optimization)
- Configuration - Loop setup and templates
- Examples - Complete loop examples
When to Use
- Code needs iterative refinement until quality standards met
- Tests need repeated fix-validate cycles
- Performance requires progressive optimization
- Quality improvements need multiple passes
- Feedback loops necessary for convergence
NOT Appropriate For
- Single-pass tasks (use specialized agent)
- Purely parallel work (use agent-coordination)
- Simple linear workflows (use sequential)
- One-time analysis
Core Concepts
Loop Termination Modes
| Mode | Description | Use When |
|---|---|---|
| Fixed | Run exactly N iterations | Known number of passes needed |
| Criteria | Until success criteria met | Specific quality/performance targets |
| Convergence | Stop at diminishing returns | Optimal result unknown |
| Hybrid | Combine multiple conditions | Complex requirements |
See modes.md for detailed mode documentation and patterns.md for common loop patterns.
Comments
Markdown supported