claude-skills-marketplace

Claude Skills

A Claude Code plugin with shared skills for autonomous story execution using Ralph — a loop that reads tasks/prd.json and drives Claude Code or OpenAI Codex through one user story per iteration.

Skills

/plan-to-ralph — Convert a Superpowers implementation plan into Ralph's prd.json format. Maps plan tasks to user stories with machine-verifiable acceptance criteria, injects quality gates, and seeds cross-iteration context.

/shape-to-ralph — Convert shaping artifacts (requirements, breadboard, slices) directly into Ralph's prd.json format. No intermediate plan needed — the shaped slices ARE the spec.

/swarm-execute — Execute prd.json stories in parallel using Claude Code Agent Teams. Reads existing tasks/prd.json from /shape-to-ralph or /plan-to-ralph.

The ralph skills each include two execution scripts:

• ralph.sh — Runs the loop with Claude Code (claude --print)
• ralph-codex.sh — Runs the loop with OpenAI Codex (codex exec --full-auto)

Install

Add the marketplace, then install the plugin:

claude plugin marketplace add adelrioj/claude-skills
claude plugin install claude-skills@claude-skills-marketplace

Restart Claude Code for the plugin to load.

Update

claude plugin marketplace update claude-skills-marketplace
claude plugin update claude-skills@claude-skills-marketplace

Uninstall

claude plugin uninstall claude-skills@claude-skills-marketplace

To also remove the marketplace:

claude plugin marketplace remove claude-skills-marketplace

Local Development

For developing the plugin locally (session-only):

git clone https://github.com/adelrioj/claude-skills.git
claude --plugin-dir ./claude-skills

Usage

After converting a plan or shape to tasks/prd.json:

# Claude Code
${CLAUDE_PLUGIN_ROOT}/skills/plan-to-ralph/scripts/ralph.sh
${CLAUDE_PLUGIN_ROOT}/skills/shape-to-ralph/scripts/ralph.sh

# OpenAI Codex
${CLAUDE_PLUGIN_ROOT}/skills/plan-to-ralph/scripts/ralph-codex.sh --model o3
${CLAUDE_PLUGIN_ROOT}/skills/shape-to-ralph/scripts/ralph-codex.sh --model o4-mini

All scripts auto-detect the project root via git rev-parse --show-toplevel, so they work correctly from any location.