# Loop Agent

> Execute workflow agents iteratively for refinement and progressive improvement until quality criteria are met. Use when tasks require repetitive refinement, multi-iteration improvements, progressive optimization, or feedback loops until convergence. Use when this capability is needed.

- Skill: `tomevault-io/loop-agent` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/loop-agent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/loop-agent/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/loop-agent

---


# Loop Agent Skill

Execute workflow agents iteratively for refinement and progressive improvement until quality criteria are met.

## Quick Reference

- **[Modes](modes.md)** - Loop termination modes (fixed, criteria, convergence, hybrid)
- **[Patterns](patterns.md)** - Common loop patterns (refinement, test-fix, optimization)
- **[Configuration](configuration.md)** - Loop setup and templates
- **[Examples](examples.md)** - 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 parallel-execution)
- 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](modes.md)** for detailed mode documentation and **[patterns.md](patterns.md)** for common loop patterns.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/d-o-hub) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->

