references

SKILL.md — Team Synergy Coach Skill Registry Documentation

Overview

The team-synergy-coach skill registry provides a comprehensive framework for registering, resolving, executing, and validating skills within the esports team training and coordination coaching harness. This document explains the complete skill lifecycle, from registration to execution and quality enforcement.

---

Skill Registration

Registration Schema

Skills are registered in references/schemas/skill-registry-instance.json following the JSON Schema defined in skill-registry.json. Each skill must include:

• name: Unique identifier (e.g., sub-gather-requirements)
• description: When to trigger and what the skill does
• step: Execution order (1-6)
• file: Path to skill markdown file
• role: Persona adopted by the skill
• inputs: JSON Schema for expected inputs
• outputs: JSON Schema for outputs
• tools: Tools the skill may invoke
• quality_gate: Validation criterion
• degradation_level: Impact level (0-4) if skill fails

Registration Process

1. Define Skill: Create markdown file in skills/ directory
2. Add to Registry: Add entry to skill-registry-instance.json
3. Validate Schema: Run python tools/validate_registry.py
4. Test Execution: Use test scenarios to verify execution

{
  "name": "new-skill-name",
  "description": "Clear description of when to trigger",
  "step": 3,
  "file": "sub-new-skill.md",
  "role": "expert persona description",
  "inputs": {
    "type": "object",
    "required": ["field1"],
    "properties": {
      "field1": {"type": "string"}
    }
  },
  "outputs": {
    "type": "object",
    "properties": {
      "result": {"type": "string"}
    }
  },
  "tools": ["WebSearch", "Read"],
  "quality_gate": "Validation criterion",
  "degradation_level": 2
}

---

Skill Resolution

Resolution Algorithm

When a skill is invoked, the harness uses the following resolution process: