create-hat-collection

What This Skill Does

The create-hat-collection skill is a powerful architectural assistant designed to streamline the creation of multi-agent workflows within the OpenClaw environment. Rather than manually writing complex YAML configurations, this skill acts as a bridge between your high-level conceptual vision and production-ready code. It follows a structured, three-phase guided conversation to ensure your agents are defined with precision. The skill clarifies your project purpose, maps out complex event flows, validates your architecture against critical schema constraints, and ultimately outputs a fully formatted, valid YAML preset file directly into your presets/ directory. By enforcing standard design patterns like Critic-Actor or Supervisor-Worker, it prevents common architectural pitfalls and ensures your agent swarm is robust and maintainable.

Installation

To begin building your own custom hat collections, run the following command in your terminal:

clawhub install openclaw/skills/skills/paulpete/create-hat-collection

Use Cases

This skill is perfect for developers building autonomous agent swarms. Key scenarios include:

• Rapid prototyping of complex linear pipelines (A to B to C workflows).
• Designing sophisticated "Scientific" debugging workflows that require iterative hypothesis testing and failure recovery.
• Constructing Supervisor-Worker models where a central orchestrator delegates tasks to specialized agents.
• Standardizing team-wide agent behaviors by converting ad-hoc ideas into repeatable YAML templates.

Example Prompts

1. "I want to build a code review workflow where an Agent A writes code, Agent B critiques it, and Agent C rewrites it based on the feedback. Can you help me set up the hat collection?"
2. "Let's create a new preset for a research assistant that starts with a search agent, moves to a summarization agent, and finally outputs to a file-writer agent. Let's use the pipeline pattern."
3. "I need a supervisor hat that distributes tasks to three specific workers. Can you walk me through the design process and generate the YAML for me?"

Tips & Limitations

• Validate early: The skill includes strict schema validation. Pay close attention to the triggers and publishes lists to avoid ambiguous routing errors.
• Naming Conventions: Ensure your hat names and keys are descriptive; these become the identity of your agents at runtime.
• Constraints: Remember that task.start and task.resume are reserved events—do not attempt to define these as custom triggers in your workflow.
• Scope: This skill is strictly for creating new presets. If you need to edit an existing YAML file, please refer to the documentation for manual configuration updates or alternative editing tools.