auto-iterate

Iteratively apply targeted edits and keep higher-scoring versions via git branches.

1|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/rongarede/claude-skills-orchestration --skill auto-iterate-rongarede
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: auto-iterate
Source: https://github.com/rongarede/claude-skills-orchestration/tree/main/skills/auto-iterate
Command: npx skills add https://github.com/rongarede/claude-skills-orchestration --skill auto-iterate-rongarede

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates iterative improvement of a target skill or codebase by repeatedly applying focused edits and keeping only changes that score higher under a stable evaluation procedure.

Core Features & Use Cases

  • Karpathy Loop-style improvement cycle: continuously proposes a single change, commits it, evaluates it, and either keeps it or rolls it back based on score deltas.
  • Multi-target iteration support: can iterate on a standalone SKILL.md, an entire skill directory (skill-full), an agent memory store, or arbitrary code with a user-provided evaluation command.
  • Deterministic evaluation harness: uses provided scripts to score triggers, structure, constraints, executable content, plus composite checks for skill directories; for code, it runs the specified eval_command.
  • Guardrails and crash recovery: records results in results.tsv, handles timeouts/crashes as discard outcomes, and uses circuit-breaker style cooldowns after repeated failures.

Quick Start

Ask the AI: /auto-iterate skill ./SKILL.md to iteratively improve that skill and keep only scoring commits in results.tsv.

Frequently Asked Questions about auto-iterate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I iteratively improve an AI skill's trigger and structure automatically?

Iteratively improving an AI skill requires applying targeted edits, committing changes via git branching, and evaluating outcomes to keep only higher-scoring versions. The evaluation harness scores triggers, structure, constraints, and executable content, discarding changes that do not improve the score.

What is the best way to automate code quality improvements with deterministic evaluation?

Automating code quality improvements involves repeatedly applying focused edits and evaluating outcomes using a user-specified evaluation command. The system commits changes, runs the deterministic evaluation, and keeps only changes that yield higher scores, rolling back any edits that fail.

How does rollback work when an automated skill iteration produces a lower score?

When an automated skill iteration produces a lower score, the rollback mechanism discards the git commit and reverts the skill to its previous state. The system records the discarded outcome in results.tsv and applies circuit-breaker style cooldowns after repeated failures.

Do I need git to run automated evaluation loops on my agent memory store?

Yes, running automated evaluation loops on an agent memory store requires git-based branching to isolate changes. The system uses isolated subagent execution per iteration and persistent results tracking in results.tsv to manage the keep or discard decisions.

Can I use a custom evaluation command instead of the built-in skill evaluation scripts?

Yes, you can use a custom evaluation command instead of the built-in scripts. The system supports arbitrary code iteration by running a user-specified eval_command to determine the score delta for each committed change.

What happens when a subagent execution crashes or times out during skill iteration?

When subagent execution crashes or times out during skill iteration, the system handles it as a discard outcome. The failed iteration is recorded in results.tsv, and circuit-breaker style cooldowns are applied after repeated failures to prevent continuous crashes.