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 Specum Implement

by tzachbon in tzachbon/smart-ralph

This skill should be used only when the user explicitly asks to use $ralph-specum-implement, or explicitly asks Ralph Specum in Codex to run implementation for approved tasks, quick mode, or an…

MITAuto-check passed

Install Ralph Specum Implement

skills CLI
$ npx skills add tzachbon/smart-ralph --skill ralph-specum-implement -a claude-code

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

GitHub CLI
$ gh skill install tzachbon/smart-ralph ralph-specum-implement --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/tzachbon/smart-ralph.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ralph-specum-codex/skills/ralph-specum-implement .claude/skills/ralph-specum-implement && 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-specum-implement
GitHub stars
558
Token cost
~1.4k tokens
SKILL.md length
726 words
Files
2
Skills in repo
26
Repo updated
First seen
Licence
MIT

At a glance

This skill should be used only when the user explicitly asks to use $ralph-specum-implement, or explicitly asks Ralph Specum in Codex to run implementation for approved tasks, quick mode, or an…

  • Works in 12 steps: Resolve the active spec. If none exists,… → Require tasks.md. Read .progress.md,… → Parse tasks.md once into ordered… → …
  • Explicitly asks to use $ralph-specum-implement
  • SKILL.md covers Contract, Action and Resume Rules
  • Calls gh

What it does

Ralph Specum Implement is an agent skill from tzachbon/smart-ralph. This skill should be used only when the user explicitly asks to use $ralph-specum-implement, or explicitly asks Ralph Specum in Codex to run implementation for approved tasks, quick mode, or an explicit continue request.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

The repository describes itself as: Spec-driven development with smart compaction. Claude Code plugin combining Ralph Wiggum loop with structured specification workflow. The licence is MIT.

When your agent uses it

  • Explicitly asks to use $ralph-specum-implement
  • Explicitly asks Ralph Specum in Codex to run implementation for approved tasks
  • An explicit continue request

Example prompts

  • “/ralph-specum-implement”

Workflow steps

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

  1. Resolve the active spec. If none exists, stop.
  2. Require tasks.md. Read .progress.md, current state, and current task markers.
  3. Parse tasks.md once into ordered top-level task rows. Include only unindented checkboxes outside fenced example blocks whose next token is…
  4. Resolve the dispatch task index before merging state. For fresh execution, use next_index. For a prototype return, require a validated…
  5. Before dispatch, run prototype_records.py reconcile whenever state exists and run select-downstream whenever activePrototypes is nonempty…
  6. On a prototype return, verify that the merged taskIndex still equals the validated returnTaskIndex and identifies the first eligible…
  7. Delegate each task to a spec-executor sub-agent. Pass the task description, file targets, success criteria, and context from .progress.md…
  8. [P] tasks may batch only when file sets do not overlap and verification is independent.
  9. [VERIFY] tasks stay in the same run and must produce explicit verification evidence.
  10. Marker syntax must be explicitly present in tasks.md. If markers are absent, treat tasks as non-batchable by default.
  11. VE tasks are valid quality tasks when the spec includes autonomous end-to-end verification.
  12. Native task sync metadata should be preserved when present.

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • gh

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

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    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 Specum Implement loads about 1.4k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 726 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
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

The full file from tzachbon/smart-ralph at commit ac7251a, republished under its MIT licence (© tzachbon). 726 words, ~1,391 tokens.

Download SKILL.mdSave it as .claude/skills/ralph-specum-implement/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
ralph-specum-implement
description
This skill should be used only when the user explicitly asks to use `$ralph-specum-implement`, or explicitly asks Ralph Specum in Codex to run implementation for approved tasks, quick mode, or an explicit continue request.
metadata.surface
helper
metadata.action
implement

Ralph Specum Implement

You are a coordinator, not an executor -- delegate each task to a spec-executor sub-agent.

Contract

  • Resolve the active spec by explicit path, exact name, or .current-spec
  • Require tasks.md
  • Recompute task counts from disk before execution
  • Merge state fields only
  • Reconcile prototype records before dispatch and block only dependent work
  • Remove .ralph-state.json only when all tasks are complete, verified, and activePrototypes is empty

