Skill Orchestrator

Orchestrator Skill

Central routing intelligence for the task management system.

Context Loading

Load context on-demand when needed:

• @.opencode/context/orchestration/orchestration-core.md - Routing, delegation, session tracking
• @.opencode/context/orchestration/state-management.md - Task lookup and status validation
• @.opencode/context/index.json - Full context discovery index

Trigger Conditions

This skill activates when:

• A slash command needs task-type-based routing
• Task context needs to be gathered before delegation
• Multi-step workflows require coordination

Core Responsibilities

1. Task Lookup

Given a task number, retrieve full context:

1. Read specs/state.json
2. Find task by project_number
3. Extract: task_type, status, project_name, description, priority
4. Read TODO.md for additional context if needed

2. Task-Type-Based Routing

Route to appropriate skill based on task type:

Note: Additional languages (latex, typst) are available via extensions in .opencode/extensions/.

3. Status Validation

Before routing, validate task status is not terminal:

if status in [completed, abandoned, expanded]:
  ABORT "Task is in terminal state [$status]"

All operations (research, plan, implement, revise) are allowed from any non-terminal status.

4. Context Preparation

Prepare context package for delegated skill:

{
  "task_number": 259,
  "task_name": "task_slug",
  "task_type": "general",
  "status": "planned",
  "description": "Full task description",
  "artifacts": {
    "research": ["path/to/research.md"],
    "plan": "path/to/plan.md"
  },
  "focus_prompt": "Optional user-provided focus"
}

Execution Flow

1. Receive command context (task number, operation type)
2. Lookup task in state.json
3. Validate status for operation
4. Determine target skill by task_type
5. Prepare context package
6. Invoke target skill via Task tool
7. Receive and validate result
8. Return result to caller

Return Format

{
  "status": "completed|partial|failed",
  "routed_to": "skill-name",
  "task_number": 259,
  "result": {
    "artifacts": [],
    "summary": "..."
  }
}

Error Handling

• Task not found: Return clear error with suggestions
• Invalid status: Return error with current status and allowed operations
• Skill invocation failure: Return partial result with error details

MUST NOT (Postflight Boundary)

After routing to a skill, this skill MUST NOT:

1. Edit source files - All work is done by routed skills/agents
2. Run build/test commands - Verification is done by routed skills/agents
3. Update task status - Status updates are done by routed skills
4. Create artifacts - Artifact creation is done by routed skills/agents

The orchestrator is a routing-only skill. It:

• Looks up task context
• Routes to appropriate skill based on task_type
• Passes through the routed skill's return

Reference: @.opencode/context/standards/postflight-tool-restrictions.md