# Ralph Specum Help

Should be used only when the user explicitly asks to use `$ralph-specum-help`, or...

- Repository: https://github.com/tzachbon/smart-ralph (566 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add tzachbon/smart-ralph --skill ralph-specum-help -g -a claude-code -y`
Codex: `npx skills add tzachbon/smart-ralph --skill ralph-specum-help -g -a codex -y`
Cursor: `npx skills add tzachbon/smart-ralph --skill ralph-specum-help -g -a cursor -y`
Gemini CLI: `npx skills add tzachbon/smart-ralph --skill ralph-specum-help -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add tzachbon/smart-ralph`

## Description

This skill should be used only when the user explicitly asks to use `$ralph-specum-help`, or explicitly asks Ralph Specum in Codex for help or command guidance.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Ralph Specum Help

Use this to explain the Ralph Specum surface in Codex.

## Cover

- Primary skill: `$ralph-specum`
- Helper skills: `$ralph-specum-start`, `$ralph-specum-triage`, `$ralph-specum-research`, `$ralph-specum-requirements`, `$ralph-specum-design`, `$ralph-specum-tasks`, `$ralph-specum-prototype`, `$ralph-specum-implement`, `$ralph-specum-status`, `$ralph-specum-switch`, `$ralph-specum-cancel`, `$ralph-specum-index`, `$ralph-specum-refactor`, `$ralph-specum-feedback`, `$ralph-specum-help`
- Normal flow: start goal grill, approval, research, artifact approval, requirements grill, approval, design grill, approval, tasks grill, approval, implement
- Large effort flow: triage, then start each unblocked spec
- Quick mode: only exact `--quick` bypasses interview questions; exact `--interactive` clears it. Discovery, skill loads, and artifact write gates still run
- Disk contract: `./specs` or configured roots, `.current-spec`, optional `.current-epic`, per-spec markdown files, `.ralph-state.json`

## Optional Prototype Overlay

- Direct mode: invoke `$ralph-specum-prototype` from research, requirements, design, tasks, or execution. Preserve the main phase and current checkout.
- Suggested mode: research or requirements may offer `continue to prototype`, then return to the next normal phase.
- Resume mode: use `$ralph-specum-prototype --resume <id>`. One active entry resumes automatically; several are listed deterministically for selection.
- Quick mode: run exactly one agent-owned request after requirements, ask no prototype questions, take over the oldest design blocker or select the highest-risk grounded, falsifiable question when no blocker exists, own verdict and handoff decisions, and continue to design for every result.
- Cancel mode: use `$ralph-specum-prototype --cancel <id>` or safe spec cancellation. Stop at a safe boundary, publish a reviewed immutable `cancelled` record, and preserve source and partial implementation.

The rest: https://github.com/tzachbon/smart-ralph/blob/HEAD/plugins/ralph-specum-codex/skills/ralph-specum-help/SKILL.md