ralph-loop
Use after first code change. Autonomous iteration until all quality gates pass (max 7 iterations).
npx skills add majiayu000/claude-skill-registry --skill ralph-loop-changoo89-claude-pilot --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# SKILL: Ralph Loop > **Purpose**: Autonomous completion loop - iterate until all tests pass, coverage met, type-check clean > **Target**: Coder, Tester, Validator agents > **⚠️ Subagents Only**: This skill is for coder/tester subagents. Main orchestrator must delegate via Task tool. --- ## Quick Start ### When to Use This Skill - After first code change (Entry point) - Tests failing or coverage low - Type-check errors present - Lint violations found ### Quick Reference ```bash # Ralph Loop: Autonomous iteration iteration=0 max_iterations=7 early_escalation=false # Check for --early flag or architecture-related failure if [[ "$*" == *"--early"* ]] || is_architecture_failure; then max_iterations=2 early_escalation=true fi while [ $iteration -lt $max_iterations ]; do echo "Iteration $((iteration + 1))/$max_iterations" # Run verification if run_all_checks; then echo "✓ All quality gates passed" break fi # Fix failures fix_failures # Update state update_state "$SC" "in_progress" $((iteration + 1)) ((iteration++)) done # Complete or escalate if [ $iteration -eq $max_iterations ]; then echo "<CODER_BLOCKED>" # Escalate to GPT Architect else echo "<CODER_COMPLETE>" # All checks pass fi ``
- Quick Start
- When to Use This Skill
- Quick Reference
- Core Concepts
- Entry Point
- Quality Gates
- Iteration Pattern
- Implementation
- Verification Function
- Fix Function
- Architecture Failure Detection
- Escalation
- When Blocked
- Early Escalation
Ralph Loop: Autonomous iteration Check for --early flag or architecture-related failure if [[ "$*" == *"--early"* ]] || is_architecture_failure; then fi while [ $iteration -lt $max_iterations ]; do echo "Iteration $((iteration + 1))/$max_iterations" if run_all_checks; then echo "✓ All quality gates passed" break fix_failures
What does the ralph-loop skill do?
Use after first code change. Autonomous iteration until all quality gates pass (max 7 iterations).
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill ralph-loop-changoo89-claude-pilot --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