Action

  1. Resolve the active spec. If none exists, stop.
  2. Require tasks.md. Read .progress.md, current state, and current task markers.
  3. Parse tasks.md once into ordered top-level task rows. Include only unindented checkboxes outside fenced example blocks whose next token is a concrete numeric task ID, V<number>, VE<number>, or VF; exclude nested and example checkboxes, completion criteria, and placeholder IDs. From that one list derive total, the completed count across all rows, and next_index as the zero-based position of the first incomplete row or total when none remains. Do not derive next_index from the completed count; non-prefix completion cases resume at the earliest incomplete row.
  4. Resolve the dispatch task index before merging state. For fresh execution, use next_index. For a prototype return, require a validated non-negative returnTaskIndex and verify that it identifies the first eligible incomplete task. Merge state once with:
    • phase: "execution"
    • awaitingApproval: false
    • totalTasks: total
    • taskIndex: next_index for fresh execution, or the validated returnTaskIndex for a prototype return
    • preserve taskIteration, maxTaskIterations, globalIteration, maxGlobalIterations, commitSpec, and relatedSpecs
  5. Before dispatch, run prototype_records.py reconcile whenever state exists and run select-downstream whenever activePrototypes is nonempty or prototype history exists. Request --target execution, --target "task:$TASK_INDEX", and --path for every declared current-task path. Stop when an active blocker or stale input targets the work, or when any matching targetDecisions entry is not both proofAvailable: true and eligible: true. Missing dependency or approved-transfer proof blocks conservatively. Report the prototype ID and resume active work through $ralph-specum-prototype --resume <id>; route terminal staleness to its earliest affected phase or task.
  6. On a prototype return, verify that the merged taskIndex still equals the validated returnTaskIndex and identifies the first eligible incomplete task before dispatch.
  7. Delegate each task to a spec-executor sub-agent. Pass the task description, file targets, success criteria, and context from .progress.md. The sub-agent implements the task and outputs TASK_COMPLETE. Do NOT implement tasks yourself. Execute tasks in order until complete or blocked.
  8. [P] tasks may batch only when file sets do not overlap and verification is independent.
  9. [VERIFY] tasks stay in the same run and must produce explicit verification evidence.
  10. Marker syntax must be explicitly present in tasks.md. If markers are absent, treat tasks as non-batchable by default.
  11. VE tasks are valid quality tasks when the spec includes autonomous end-to-end verification.
  12. Native task sync metadata should be preserved when present.
  13. After each task or safe batch:
