Skip to main content

​
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

@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 <squad-name>
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 <squad-name>
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 <squad-name>
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

1

Design Phase

Define squad purpose, required agents, and capabilities.
*create-squad
# Follow interactive prompts
2

Structure Creation

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
3

Validation

Validate squad integrity and completeness:
*validate-squad your-squad
Fix any reported issues.
4

Testing

Test squad agents and workflows in your project:
@your-squad-agent
*help
5

Documentation

Ensure complete documentation:
  • README with overview
  • Agent guides
  • Workflow documentation
  • Usage examples
6

Publication

Prepare for sharing:
*publish-squad your-squad
Follow publication guidelines for GitHub or marketplace.

​
Squad Structure Requirements

A valid squad must include:

config.yaml

Squad manifest with metadata, agents, and dependencies

agents/

Agent definition files for all squad members

tasks/

Executable task definitions for agent commands

workflows/

Workflow definitions for squad processes

templates/

Document templates used by agents

README.md

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

Squad System Overview

Learn about the AIOX squad architecture

Creating Squads Guide

Complete guide to squad creation

Squad Configuration

Squad manifest and configuration reference

Publishing Squads

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 to understand the squad system, then return here to create your first squad with the Squad Creator agent.

Build docs developers (and LLMs) love

Get started for freeTalk to us