Updated 1mo ago
by tzachbon
smart-ralph
Spec-driven development with smart compaction. Claude Code plugin combining Ralph Wiggum loop with structured specification workflow.
559 GitHub stars (559)
+9 in 20 days
| Period | New stars |
|---|---|
| Sep 27 | 0 |
| Sep 28 | 0 |
| Sep 29 | +1 |
| Sep 30 | +2 |
| Oct 1 | 0 |
| Oct 2 | +1 |
| Oct 3 | −2 |
| Oct 4 | +1 |
| Oct 5 | 0 |
| Oct 6 | +2 |
| Oct 7 | +1 |
| Oct 8 | +1 |
| Oct 9 | +1 |
| Oct 10 | +1 |
| Oct 11 | 0 |
| Oct 12 | 0 |
| Oct 13 | 0 |
| Oct 14 | 0 |
| Oct 15 | 0 |
| Oct 16 | 0 |
- 29 skills (29 skills found in its SKILL.md files)
- 50 forks (50 forks)
- 1mo ago last update (Last updated 1mo ago)
Install
Skills CLI
npx skills add tzachbon/smart-ralph
Asks which skills and agents to install. Just one: npx skills add tzachbon/smart-ralph --skill 'Command Development' — add -g for every project.
Claude Code
git clone https://github.com/tzachbon/smart-ralphcp -r "smart-ralph/.agents/skills/Command Development" ~/.claude/skills/
Copies the Command Development skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add tzachbon/smart-ralph
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md — showing the first 29 of 32 files.
-
Command Development
This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in co…
.agents/skills/Command Development/SKILL.md on GitHub (opens in a new tab) -
Hook Development
This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provide…
.agents/skills/Hook Development/SKILL.md on GitHub (opens in a new tab) -
MCP Integration
This skill should be used when the user asks to "add MCP server", "integrate MCP", "configure MCP in plugin", "use .mcp.json", "set up Model Context Protocol", "connect external service", mentions "${CLAUDE_PLUGIN_ROOT} with MCP", or discusses MCP server types (SSE, stdio, HTTP, WebSocket). Provides comprehensive guidance for integrating Model Context Protocol servers into Claude Code plugins for…
.agents/skills/MCP Integration/SKILL.md on GitHub (opens in a new tab) -
Plugin Settings
This skill should be used when the user asks about "plugin settings", "store plugin configuration", "user-configurable plugin", ".local.md files", "plugin state files", "read YAML frontmatter", "per-project plugin settings", or wants to make plugin behavior configurable. Documents the .claude/plugin-name.local.md pattern for storing plugin-specific configuration with YAML frontmatter and markdown…
.agents/skills/Plugin Settings/SKILL.md on GitHub (opens in a new tab) -
Plugin Structure
This skill should be used when the user asks to "create a plugin", "scaffold a plugin", "understand plugin structure", "organize plugin components", "set up plugin.json", "use ${CLAUDE_PLUGIN_ROOT}", "add commands/agents/skills/hooks", "configure auto-discovery", or needs guidance on plugin directory layout, manifest configuration, component organization, file naming conventions, or Claude Code p…
.agents/skills/Plugin Structure/SKILL.md on GitHub (opens in a new tab) -
Skill Development
This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins.
.agents/skills/Skill Development/SKILL.md on GitHub (opens in a new tab) -
communication-style
Output rules for all agents - concise, scannable, actionable. Based on Matt Pocock's planning principles.
plugins/ralph-speckit/skills/communication-style/SKILL.md on GitHub (opens in a new tab) -
delegation-principle
Core principle that the main agent is a coordinator, not an implementer. All work must be delegated to subagents.
plugins/ralph-speckit/skills/delegation-principle/SKILL.md on GitHub (opens in a new tab) -
smart-ralph
Core Smart Ralph skill defining common arguments, execution modes, and shared behaviors across all Ralph plugins.
plugins/ralph-speckit/skills/smart-ralph/SKILL.md on GitHub (opens in a new tab) -
speckit-workflow
Comprehensive understanding of the spec-kit methodology. Constitution-driven feature development with specify, plan, tasks, and implement phases.
plugins/ralph-speckit/skills/speckit-workflow/SKILL.md on GitHub (opens in a new tab) -
interview-framework-codex
Internal Ralph Specum contract for Codex phase interviews, skill manifests, approval, and delegation gates. Phase coordinators load this skill directly; users do not invoke it as a workflow phase.
plugins/ralph-specum-codex/skills/interview-framework-codex/SKILL.md on GitHub (opens in a new tab) -
ralph-specum-cancel
This skill should be used only when the user explicitly asks to use `$ralph-specum-cancel`, or explicitly asks Ralph Specum in Codex to stop execution or remove a spec.
plugins/ralph-specum-codex/skills/ralph-specum-cancel/SKILL.md on GitHub (opens in a new tab) -
ralph-specum-design
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.
plugins/ralph-specum-codex/skills/ralph-specum-design/SKILL.md on GitHub (opens in a new tab) -
ralph-specum-feedback
This skill should be used only when the user explicitly asks to use `$ralph-specum-feedback`, or explicitly asks Ralph Specum in Codex to draft or submit feedback.
plugins/ralph-specum-codex/skills/ralph-specum-feedback/SKILL.md on GitHub (opens in a new tab) -
ralph-specum-help
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.
plugins/ralph-specum-codex/skills/ralph-specum-help/SKILL.md on GitHub (opens in a new tab) -
ralph-specum-implement
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.
plugins/ralph-specum-codex/skills/ralph-specum-implement/SKILL.md on GitHub (opens in a new tab) -
ralph-specum-index
This skill should be used only when the user explicitly asks to use `$ralph-specum-index`, or explicitly asks Ralph Specum in Codex to generate or refresh index artifacts.
plugins/ralph-specum-codex/skills/ralph-specum-index/SKILL.md on GitHub (opens in a new tab) -
ralph-specum-prototype
This skill should be used only when the user explicitly invokes `$ralph-specum-prototype`, or explicitly asks Ralph Specum in Codex to run, resume, quick-run, or cancel an optional prototype.
plugins/ralph-specum-codex/skills/ralph-specum-prototype/SKILL.md on GitHub (opens in a new tab) -
ralph-specum-refactor
This skill should be used only when the user explicitly asks to use `$ralph-specum-refactor`, or explicitly asks Ralph Specum in Codex to revise spec artifacts after implementation learnings.
plugins/ralph-specum-codex/skills/ralph-specum-refactor/SKILL.md on GitHub (opens in a new tab) -
ralph-specum-requirements
This skill should be used only when the user explicitly asks to use `$ralph-specum-requirements`, or explicitly asks Ralph Specum in Codex to run the requirements phase.
plugins/ralph-specum-codex/skills/ralph-specum-requirements/SKILL.md on GitHub (opens in a new tab) -
ralph-specum-research
This skill should be used only when the user explicitly asks to use `$ralph-specum-research`, or explicitly asks Ralph Specum in Codex to run the research phase.
plugins/ralph-specum-codex/skills/ralph-specum-research/SKILL.md on GitHub (opens in a new tab) -
ralph-specum-start
This skill should be used only when the user explicitly asks to use `$ralph-specum-start`, or explicitly asks Ralph Specum in Codex to start or resume a spec.
plugins/ralph-specum-codex/skills/ralph-specum-start/SKILL.md on GitHub (opens in a new tab) -
ralph-specum-status
This skill should be used only when the user explicitly asks to use `$ralph-specum-status`, or explicitly asks Ralph Specum in Codex for status or active spec progress.
plugins/ralph-specum-codex/skills/ralph-specum-status/SKILL.md on GitHub (opens in a new tab) -
ralph-specum-switch
This skill should be used only when the user explicitly asks to use `$ralph-specum-switch`, or explicitly asks Ralph Specum in Codex to switch the active spec.
plugins/ralph-specum-codex/skills/ralph-specum-switch/SKILL.md on GitHub (opens in a new tab) -
ralph-specum-tasks
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.
plugins/ralph-specum-codex/skills/ralph-specum-tasks/SKILL.md on GitHub (opens in a new tab) -
ralph-specum-triage
This skill should be used only when the user explicitly asks to use `$ralph-specum-triage`, or explicitly asks Ralph Specum in Codex to triage a large effort into multiple specs.
plugins/ralph-specum-codex/skills/ralph-specum-triage/SKILL.md on GitHub (opens in a new tab) -
ralph-specum
Use only when the user explicitly invokes `$ralph-specum`, requests Ralph Specum in Codex, or asks Ralph Specum to handle a named phase or optional prototype.
plugins/ralph-specum-codex/skills/ralph-specum/SKILL.md on GitHub (opens in a new tab) -
interview-framework
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 before delegating artifact work.
plugins/ralph-specum/skills/interview-framework/SKILL.md on GitHub (opens in a new tab) -
reality-verification
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 tests", or needs guidance on verifying fixes by reproducing failures before and after implementation, or detecting mock-heavy test anti-patterns.
plugins/ralph-specum/skills/reality-verification/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.