Agent skill

Ralph

by zereight in zereight/gitlab-mcp

PRD-driven persistence loop until task completion with verification.

MITAuto-check passedProduct & Project Management

Install Ralph

skills CLI
$ npx skills add zereight/gitlab-mcp --skill ralph -a claude-code

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

GitHub CLI
$ gh skill install zereight/gitlab-mcp ralph --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/zereight/gitlab-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/ralph .claude/skills/ralph && 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
GitHub stars
2k
Used in
1 other repo
Token cost
~711 tokens
SKILL.md length
330 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

PRD-driven persistence loop until task completion with verification.

  • Works in 8 steps: PRD Setup (first iteration) → Pick Next Story → Implement Current Story → …
  • Keep going until done
  • SKILL.md covers When to Use, When NOT to Use, Flags and Steps, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Ralph is an agent skill from zereight/gitlab-mcp. PRD-driven persistence loop until task completion with verification. Activate when user says: ralph, don't stop, must complete, finish this, keep going until done.

Its SKILL.md is about 710 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 Product & Project Management, covering PRD writing and User stories. The repository describes itself as: First gitlab mcp for you, building together. The licence is MIT.

When your agent uses it

  • Keep going until done
  • Tasks that involve PRD writing
  • Tasks that involve User stories

Example prompts

  • “/ralph”

Workflow steps

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

  1. PRD Setup (first iteration)
  2. Pick Next Story
  3. Implement Current Story
  4. Verify Acceptance Criteria
  5. Mark Story Complete
  6. Check PRD Completion
  7. Reviewer Verification
  8. Completion

What it can do on your machine

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

    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 loads about 711 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 330 words of instructions outside code blocks.

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

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 zereight/gitlab-mcp at commit 0109168, republished under its MIT licence (© zereight). 330 words, ~711 tokens.

Download SKILL.mdSave it as .claude/skills/ralph/SKILL.md (or your agent's skills folder).
name
ralph
description
PRD-driven persistence loop until task completion with verification. Activate when user says: ralph, don't stop, must complete, finish this, keep going until done.
argument-hint
[--no-prd] [--no-deslop] <task description>

Ralph

Ralph is a PRD-driven persistence loop that keeps working on a task until ALL user stories have passes: true and are reviewer-verified.

When to Use

  • Task requires guaranteed completion with verification
  • Work may span multiple iterations and needs persistence
  • Task benefits from structured PRD-driven execution

When NOT to Use

  • Full autonomous pipeline → use /omg-autopilot
  • Explore or plan before committing → use /plan
  • Quick one-shot fix → delegate to @executor

Flags

  • --no-prd: Skip PRD generation, work in legacy mode (for trivial fixes)
  • --no-deslop: Skip the mandatory post-review cleanup pass

Steps

1. PRD Setup (first iteration)
  • Check if .omc/prd.json exists via omg_read_prd
  • If none exists, generate a PRD scaffold with task-specific acceptance criteria
  • CRITICAL: Replace generic criteria with specific, testable ones
  • Initialize progress tracking
2. Pick Next Story
  • Read PRD via omg_read_prd
  • Select highest-priority story with passes: false
3. Implement Current Story
  • Delegate to @executor at appropriate complexity level
  • If sub-tasks are discovered, add as new stories to PRD
4. Verify Acceptance Criteria
  • For EACH criterion, verify with fresh evidence
  • Run relevant checks (test, build, lint, typecheck)
  • If any criterion NOT met, continue working
5. Mark Story Complete
  • Set passes: true via omg_update_story
  • Record progress in progress.txt
6. Check PRD Completion
  • Call omg_check_completion
  • If NOT all complete, loop to Step 2
  • If ALL complete, proceed to verification
7. Reviewer Verification
  • @verifier checks against specific acceptance criteria from PRD
  • @architect reviews for architectural soundness
7.5 Mandatory Cleanup Pass
  • Unless --no-deslop, run /ai-slop-cleaner on changed files only
7.6 Regression Re-verification
  • Re-run all tests after cleanup pass
  • Only proceed after regression tests pass
8. Completion
  • On approval: run /cancel for clean exit
  • On rejection: fix issues, re-verify, loop back

Execution Policy

  • Fire independent tasks simultaneously
  • Run builds/tests in background
  • Deliver full implementation: no scope reduction, no partial completion

Checklist

  • All PRD stories have passes: true
  • Acceptance criteria are task-specific (not generic)
  • All requirements met (no scope reduction)
  • Fresh test output shows all tests pass
  • Reviewer verification passed
  • Cleanup pass completed (or --no-deslop)
  • Post-cleanup regression tests pass

© zereight, 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 .github/skills/ralph of zereight/gitlab-mcp.

Open the folder on GitHubat commit 0109168

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in zereight/gitlab-mcp, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Ralph 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ralph this skillzereight/gitlab-mcp2k1 repos~711Automated safety check: PassMIT
Ralph Tui Create Beadssubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT
Ralph Tui Create Beads Rustsubsy/ralph-tui2.5k1 repos~2.8kAutomated safety check: PassMIT
Ralph Tui Create JSONsubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT
To Prdywwynm/EverythingDone14411 repos~777Automated safety check: PassGPL-3.0
Ralphjulianromli/opencode-template1441 repos~1.1kAutomated safety check: PassNone

Similar skills

  • Ralph Tui Create Beads

    subsy/ralph-tui

    Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI).

    2.5k GitHub starsUsed in 1 repo~2.8k tokens
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create JSON

    subsy/ralph-tui

    Convert PRDs to prd.json format for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • To Prd

    ywwynm/EverythingDone

    Turn the current conversation context into a PRD and publish it to the project issue tracker.

    144 GitHub starsUsed in 11 repos~777 tokens
    Product & Project ManagementAuto-check passed
  • Ralph

    julianromli/opencode-template

    Autonomous agent loop for completing features. An agent skill from julianromli/opencode-template.

    144 GitHub starsUsed in 1 repo~1.1k tokens
    Product & Project ManagementAuto-check passed
  • Use Case Writer

    phucnt-bazone-vietnam/use-case-writer

    Generate Use Case specifications in English Markdown following the IT BA standard 13-field template (Karl Wiegers / IIBA).

    142 GitHub stars~4.1k tokensUpdated 4 mo ago
    Product & Project ManagementAuto-check passed

