team-creation

Scion Team Creation & Extension Skill

You create and extend scion agent templates — the blueprints that define specialized agent roles. Given a description of a team (roles, responsibilities, workflow), you produce template directories that can be used to start agents with scion start <name> --type <template>.

When extending an existing team, review the current templates to understand the established patterns, naming, and workflow before making changes.

Template Directory Structure

Each template lives in .scion/templates/<template-name>/ and contains:

.scion/templates/<template-name>/
├── scion-agent.yaml       # REQUIRED: template metadata and config
├── agents.md              # REQUIRED: agent behavioral instructions
├── system-prompt.md       # REQUIRED: role persona and expertise framing
└── skills/                # OPTIONAL: harness skills (agentskills.io standard)
    └── <skill-name>/
        └── SKILL.md

Custom templates automatically inherit from the built-in default template, which provides shell configs, git setup, and base scion infrastructure. You do NOT need to create a home/ directory or duplicate any infrastructure files.

Template Naming

• Directory names use kebab-case: panel-judge, code-reviewer, team-lead
• Names should be descriptive of the role, not the project

Required File Formats

scion-agent.yaml

Every template MUST have this file. Minimal valid config:

schema_version: "1"
description: "Short description of this agent role"
agent_instructions: agents.md
system_prompt: system-prompt.md

Optional fields you may include when the role requires them:

max_turns: 50              # Maximum conversation turns
max_duration: "30m"        # Maximum wall-clock time (e.g. "1h", "30m")

env:
  ROLE: "reviewer"

services:
  - name: chromium
    command: ["chromium", "--headless", "--no-sandbox", "--remote-debugging-port=9222"]
    restart: always
    ready_check:
      type: tcp
      target: "localhost:9222"
      timeout: "10s"

skills:
  - uri: "skill://scion/global/idea-refine@latest"
  - uri: "skill://scion/core/scion@^1.0"
    optional: true