Ralph Hats
Create, inspect, validate, explain, and improve Ralph hat collections.
Install
npx skills add mikeyobrien/ralph-orchestrator --skill ralph-hats -g -a claude-code -y- Repository
- mikeyobrien/ralph-orchestrator3.2k
- Category
- Testing
- Updated
- 5d ago
- License
- MIT
- Context cost
- Lightabout 622 tokens
- Runs scripts
- No, instructions only
What it does
Create, inspect, validate, explain, and improve Ralph hat collections. Use this skill whenever the user asks to make or refine a `.ralph/hats/*.yml` workflow, debug hat routing, explain event topology, or tune a multi-hat Ralph run.
Ralph Hats
Use this skill to operate the full Ralph hat lifecycle for user-authored hat collections.
Use This Skill For
- Creating a new hat collection in
.ralph/hats/ - Inspecting an existing hat collection and explaining its topology
- Validating trigger routing, event flow, and completion behavior
- Improving or refactoring hats for clearer roles and safer routing
- Recommending better orchestration patterns for a Ralph workflow
Core Assumptions
- Core runtime config already lives in
ralph.ymlor another-csource. - User-authored hats are stored separately and passed with
-H. - This skill operates public hat collections, not Ralph built-in presets.
Workflow
- If a hats file already exists, read it first and explain the current topology before proposing changes.
- If creating a new workflow, write it to
.ralph/hats/<name>.yml. - Keep the hats file focused on hats-only data. Leave runtime limits and other core config in the main config file.
- Validate with
ralph hats validate. - Visualize topology with
ralph hats graphwhen the event flow is not trivial. - Use
ralph hats show <hat>when you need to inspect one hat's effective configuration. - When the user wants stronger confidence, run a targeted
ralph run -c ... -H ... -p "..."exercise or provide the exact test command.
