Agent skill

Autonomous Loop

by WellApp-ai in WellApp-ai/Well

Iterate until success or limit, composing existing skills with Jidoka integration

MITAuto-check passedAgent Workflows

Install Autonomous Loop

skills CLI
$ npx skills add WellApp-ai/Well --skill autonomous-loop -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install WellApp-ai/Well autonomous-loop --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/WellApp-ai/Well.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cursor-rules/skills/autonomous-loop .claude/skills/autonomous-loop && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
autonomous-loop
GitHub stars
345
Token cost
~1k tokens
SKILL.md length
310 words
Files
1
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

Iterate until success or limit, composing existing skills with Jidoka integration

  • Works in 4 steps: Initialize → Execute Loop → Iteration Report → …
  • Tasks that involve Autonomous loops
  • SKILL.md covers When to Use, Trigger Phrases, Parameters and Phase 1: Initialize, plus 9 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Autonomous Loop is an agent skill from WellApp-ai/Well. Iterate until success or limit, composing existing skills with Jidoka integration

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Autonomous loops. The repository describes itself as: No more Sundays on Finance. We build the infrastructure that retrieves, processes, and routes your financial and business data to your FinOps stack, so founders can ship, not… The licence is MIT.

When your agent uses it

  • Tasks that involve Autonomous loops

Example prompts

  • “/autonomous-loop”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Initialize
  2. Execute Loop
  3. Iteration Report
  4. Exit and Report

What it can do on your machine

Read from SKILL.md and the folder at commit c740217. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Autonomous Loop loads about 1k tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 310 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from WellApp-ai/Well at commit c740217, republished under its MIT licence (© WellApp-ai). 310 words, ~1,036 tokens.

