Explain Ralph Loop plugin and available commands. An agent skill from charfeng1/opencode-ralph-loop.

MITAuto-check passedAgent Workflows

Install Help

skills CLI
$ npx skills add charfeng1/opencode-ralph-loop --skill help -a claude-code

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

GitHub CLI
$ gh skill install charfeng1/opencode-ralph-loop help --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/charfeng1/opencode-ralph-loop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/help .claude/skills/help && 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
help
GitHub stars
112
Token cost
~405 tokens
SKILL.md length
165 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Explain Ralph Loop plugin and available commands. An agent skill from charfeng1/opencode-ralph-loop.

  • Works in 5 steps: Start: /ralph-loop creates a state file… → Loop: When the AI goes idle, the plugin… → Continue: If not found, it injects… → …
  • Tasks that involve Autonomous loops
  • SKILL.md covers Available Commands, How It Works, Completion Signal and State File, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Help is an agent skill from charfeng1/opencode-ralph-loop. Explain Ralph Loop plugin and available commands

Its SKILL.md is about 410 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: Minimal Ralph Loop plugin for opencode - auto-continues until task completion. The licence is MIT.

When your agent uses it

  • Tasks that involve Autonomous loops

Example prompts

  • “/help”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Start: /ralph-loop creates a state file at .opencode/ralph-loop.local.md
  2. Loop: When the AI goes idle, the plugin checks if DONE was output
  3. Continue: If not found, it injects "Continue from where you left off"
  4. Stop: Loop continues until DONE is found or max iterations (100) reached
  5. Cleanup: State file is deleted when complete

What it can do on your machine

Read from SKILL.md and the folder at commit 2ef2386. 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

    Links to these hosts (documentation or services it may open):

    • github.com

    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

Help loads about 405 tokens when it runs. Until then it costs about 13 tokens; SKILL.md has 165 words of instructions outside code blocks.

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

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 charfeng1/opencode-ralph-loop at commit 2ef2386, republished under its MIT licence (© charfeng1). 165 words, ~405 tokens.

Download SKILL.mdSave it as .claude/skills/help/SKILL.md (or your agent's skills folder).
name
help
description
Explain Ralph Loop plugin and available commands

Ralph Loop Help

The Ralph Loop plugin provides auto-continuation for complex tasks in opencode.

Available Commands

/ralph-loop <task>

Start an iterative development loop that automatically continues until the task is complete.

Example:

/ralph-loop Build a REST API with authentication

The AI will work on your task and automatically continue until completion.

/cancel-ralph

Cancel an active Ralph Loop before it completes.

Example:

/cancel-ralph

How It Works

  1. Start: /ralph-loop creates a state file at .opencode/ralph-loop.local.md
  2. Loop: When the AI goes idle, the plugin checks if <promise>DONE</promise> was output
  3. Continue: If not found, it injects "Continue from where you left off"
  4. Stop: Loop continues until DONE is found or max iterations (100) reached
  5. Cleanup: State file is deleted when complete

Completion Signal

When the task is fully complete, the AI outputs:

<promise>DONE</promise>

This signals the loop to stop. The AI should ONLY output this when the task is truly complete.

State File

Located at .opencode/ralph-loop.local.md (add to .gitignore):

markdown
---
active: true
iteration: 3
maxIterations: 100
sessionId: ses_abc123
---

Your original task prompt

Credits

© charfeng1, 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 skills/help of charfeng1/opencode-ralph-loop.

Open the folder on GitHubat commit 2ef2386

Compare with similar skills

Help 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.

Help compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Help this skillcharfeng1/opencode-ralph-loop112—~405Automated 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
PUA Looptanweai/pua20k1 repos~1.1kAutomated safety check: PassMIT
AutopilotYeachan-Heo/oh-my-claudecode40k1 repos~4.4kAutomated safety check: PassMIT
Install Loop Engineeringcobusgreyling/loop-engineering11k1 repos~648Automated 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
  • PUA Loop

    tanweai/pua

    Runs an unattended iterate-until-verified loop in which a user-set verify command, not the agent's own claim, decides when the task is finished.

    20k GitHub starsUsed in 1 repo~1.1k 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 27 days ago
    Agent WorkflowsAuto-check passed

More from charfeng1/opencode-ralph-loop

  • Ralph Loop

    charfeng1/opencode-ralph-loop

    Start Ralph Loop - auto-continues until task completion. An agent skill from charfeng1/opencode-ralph-loop.

    112 GitHub stars~517 tokensUpdated 1 mo ago
    Auto-check passed
  • Cancel Ralph

    charfeng1/opencode-ralph-loop

    Cancel active Ralph Loop

    112 GitHub stars~222 tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Help

What does Help do?

Explain Ralph Loop plugin and available commands. An agent skill from charfeng1/opencode-ralph-loop. Help is an agent skill from charfeng1/opencode-ralph-loop.

When should I use Help?

Help fits situations like: tasks that involve Autonomous loops.

How do I install Help in Claude Code?

Run `npx skills add charfeng1/opencode-ralph-loop --skill help -a claude-code`. Or copy the skill folder (skills/help in charfeng1/opencode-ralph-loop) into .claude/skills/help in your project. Claude Code loads it when a task matches its description.

How do I install Help in Codex?

Run `npx skills add charfeng1/opencode-ralph-loop --skill help -a codex`. Or copy the skill folder (skills/help in charfeng1/opencode-ralph-loop) into .agents/skills/help in your project. Codex loads it when a task matches its description.

Can I use Help 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 charfeng1/opencode-ralph-loop --skill help -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/help, .gemini/skills/help, .github/skills/help and .opencode/skills/help in your project.

What does Help need to run?

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

Does Help access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Help 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 Help use?

Help 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 Help use?

About 405 tokens (SKILL.md is roughly 1.6k 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 Help?

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

Who maintains Help?

charfeng1 (a GitHub user) maintains it in charfeng1/opencode-ralph-loop, which has 112 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 8, 2026.

Source: charfeng1/opencode-ralph-loop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.