squad-creator-validate

Validate squad manifest files and directory structures against the v2 schema.

3|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/GDSDN/kord-aios --skill squad-creator-validate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: squad-creator-validate
Source: https://github.com/GDSDN/kord-aios/tree/main/src/features/builtin-skills/kord-aios/squad/squad-creator-validate
Command: npx skills add https://github.com/GDSDN/kord-aios --skill squad-creator-validate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures that your squad configurations are correctly defined and adhere to the expected schema, preventing runtime errors and improving squad reliability.

Core Features & Use Cases

  • Manifest Validation: Checks for the presence and correct parsing of SQUAD.yaml.
  • Schema Conformance: Validates the SQUAD.yaml against the defined v2 schema.
  • Structure Verification: Ensures required directories like agents/ and skills/ exist.
  • Agent Integrity: Verifies agent naming conventions and references to default executors/reviewers.
  • Best Practice Checks: Flags potential issues like missing chiefs or tags in multi-agent squads.
  • Use Case: Before deploying a new squad, run validate-squad my-new-squad to catch any structural or configuration errors, ensuring it's ready for execution.

Quick Start

Validate the squad configuration located at the path '.opencode/squads/my-squad'.

Frequently Asked Questions about squad-creator-validate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate a squad manifest configuration before deployment?

To validate a squad manifest, run the validator against your squad path to check SQUAD.yaml parsing, enforce naming conventions, and verify agent references. This process catches structural configuration errors before execution.

What does strict mode validation do for multi-agent squad configurations?

Strict mode validation for multi-agent squads treats configuration warnings as errors. It enforces schema v2 compliance, flags missing chiefs or tags, and prevents deployment if any best practice checks fail.

How do I check if required directories exist in my squad configuration?

To check required directories in your squad configuration, the validator performs structure verification to ensure required folders like agents/ and skills/ exist alongside a correctly parsed SQUAD.yaml manifest file.

Why does my squad manifest validation fail on agent references?

Squad manifest validation fails on agent references when naming conventions are violated or default executor and reviewer designations are missing. The validator enforces these rules to maintain multi-agent configuration integrity.

Can I validate squad configurations without strict mode?

Yes, you can validate squad configurations without strict mode. The validator will still check SQUAD.yaml schema conformance and directory structures, but will only flag potential issues like missing tags as warnings rather than failing execution.

When do I need schema validation for my squad manifest?

You need schema validation for your squad manifest before deploying a new squad to prevent runtime errors. Validating against the v2 schema ensures your multi-agent configurations are correctly defined and ready for execution.