mikeyobrien/ralph-hats
skills/ralph-hats/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add mikeyobrien/ralph-orchestrator ralph-hatsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 10, 2026, 2:18 AM4.7s5 files scanned
SKILL.md
- name:
- ralph-hats
- description:
- 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.
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
Related Skills
mikeyobrien/ralph-docs
development
VerifiedTrustedCommunity
Introspect, explain, and improve Ralph Orchestrator using its published llms.txt doc map. Use this skill whenever the user asks questions about Ralph's behavior, wants to understand how a Ralph internal works (event loop, hats, memories, tasks, backends, presets), debug an unfamiliar failure mode, or propose a code change to the ralph-orchestrator repo. The skill teaches the agent to discover authoritative answers from the live docs via llms.txt before guessing, and to scope improvements through the published architecture rather than the local checkout alone.
2,840SKILL.mdUpdated May 9, 2026
mikeyobrien/ralph-loop
development
VerifiedTrustedCommunity
Run, monitor, resume, merge, and debug Ralph loops. Use this skill whenever the user asks to operate `ralph run` or `ralph loops`, inspect loop state, recover suspended loops, analyze diagnostics, or unblock merge queue issues.
2,489SKILL.mdUpdated Apr 10, 2026
mikeyobrien/complex-test-skill
testing
VerifiedTrustedCommunity
A directory-style test skill for smoke testing
2,489SKILL.mdUpdated Apr 10, 2026
mikeyobrien/tui-validate
testing
VerifiedTrustedCommunity
Validates Terminal User Interface (TUI) output using freeze for screenshot capture and LLM-as-judge for semantic validation. Supports both visual (PNG/SVG) and text-based validation modes.
2,489SKILL.mdUpdated Apr 10, 2026