ralph-hats
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.
How do I install this agent skill?
npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill ralph-hatsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The ralph-hats skill is a specialized development utility for managing Ralph hat collection workflows. It enables an agent to create, validate, and visualize configuration files within the .ralph/hats/ directory and execute the ralph CLI tool. The analysis identified standard operational risks inherent to development tools, such as processing user-provided configuration files and executing local commands. No malicious patterns, such as data exfiltration or unauthorized access, were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1/5 files flagged
What does this agent skill do?
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.
Guardrails
- Only use hats-file top-level keys that Ralph accepts today:
name,description,events,event_loop,hats. - In a hats file,
event_loopis only for hats overlay keys such asstarting_eventandcompletion_promise. - Never use
task.startortask.resumeas hat triggers. Ralph reserves those for coordination. Use semantic delegated events likework.start,review.start, orresearch.start. - Each trigger must route to exactly one hat.
- Keep
descriptionpopulated on every hat. - Prefer
events:metadata when custom event names would otherwise be opaque. - Do not write user workflows into
presets/from this skill.
Output Expectations
- When editing or creating hats, produce the file changes and the validation result.
- When only inspecting, produce a concise topology summary, the main risks, and concrete improvement options.
Read These References When Needed
- For current hats schema and supported fields:
references/schema.md - For command recipes and validation workflow:
references/commands.md - For pattern and file examples:
references/examples.md
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/mikeyobrien/ralph-orchestrator/ralph-hats">View ralph-hats on skillZs</a>