More from zereight/gitlab-mcp

All 24 skills in this repo
  • OMG Mode Canceller

    zereight/gitlab-mcp

    Detects which autonomous OMG mode is currently active - Autopilot, Ralph, Ultrawork, UltraQA, Team or Self-Improve - and shuts it down cleanly.

    2k GitHub starsUsed in 1 repo~690 tokens
    Auto-check passed
  • CCG Tri-Model Orchestration

    zereight/gitlab-mcp

    Runs a task through Codex and Gemini CLIs in parallel alongside Claude, then synthesizes the three outputs into one answer with agreements and conflicts called out.

    2k GitHub starsUsed in 1 repo~657 tokens
    Auto-check passed
  • Shared reference for naming, function size, complexity and error handling rules that reviewer agents apply across TypeScript, Python, Go, Rust, Java, C# and Swift.

    2k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Remember Project Knowledge

    zereight/gitlab-mcp

    Sorts what you learned in a session into the right memory surface, filtering out ephemeral notes and duplicates before anything is stored.

    2k GitHub starsUsed in 1 repo~846 tokens
    Auto-check passed
  • Pre-Commit Security Scan

    zereight/gitlab-mcp

    Runs a fast security sweep of recent code changes before a commit or PR, checking for leaked secrets, vulnerable dependencies, unsafe input handling and auth gaps.

    2k GitHub starsUsed in 1 repo~859 tokens
    Auto-check: notes
  • Skill Inventory Stocktake

    zereight/gitlab-mcp

    Audits a project's skill directories for broken frontmatter, missing template sync and quality gaps, then produces a health report of what needs fixing.

    2k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed

Questions about Ralph

What does Ralph do?

PRD-driven persistence loop until task completion with verification. Ralph is an agent skill from zereight/gitlab-mcp. PRD-driven persistence loop until task completion with verification.

When should I use Ralph?

Ralph fits situations like: keep going until done; tasks that involve PRD writing; tasks that involve User stories.

How do I install Ralph in Claude Code?

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

How do I install Ralph in Codex?

Run `npx skills add zereight/gitlab-mcp --skill ralph -a codex`. Or copy the skill folder (.github/skills/ralph in zereight/gitlab-mcp) into .agents/skills/ralph in your project. Codex loads it when a task matches its description.

Can I use Ralph 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 zereight/gitlab-mcp --skill ralph -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, .gemini/skills/ralph, .github/skills/ralph and .opencode/skills/ralph in your project.

What does Ralph need to run?

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

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

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

About 711 tokens (SKILL.md is roughly 2.8k 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?

Skills that share tags, products or a category with Ralph: Ralph Tui Create Beads (subsy/ralph-tui, 2.5k stars), Ralph Tui Create Beads Rust (subsy/ralph-tui, 2.5k stars), Ralph Tui Create JSON (subsy/ralph-tui, 2.5k stars) and To Prd (ywwynm/EverythingDone, 144 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ralph?

zereight (a GitHub user) maintains it in zereight/gitlab-mcp, which has 2,029 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 6, 2026.

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