Show full SKILL.md (260 more words)Show less
  • mark the checkbox
  • update .progress.md
  • merge the state update
  • use the task Commit line unless commits were explicitly disabled
  1. Before any batching, generated-task, CI, review-fix, branch-publication, or PR-lifecycle push, apply the Prototype Evidence Push Gate in ../../references/workflow.md. Normal mode may ask at that boundary for separate explicit authorization naming every outbound **/prototypes/*.md record. Quick mode asks no question and skips every push. A skipped or denied push ends the dependent remote lifecycle path: do not run gh pr create, gh pr merge, gh pr checks, gh pr view, gh api, gh run, gh issue, remote review polling, issue writes, or later remote steps that depend on that push. Quick mode continues or finishes locally and reports Remote lifecycle skipped: prototype evidence stayed local. Preserve the existing normal remote lifecycle only after the gate completes the push. Never push an isolated prototype source branch. commitSpec authorizes local commits only.
  2. On failure or interruption, persist the current state and stop with a resumable summary.
  3. On full completion, reconcile again. If activePrototypes remains nonempty, preserve .ralph-state.json and stop with its IDs. Otherwise remove state and report completion.

Resume Rules

  • Resume from the persisted task state when execution was already in progress.
  • If disk state and task checkboxes disagree, prefer tasks.md for completion and repair state to match.
  • If approval is still pending for tasks, stop and get approval unless quick mode or explicit user direction says to continue.
  • A stale task or dependent active prototype always wins over resume dispatch. An unrelated active prototype does not pause the current task.

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

Files

SKILL.md and 1 other file in plugins/ralph-specum-codex/skills/ralph-specum-implement of tzachbon/smart-ralph.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit ac7251a

Compare with similar skills

Ralph Specum Implement 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 Specum Implement compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ralph Specum Implement this skilltzachbon/smart-ralph558—~1.4kAutomated safety check: PassMIT
Implementsickn33/agentic-awesome-skills47k5 repos~306Automated safety check: PassMIT
Implementcodewhale-hq/Codewhale41k—~190Automated safety check: PassMIT
RalphYeachan-Heo/oh-my-claudecode40k—~7.5kAutomated safety check: PassMIT
No Explicit Anythedaviddias/Front-End-Checklist74k—~565Automated safety check: PassMIT
Incremental Implementationaddyosmani/agent-skills103k1 repos~2.3kAutomated safety check: PassMIT

Similar skills

  • Implement

    sickn33/agentic-awesome-skills

    Implement a piece of work based on a PRD or set of issues. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 5 repos~306 tokens
    Product & Project ManagementAuto-check passed

  • Implement

    codewhale-hq/Codewhale

    Carry an authorized, defined request or approved plan through scoped edits and proportionate verification.

    41k GitHub stars~190 tokensUpdated today
    Auto-check passed

  • Ralph

    Yeachan-Heo/oh-my-claudecode

    Self-referential loop until task completion with configurable verification reviewer

    40k GitHub stars~7.5k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

  • No Explicit Any

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing TypeScript files for type safety regressions, during code review of functions that handle external data, or when the codebase has ESLint warnings for…

    74k GitHub stars~565 tokensUpdated 3 days ago
    DevelopmentAuto-check passed

  • Incremental Implementation

    addyosmani/agent-skills

    Delivers a change in thin vertical slices, each implemented, tested, verified and committed before the next, using vertical, contract-first or risk-first slicing.

    103k GitHub starsUsed in 1 repo~2.3k tokens
    Agent WorkflowsAuto-check passed

  • Implement

    bestofjs/bestofjs

    Implement a piece of work based on a spec or set of tickets.

    3.1k GitHub starsUsed in 18 repos~109 tokens
    Auto-check passed

More from tzachbon/smart-ralph

All 26 skills in this repo

  • Communication Style

    tzachbon/smart-ralph

    This skill should be used when generating spec artifacts (research.md, requirements.md, design.md, tasks.md), formatting agent output, structuring phase results, or when any Ralph agent needs…

    558 GitHub stars~551 tokensUpdated 23 days ago
    Auto-check passed

  • Interview Framework

    tzachbon/smart-ralph

    This skill should be used when a Ralph phase must identify critical user decisions, run a layered grill, persist partial answers, obtain explicit approval, or resume an interrupted phase interview…

    558 GitHub stars~2.2k tokensUpdated 23 days ago
    Auto-check passed

  • Reality Verification

    tzachbon/smart-ralph

    This skill should be used when the user asks to "verify a fix", "reproduce failure", "diagnose issue", "check BEFORE/AFTER state", "VF task", "reality check", "check test quality", "mock-only…

    558 GitHub stars~877 tokensUpdated 23 days ago
    Auto-check passed

  • Spec Workflow

    tzachbon/smart-ralph

    This skill should be used when the user asks to "build a feature", "create a spec", "start spec-driven development", "run research phase", "generate requirements", "create design", "plan tasks"…

    558 GitHub stars~1.1k tokensUpdated 23 days ago
    Auto-check passed

  • Ralph Specum Design

    tzachbon/smart-ralph

    This skill should be used only when the user explicitly asks to use $ralph-specum-design, or explicitly asks Ralph Specum in Codex to run the design phase.

    558 GitHub stars~1.5k tokensUpdated 23 days ago
    Auto-check passed

  • Ralph Specum Tasks

    tzachbon/smart-ralph

    This skill should be used only when the user explicitly asks to use $ralph-specum-tasks, or explicitly asks Ralph Specum in Codex to run the tasks phase.

    558 GitHub stars~1.6k tokensUpdated 23 days ago
    Auto-check passed

Questions about Ralph Specum Implement

What does Ralph Specum Implement do?

This skill should be used only when the user explicitly asks to use $ralph-specum-implement, or explicitly asks Ralph Specum in Codex to run implementation for approved tasks, quick mode, or an…. Ralph Specum Implement is an agent skill from tzachbon/smart-ralph. This skill should be used only when the user explicitly asks to use $ralph-specum-implement, or explicitly asks Ralph Specum in Codex to run implementation for approved tasks, quick mode, or an explicit continue request.

When should I use Ralph Specum Implement?

Ralph Specum Implement fits situations like: explicitly asks to use $ralph-specum-implement; explicitly asks Ralph Specum in Codex to run implementation for approved tasks; an explicit continue request.

How do I install Ralph Specum Implement in Claude Code?

Run `npx skills add tzachbon/smart-ralph --skill ralph-specum-implement -a claude-code`. Or copy the skill folder (plugins/ralph-specum-codex/skills/ralph-specum-implement in tzachbon/smart-ralph) into .claude/skills/ralph-specum-implement in your project. Claude Code loads it when a task matches its description.

How do I install Ralph Specum Implement in Codex?

Run `npx skills add tzachbon/smart-ralph --skill ralph-specum-implement -a codex`. Or copy the skill folder (plugins/ralph-specum-codex/skills/ralph-specum-implement in tzachbon/smart-ralph) into .agents/skills/ralph-specum-implement in your project. Codex loads it when a task matches its description.

Can I use Ralph Specum Implement 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 tzachbon/smart-ralph --skill ralph-specum-implement -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-specum-implement, .gemini/skills/ralph-specum-implement, .github/skills/ralph-specum-implement and .opencode/skills/ralph-specum-implement in your project.

What does Ralph Specum Implement need to run?

Going by SKILL.md and its folder, Ralph Specum Implement needs the command-line tools its instructions call (gh).

Does Ralph Specum Implement access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Ralph Specum Implement 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 Specum Implement use?

Ralph Specum Implement 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 Ralph Specum Implement use?

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

Skills that share tags, products or a category with Ralph Specum Implement: Implement (sickn33/agentic-awesome-skills, 47k stars), Implement (codewhale-hq/Codewhale, 41k stars), Ralph (Yeachan-Heo/oh-my-claudecode, 40k stars) and No Explicit Any (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ralph Specum Implement?

tzachbon (a GitHub user) maintains it in tzachbon/smart-ralph, which has 558 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on September 16, 2026.

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