tzachbon avatar

Ralph Specum Help

A meta-helper that explains how to use the Ralph Specum workflow system in Codex. You invoke this when you need guidance on Ralph's commands and flow, not for actual spec work. It covers the full suite of ralph-specum skills, from triage through implementation, and clarifies the approval-gated process where Ralph won't auto-advance between phases unless you explicitly ask for quick mode. The disk contract lives in ./specs with state tracked in .ralph-state.json. Useful if you're learning the system or forgot which helper skill does what, but otherwise you'll spend more time in the actual workflow commands.

GitHub stars
340
last updated
May 19, 2026

Install

$ npx -y skills add tzachbon/smart-ralph --skill ralph-specum-help --agent claude-code

Installs into .claude/skills of the current project.

Files

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

Sponsors

Details

Repository
github.com/tzachbon/smart-ralph
Category
Automation & Workflows
License
MIT
First seen
Jun 11, 2026

More from tzachbon/smart-ralph

All 28
1tzachbon avatarralph-specum-researchtzachbon/smart-ralphThis is the research phase coordinator for Ralph Specum, a spec-driven development workflow.0skills.sh installs
2tzachbon avatarralph-specum-starttzachbon/smart-ralphThis is the entry point for Ralph Specum's spec workflow.0skills.sh installs
3tzachbon avatarralph-specum-statustzachbon/smart-ralphThis is a status reporter for Ralph Specum, a spec-driven development workflow tool.0skills.sh installs
4tzachbon avatarralph-specum-taskstzachbon/smart-ralphThis is the orchestration layer for Ralph Specum's task planning phase.0skills.sh installs
5utopai-research avatarvideo-composeutopai-research/pai-proGenerates and prompts video clips on the filmmaking canvas. Use when the user asks to generate, render, animate, continue, restyle, edit, shoot, or compose a vi0skills.sh installs
6vila-lab avataropenspec-archive-changevila-lab/figmirrorArchive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete.0skills.sh installs