Skills

Iterate

Use when the workflow needs to self-correct, improve over time, or establish feedback...

Install

npx skills add sharpdeveye/maestro --skill iterate -g -a claude-code -y
Repository
sharpdeveye/maestro592
Category
Engineering
Updated
6mo ago
License
MIT
Context cost
Lightabout 790 tokens
Runs scripts
No, instructions only

What it does

Use when the workflow needs to self-correct, improve over time, or establish feedback loops and evaluation cycles.

MANDATORY PREPARATION

Invoke /agent-workflow, it contains workflow principles, anti-patterns, and the Context Gathering Protocol. Follow the protocol before proceeding, if no workflow context exists yet, you MUST run /teach-maestro first.

Consult the feedback-loops reference in the agent-workflow skill for evaluation patterns and self-correction strategies.


Set up feedback loops that make workflows self-correcting and continuously improving. Iteration transforms one-shot gambles into convergent, reliable systems.

Feedback Loop Design

Step 1: Define Quality Criteria

What does "good output" look like? Score dimensions:

DimensionWeightThresholdMeasurement
Accuracy0.4≥ 0.8Factual correctness check
Completeness0.3≥ 0.7Required fields present
Format0.2≥ 0.9Schema compliance
Tone0.1≥ 0.6Appropriate for audience

Step 2: Choose Evaluator Type

Match evaluator to requirements:

  • Rule-based: Schema validation, field presence, value ranges (fast, free)
  • Self-check: Same model evaluates own output (fast, cheap, less reliable)
  • Cross-model: Different model evaluates (slower, more reliable)
  • Human-in-the-loop: Human review (slowest, most reliable, doesn't scale)
  • Hybrid: Rules first, then model check for what rules can't catch

Step 3: Design the Correction Loop

generate(input) → evaluate(output) → score
  if score ≥ threshold → return output
  if score < threshold AND attempts < max →
    enrich input with evaluator feedback
    generate again (with feedback)
  if attempts ≥ max → fallback or escalate

Critical: The retry input MUST be different from the original. Include:

  • The evaluator's specific feedback
  • What was wrong and why
  • A suggestion for how to fix it

Step 4: Set Up Regression Detection

When changing prompts, models, or tools:

Read the whole SKILL.md on GitHub

More in Engineering