shared-commands-skills.yaml

# yaml-language-server: $schema=../agent-schema.json

# This example demonstrates the top-level `commands` and `skills` sections.
# Define reusable command and skill groups once, then reference them by name
# from multiple agents via `use_commands` / `use_skills`, avoiding duplication.

models:
  model:
    provider: anthropic
    model: claude-sonnet-5
    max_tokens: 64000

# Reusable, named command groups.
commands:
  ci:
    deploy: "Deploy the application"
    test: "Run the test suite"
  docs:
    build-docs:
      description: "Build the documentation site"
      instruction: "Build the docs and report any broken links."

# Reusable, named skill groups (same value format as an agent's `skills`).
skills:
  base:
    - local
    - git

agents:
  root:
    model: model
    description: Lead developer
    instruction: |
      You are the lead developer. Coordinate the team.
    sub_agents: [docs-writer]
    # Pull in the "ci" command group and the "base" skill group by name.
    use_commands: [ci]
    use_skills: [base]
    # Inline commands are merged in and win on name conflicts.
    commands:
      lint: "Run the linter"

  docs-writer:
    model: model
    description: Documentation writer
    instruction: |
      You write and maintain the project documentation.
    # Reuse the same groups, plus the docs-specific commands.
    use_commands: [ci, docs]
    use_skills: [base]