What problem does it solve?
Designing multi-agent orchestration workflows in Ralph requires correctly wiring hat triggers, published events, and routing rules in YAML, where mistakes like reserved triggers or ambiguous routing break the run. This Skill guides the full lifecycle of authoring, inspecting, validating, and refining .ralph/hats/*.yml collections.
Core Features & Use Cases
- Hat Collection Authoring: Create new workflow files under
.ralph/hats/ with correct schema, semantic delegated events, and per-hat instructions.
- Topology Inspection & Validation: Explain event flow with
ralph hats graph, inspect single hats with ralph hats show, and catch routing errors with ralph hats validate.
- Workflow Refactoring: Analyze an existing hats file, summarize risks, and propose minimal structural improvements.
- Use Case: You want a planner-builder-reviewer pipeline for a coding task. The Skill writes the YAML with
work.start as the starting event, validates routing, and renders a mermaid graph of the event flow.
Quick Start
Ask the assistant to create a Ralph hat collection in .ralph/hats/ for a plan-build-review workflow and validate it with ralph hats validate.