Agent skill · software engineering · aiskillstore

iterative-runner

Runs Claude in a retry loop until tests pass or task completes. Use for TDD loops, overnight builds, or any task needing repeated iteration until success. Triggers on: loop until done, keep trying, retry until pass, TDD loop, iterate until tests pass.

Why this skill is useful

Adds an executable script for a retry loop that enhances automated testing and development workflows.

What it needs

Requires claude installed locally. About 1k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.

What this skill does

Iterative Runner Runs Claude in a persistent loop that keeps retrying until tests pass or the task is complete. When to Use Running TDD loops that iterate until all tests pass Overnight builds that need to keep trying until successful Any task requiring repeated attempts until completion criteria are met Automated retry for flaky or complex implementations Core Concept Keep iterating until task is complete. Workflow Step 1: Define Completion Criteria Specify clear success conditions: All tests passing No linter errors Specific output marker (e.g., <promise>DONE</promise>) Step 2: Set Safety Limits Always use --max-iterations to prevent infinite loops. Step 3: Run the Loop Prompt Best Practices 1. Clear completion criteria - Define what "done" means 2. Incremental goals - Break into phases 3. Self-correction - Include retry logic 4. Escape hatch - Always use --max-iterations Template

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills aiskillstore/iterative-runner

View the source on GitHub

Browse the @skills marketplace