Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/tzachbon/smart-ralphnpx agentmods add commands/tzachbon/smart-ralph/helpWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/commands/tzachbon/smart-ralph/help)<a href="https://agentmods.dev/commands/tzachbon/smart-ralph/help"><img src="https://agentmods.dev/badge/commands/tzachbon/smart-ralph/help/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/commands/tzachbon/smart-ralph/help"><img src="https://agentmods.dev/badge/commands/tzachbon/smart-ralph/help.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00011 | $0.02171 |
| Opus 5.5 | $0.00004 | $0.00868 |
| Sonnet 5.5 | $0.00002 | $0.00434 |
| Haiku 4.5 | $0.00001 | $0.00217 |
Grade A, and why
help scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 256 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Ralph Specum Help
Overview
Ralph Specum is a spec-driven development plugin that guides you through research, requirements, design, and task generation phases, then executes tasks autonomously with fresh context per task.
Commands
| Command | Description |
|---|---|
/ralph-specum:start [name] [goal] |
Smart entry point: resume or create new |
/ralph-specum:new <name> [goal] |
Create new spec and start research |
/ralph-specum:research |
Run/re-run research phase |
/ralph-specum:requirements |
Generate requirements (approves research) |
/ralph-specum:design |
Generate design (approves requirements) |
/ralph-specum:tasks |
Generate tasks (approves design) |
/ralph-specum:prototype [--resume ID | --cancel ID | --quick] |
Run, resume, or cancel optional prototype evidence |
/ralph-specum:implement |
Start execution loop (approves tasks) |
/ralph-specum:status |
Show all specs and progress |
/ralph-specum:switch <name> |
Change active spec |
/ralph-specum:cancel |
Safely cancel active work; source is preserved |
/ralph-specum:feedback [message] |
Submit feedback or report an issue |
/ralph-specum:help |
Show this help |
Workflow
/ralph-specum:new "my-feature"
|
v
[Research Phase] - Automatic on new
|
v (review research.md)
/ralph-specum:requirements
|
v (review requirements.md)
/ralph-specum:design
|
v (review design.md)
/ralph-specum:tasks
|
v (review tasks.md)
/ralph-specum:implement
|
v
[Task-by-task execution with fresh context]
|
v
Done!
Quick Start
# Easiest: use start (auto-detects resume or new)
/ralph-specum:start user-auth Add JWT authentication
# Or resume an existing spec
/ralph-specum:start
# Manual workflow with individual commands:
/ralph-specum:new user-auth Add JWT authentication
/ralph-specum:requirements
/ralph-specum:design
/ralph-specum:tasks
/ralph-specum:implement
Optional Prototype Overlay
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 256 lines · 11 tokens per session scan A ade4c00291a1
help is a command published in the GitHub repository tzachbon/smart-ralph (561 stars, last pushed 1mo ago), licensed MIT. It adds 11 tokens to every session and 2,171 once invoked, about $0.0000 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other commands, from other repositories
resume-project
Run resume-project now — Now / Blocked / Next. Not a cheat sheet.
backlog
PitWay: Capture out-of-scope work discovered mid-task, without expanding current scope.
frankx-ai-build
Comprehensive FrankX.AI website build session - plan, create, review, deploy.
publish
Publish a reviewed content packet through the canonical publisher and verify the remote result.
acos-swarm
Initialize a coordinated swarm of agents for complex, multi-file tasks.
ops
Weekly operations loop — triage the inquiry inbox, advance the CRM pipeline, sweep open PRs across repos, and surface the content plan. Loads the ops skill.