> ## Documentation Index > Fetch the complete documentation index at: https://mintlify.com/SynkraAI/aiox-core/llms.txt > Use this file to discover all available pages before exploring further. # Squad Creator Agent > Specialist agent for creating, validating, and publishing AIOX squads # Squad Creator Agent The **Squad Creator** agent specializes in creating, validating, and publishing AIOX squads — modular teams of agents designed for specific domains or use cases. ## Role **Squad Creation Specialist** — Guides users through the complete squad creation lifecycle, from design to publication. ## Key Responsibilities * Design squad structure and agent composition * Create squad manifests and configuration * Validate squad integrity and completeness * Generate squad documentation * Prepare squads for publication * Assist with squad marketplace submission ## Agent Activation ```bash Claude Code theme={null} @squad-creator ``` ```bash Codex CLI theme={null} /skills # Select: aiox-squad-creator ``` ```bash Gemini CLI theme={null} /aiox-squad-creator ``` ## Core Commands Create a new squad from scratch with interactive guidance. **Usage:** ``` *create-squad ``` The agent will guide you through: 1. Squad purpose and goals 2. Required agents and roles 3. Workflow definitions 4. Task and template creation 5. Configuration setup **Output:** * Squad directory structure in `squads/{squad-name}/` * Squad manifest (`config.yaml`) * Agent definitions * Workflows and tasks * README and documentation Validate a squad's structure, configuration, and completeness. **Usage:** ``` *validate-squad ``` **Checks:** * Squad manifest structure * Required files present * Agent definitions valid * Task/workflow syntax * Documentation completeness * No circular dependencies **Example:** ``` *validate-squad my-content-squad ``` Analyze an existing squad to understand its structure and capabilities. **Usage:** ``` *analyze-squad ``` **Output:** * Squad purpose and goals * Agent roster and roles * Available workflows * Task inventory * Dependencies * Configuration options Prepare a squad for publication to GitHub or squad marketplace. **Usage:** ``` *publish-squad ``` **Steps:** 1. Validate squad completeness 2. Generate publication manifest 3. Create installation script 4. Build README and docs 5. Package for distribution Display comprehensive guide for squad creation. **Usage:** ``` *guide ``` Shows: * Squad architecture overview * Best practices * File structure requirements * Configuration options * Publishing guidelines ## Squad Creation Workflow Define squad purpose, required agents, and capabilities. ``` *create-squad # Follow interactive prompts ``` Agent creates squad directory structure with all required files: ``` squads/your-squad/ ├── config.yaml # Squad manifest ├── agents/ # Agent definitions ├── tasks/ # Executable tasks ├── workflows/ # Workflow definitions ├── templates/ # Document templates ├── checklists/ # Quality checklists ├── data/ # Knowledge base └── README.md # Documentation ``` Validate squad integrity and completeness: ``` *validate-squad your-squad ``` Fix any reported issues. Test squad agents and workflows in your project: ``` @your-squad-agent *help ``` Ensure complete documentation: * README with overview * Agent guides * Workflow documentation * Usage examples Prepare for sharing: ``` *publish-squad your-squad ``` Follow publication guidelines for GitHub or marketplace. ## Squad Structure Requirements A valid squad must include: Squad manifest with metadata, agents, and dependencies Agent definition files for all squad members Executable task definitions for agent commands Workflow definitions for squad processes Document templates used by agents Squad documentation and usage guide ## Works With The Squad Creator agent collaborates with: * **@architect** — For squad architecture design * **@pm** — For squad planning and requirements * **@qa** — For squad validation and testing * **@devops** — For squad packaging and distribution ## Usage Examples ### Create a Content Writing Squad ``` @squad-creator *create-squad # Agent prompts: # - Squad name: content-writers # - Purpose: Blog and documentation writing # - Agents: writer, editor, seo-specialist # - Workflows: draft → edit → seo-optimize → publish ``` ### Validate an Existing Squad ``` @squad-creator *validate-squad data-science # Output: # ✅ Squad manifest valid # ✅ All agent files present # ✅ Workflows validated # ⚠️ Missing: checklists/quality.md # ❌ Invalid: tasks/analyze.md (syntax error) ``` ### Analyze a Squad ``` @squad-creator *analyze-squad marketing-automation # Output: # Squad: Marketing Automation # Purpose: Automated marketing campaign management # Agents: 4 (strategist, content-creator, analyst, optimizer) # Workflows: 6 (campaign-creation, content-generation, ...) # Dependencies: aiox-core ^4.0.0 ``` ## Best Practices **Squad Design Principles:** 1. **Single Responsibility** — Each squad should focus on one domain or workflow 2. **Agent Cohesion** — Squad agents should work together toward squad goals 3. **Clear Workflows** — Define explicit workflows for common tasks 4. **Comprehensive Docs** — Include clear README and usage examples 5. **Validation** — Always validate before publication ## Common Pitfalls **Avoid These Mistakes:** * Creating squads without clear purpose * Missing required files (config.yaml, README.md) * Circular dependencies between squad agents * Incomplete or unclear documentation * Skipping validation before publication * Not testing squad agents in real projects ## Related Documentation Learn about the AIOX squad architecture Complete guide to squad creation Squad manifest and configuration reference How to publish and share squads ## Need Help? The Squad Creator agent is here to guide you through squad creation. Activate it and ask for: * `*guide` — Comprehensive squad creation guide * `*help` — List all available commands * Specific questions about squad structure, validation, or publication New to squads? Start with the [Squads Overview](/advanced/squads) to understand the squad system, then return here to create your first squad with the Squad Creator agent.