Download SKILL.mdSave it as .claude/skills/autonomous-loop/SKILL.md (or your agent's skills folder).
name
autonomous-loop
description
Iterate until success or limit, composing existing skills with Jidoka integration

Autonomous Loop Skill (Ralph Wiggum)

Keep iterating until success without human intervention per attempt. Composes existing skills and respects Jidoka escalation.

When to Use

  • User requests hands-off iteration
  • Explicitly triggered with keywords

Trigger Phrases

  • "ralph mode"
  • "keep going"
  • "iterate until done"
  • "autonomous"
  • "don't stop"

Parameters

ParamDefaultDescription
max_iterations5Max attempts before pause
success_criteriatypecheck + lint + ReadLints cleanWhat defines success

Phase 1: Initialize

  1. Acknowledge activation
  2. Invoke session-status skill for current state
  3. Initialize counters:
    • iteration = 0
    • error_history = [] (shared with debug skill)

Output:

Entering autonomous loop. Max 5 iterations.
Current: [session-status header]

Phase 2: Execute Loop

FOR iteration IN 1..max_iterations:
    
    2.1: Execute current task action
         - Implement changes per commit plan
         - Run npm run typecheck
         - Run npm run lint
    
    2.2: Invoke pr-review skill
         - If BLOCK: proceed to 2.4
         - If PASS: proceed to 2.3
    
    2.3: Invoke qa-commit skill
         - If GREEN: proceed to 2.5
         - If RED: proceed to 2.4
    
    2.4: Invoke debug skill
         - Debug skill checks Jidoka tier internally
         - If Tier 2/3 escalation: EXIT loop, return JIDOKA
         - If Tier 1 fix attempted: CONTINUE loop
    
    2.5: Success checkpoint
         - Log iteration as SUCCESS
         - Proceed to next commit or EXIT if done

Phase 3: Iteration Report

After each iteration, output:

markdown
## Iteration [N]/[max]

| Step | Skill | Result |
|------|-------|--------|
| Execute | (implementation) | [files changed] |
| Review | pr-review | PASS/BLOCK |
| Verify | qa-commit | GREEN/RED |
| Debug | debug | [if invoked] |

**Outcome:** [SUCCESS / CONTINUE / JIDOKA / MAX]

Phase 4: Exit and Report

On loop exit, invoke session-status skill and output:

markdown
## Autonomous Loop Complete

**Exit reason:** [SUCCESS / JIDOKA / MAX / INTERRUPT]
**Iterations:** [N] of [max]

| Iter | Action | Result |
|------|--------|--------|
| 1 | [description] | [outcome] |
| 2 | [description] | [outcome] |

[session-status footer with next steps]

Exit Conditions

ConditionTriggerResult
SUCCESSAll checks pass, commit completeNormal exit, proceed to next commit
JIDOKATier 2/3 escalation triggeredExit loop, present options to human
MAXiteration >= max_iterationsExit loop, report and wait for guidance
INTERRUPTUser sends messageExit loop, respond to user

Safety Guardrails

  • NEVER auto-commit without GREEN from qa-commit
  • NEVER auto-push to remote
  • NEVER delete files without explicit approval
  • PAUSE on any destructive operation
  • EXIT on user message (treat as INTERRUPT)

Integration with Jidoka

Ralph Wiggum respects Jidoka escalation tiers:

TierRalph Behavior
Tier 1 (error_count < 3)Continue autonomously, debug skill handles
Tier 2 (same error 3x)EXIT loop, Jidoka presents options
Tier 3 (any error 5x)EXIT loop, Jidoka requires human triage

Integration

This skill composes:

  • session-status - Progress tracking
  • pr-review - Technical validation
  • qa-commit - QA contract verification
  • debug - Error fixing with Jidoka

This skill is invoked by:

  • User trigger phrases
  • agent.mdc when user requests autonomous mode

Invocation

Trigger with: "ralph mode", "keep going", "iterate until done"

Tools Used

ToolPurpose
Shellnpm run typecheck, npm run lint
ReadLintsIDE diagnostic errors
GrepPattern search in code
SemanticSearchFind implementations
ReadRead file contents
StrReplaceMake code changes
Browser MCPVisual verification (via qa-commit)

© WellApp-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in cursor-rules/skills/autonomous-loop of WellApp-ai/Well.

Open the folder on GitHubat commit c740217

Compare with similar skills

Autonomous Loop next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Autonomous Loop compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Autonomous Loop this skillWellApp-ai/Well345—~1kAutomated safety check: PassMIT
Show Me Your Work Decision Logcursor/plugins10k9 repos~1.6kAutomated safety check: PassNone
Autoresearch Iteration Loopuditgoenka/autoresearch6.5k1 repos~2kAutomated safety check: PassMIT
AutopilotYeachan-Heo/oh-my-claudecode40k1 repos~4.4kAutomated safety check: PassMIT
Install Loop Engineeringcobusgreyling/loop-engineering11k1 repos~648Automated safety check: PassMIT
LoopyForward-Future/loopy3.2k—~3.9kAutomated safety check: PassMIT

Similar skills

  • Official

    Keeps a TSV decision log for long or unattended agent runs, one row per decision with what, why, evidence and result, so a reviewer can check the work later.

    10k GitHub starsUsed in 9 repos~1.6k tokens
    Agent WorkflowsAuto-check passed
  • Autoresearch Iteration Loop

    uditgoenka/autoresearch

    Runs an autonomous modify, verify, keep-or-discard loop against any metric, with subcommands for planning, debugging, fixing, security audits, shipping and more.

    6.5k GitHub starsUsed in 1 repo~2k tokens
    Agent WorkflowsAuto-check passed
  • Autopilot

    Yeachan-Heo/oh-my-claudecode

    Takes a short product idea through requirements, design, planning, parallel implementation, QA cycles and multi-reviewer validation to produce working code.

    40k GitHub starsUsed in 1 repo~4.4k tokens
    Agent WorkflowsAuto-check passed
  • Install Loop Engineering

    cobusgreyling/loop-engineering

    Installs Loop Engineering into a project through the single @cobusgreyling/loop CLI, scaffolding a report-only loop and a readiness score.

    11k GitHub starsUsed in 1 repo~648 tokens
    Agent WorkflowsAuto-check passed
  • Loopy

    Forward-Future/loopy

    Discover, find, compare, audit, repair, adapt, craft, run, debrief, save, and prepare repeatable AI-agent loops for publication.

    3.2k GitHub stars~3.9k tokensUpdated 26 days ago
    Agent WorkflowsAuto-check passed
  • Pushes an agent to exhaust every option, investigate before asking and take initiative beyond the literal request, instead of giving up or waiting passively.

    20k GitHub starsUsed in 2 repos~6.9k tokens
    Agent WorkflowsAuto-check passed

More from WellApp-ai/Well

All 36 skills in this repo
  • Tech Divergence

    WellApp-ai/Well

    Evaluate technical options with scoring matrix, trigger Gate 4 for significant decisions

    345 GitHub stars~1.3k tokensUpdated 7 days ago
    Auto-check passed
  • Ar Aging

    WellApp-ai/Well

    Produce an accounts-receivable aging report and surface overdue invoices for a Well workspace.

    345 GitHub stars~532 tokensUpdated 7 days ago
    Auto-check passed
  • Balance Sheet

    WellApp-ai/Well

    Build a balance sheet (bilan) from a Well workspace. An agent skill from WellApp-ai/Well.

    345 GitHub stars~534 tokensUpdated 7 days ago
    Auto-check passed
  • Bpmn Workflow

    WellApp-ai/Well

    Generate and maintain BPMN 2.0 diagrams linked to Gherkin scenarios

    345 GitHub stars~1.4k tokensUpdated 7 days ago
    Auto-check passed
  • Cash Flow Forecast

    WellApp-ai/Well

    Forecast cash flow and runway for a Well workspace from booked invoices and collected bank transactions.

    345 GitHub stars~567 tokensUpdated 7 days ago
    Auto-check passed
  • Code Review

    WellApp-ai/Well

    Review code changes against hard rules and conventions. An agent skill from WellApp-ai/Well.

    345 GitHub stars~509 tokensUpdated 7 days ago
    Auto-check passed

Categories

Questions about Autonomous Loop

What does Autonomous Loop do?

Iterate until success or limit, composing existing skills with Jidoka integration. Autonomous Loop is an agent skill from WellApp-ai/Well.

When should I use Autonomous Loop?

Autonomous Loop fits situations like: tasks that involve Autonomous loops.

How do I install Autonomous Loop in Claude Code?

Run `npx skills add WellApp-ai/Well --skill autonomous-loop -a claude-code`. Or copy the skill folder (cursor-rules/skills/autonomous-loop in WellApp-ai/Well) into .claude/skills/autonomous-loop in your project. Claude Code loads it when a task matches its description.

How do I install Autonomous Loop in Codex?

Run `npx skills add WellApp-ai/Well --skill autonomous-loop -a codex`. Or copy the skill folder (cursor-rules/skills/autonomous-loop in WellApp-ai/Well) into .agents/skills/autonomous-loop in your project. Codex loads it when a task matches its description.

Can I use Autonomous Loop in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add WellApp-ai/Well --skill autonomous-loop -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/autonomous-loop, .gemini/skills/autonomous-loop, .github/skills/autonomous-loop and .opencode/skills/autonomous-loop in your project.

What does Autonomous Loop need to run?

SKILL.md names no scripts, command-line tools or credentials: Autonomous Loop is instructions for the agent only.

Does Autonomous Loop access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Autonomous Loop safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Autonomous Loop use?

Autonomous Loop is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Autonomous Loop use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Autonomous Loop?

Skills that share tags, products or a category with Autonomous Loop: Show Me Your Work Decision Log (cursor/plugins, 10k stars), Autoresearch Iteration Loop (uditgoenka/autoresearch, 6.5k stars), Autopilot (Yeachan-Heo/oh-my-claudecode, 40k stars) and Install Loop Engineering (cobusgreyling/loop-engineering, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Autonomous Loop?

WellApp-ai (a GitHub organization) maintains it in WellApp-ai/Well, which has 345 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on September 30, 2026.

Source: WellApp-ai/Well on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.