New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Ralph Plan

by mastra-ai in mastra-ai/mastra

Interactive planning assistant that helps create focused, well-structured ralph-loop commands through collaborative conversation

Custom licenceAuto-check passedAgent Workflows

Install Ralph Plan

skills CLI
$ npx skills add mastra-ai/mastra --skill ralph-plan -a claude-code

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

GitHub CLI
$ gh skill install mastra-ai/mastra ralph-plan --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/mastra-ai/mastra.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/ralph-plan .claude/skills/ralph-plan && 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
ralph-plan
GitHub stars
29k
Token cost
~1.4k tokens
SKILL.md length
650 words
Files
1
Skills in repo
44
Repo updated
First seen
Licence
Custom licence

At a glance

Interactive planning assistant that helps create focused, well-structured ralph-loop commands through collaborative conversation

  • Works in 5 steps: Understand the Goal → Define Background → Plan Setup Steps → …
  • Tasks that involve Autonomous loops
  • SKILL.md covers Your Role, Ralph Command Structure, Planning Process and Guidelines, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Ralph Plan is an agent skill from mastra-ai/mastra. Interactive planning assistant that helps create focused, well-structured ralph-loop commands through collaborative conversation

Its SKILL.md is about 1.4k 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: Mastra is the modern TypeScript framework for AI-powered applications and agents.

When your agent uses it

  • Tasks that involve Autonomous loops

Example prompts

  • “/ralph-plan”

Workflow steps

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

  1. Understand the Goal
  2. Define Background
  3. Plan Setup Steps
  4. Break Down Tasks
  5. Define Testing

What it can do on your machine

Read from SKILL.md and the folder at commit b98829a. 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 xml).

    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

Ralph Plan loads about 1.4k tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 650 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 650 words (~1,385 tokens).

“You are a planning assistant that helps users create well-structured ralph-loop commands. Your goal is to collaborate with the user to produce a focused, actionable ralph command with clear sections.”

— opening of SKILL.md by mastra-ai, Custom licence
name
ralph-plan
model
claude-opus-4-5

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/ralph-plan of mastra-ai/mastra.

Open the folder on GitHubat commit b98829a

Compare with similar skills

Ralph Plan 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.

Ralph Plan compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ralph Plan this skillmastra-ai/mastra29k—~1.4kAutomated safety check: PassCustom licence
Show Me Your Work Decision Logcursor/plugins11k8 repos~1.6kAutomated safety check: PassNone
Autoresearch Iteration Loopuditgoenka/autoresearch6.5k1 repos~2kAutomated safety check: PassMIT
Install Loop Engineeringcobusgreyling/loop-engineering11k1 repos~648Automated safety check: PassMIT
LoopyForward-Future/loopy3.2k—~3.9kAutomated safety check: PassMIT
AI Performance Improvement Plantanweai/pua20k2 repos~6.9kAutomated safety check: PassMIT

Similar skills

  • Show Me Your Work Decision Log

    cursor/plugins

    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.

    11k GitHub starsUsed in 8 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

  • 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 1 mo ago
    Agent WorkflowsAuto-check passed

  • AI Performance Improvement Plan

    tanweai/pua

    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

  • LoopX Self Repair

    loopx-project/loopx

    Diagnoses surprising LoopX behavior, such as stale recommendations or tiny progress, assigns it to the responsible layer and repairs it at the lowest durable level.

    6.2k GitHub stars~2.2k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from mastra-ai/mastra

All 44 skills in this repo

  • Docs Audit

    mastra-ai/mastra

    Autonomous, report-only documentation review for Mastra docs.

    29k GitHub stars~3k tokensUpdated today
    Auto-check passed

  • Builder Smoke Test

    mastra-ai/mastra

    Smoke test the Agent Builder feature branch end-to-end against a hermetic project scaffolded by the skill (linked to the current worktree).

    29k GitHub stars~11k tokensUpdated today
    Auto-check: notes

  • Mastra Smoke Test

    mastra-ai/mastra

    Smoke test Mastra projects locally or deploy to staging/production.

    29k GitHub stars~4k tokensUpdated today
    Auto-check: notes

  • React Best Practices

    mastra-ai/mastra

    React performance optimization guidelines from Mastra Engineering.

    29k GitHub stars~1.9k tokensUpdated today
    Auto-check passed

  • Agent Prompt Quality Bar

    mastra-ai/mastra

    Universal quality bar and final audit rubric for any agent system prompt.

    29k GitHub stars~2k tokensUpdated today
    Auto-check passed

  • Coding Agent

    mastra-ai/mastra

    Authoring playbook for building agents that write, edit, review, or refactor code.

    29k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

Categories

Questions about Ralph Plan

What does Ralph Plan do?

Interactive planning assistant that helps create focused, well-structured ralph-loop commands through collaborative conversation. Ralph Plan is an agent skill from mastra-ai/mastra.

When should I use Ralph Plan?

Ralph Plan fits situations like: tasks that involve Autonomous loops.

How do I install Ralph Plan in Claude Code?

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

How do I install Ralph Plan in Codex?

Run `npx skills add mastra-ai/mastra --skill ralph-plan -a codex`. Or copy the skill folder (.claude/skills/ralph-plan in mastra-ai/mastra) into .agents/skills/ralph-plan in your project. Codex loads it when a task matches its description.

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

What does Ralph Plan need to run?

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

Does Ralph Plan 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 Ralph Plan 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 Ralph Plan use?

Ralph Plan has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Ralph Plan use?

About 1.4k tokens (SKILL.md is roughly 5.5k 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 Ralph Plan?

Skills that share tags, products or a category with Ralph Plan: Show Me Your Work Decision Log (cursor/plugins, 11k stars), Autoresearch Iteration Loop (uditgoenka/autoresearch, 6.5k stars), Install Loop Engineering (cobusgreyling/loop-engineering, 11k stars) and Loopy (Forward-Future/loopy, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ralph Plan?

mastra-ai (a GitHub organization) maintains it in mastra-ai/mastra, which has 28,698 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on October 11, 2026.

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