# Work Item Router

> Force reading the canonical work-item governance index before routing specs, tickets, project boards, or publication flows.

- Skill: `quantumquirkxyz/work-item-router` (Agent Skill)
- Install (CLI): `npx skillmds@latest add quantumquirkxyz/work-item-router`
- Raw SKILL.md: https://api.skillmd.com/api/skills/quantumquirkxyz/work-item-router/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: quantumquirkxyz (https://skillmd.com/u/quantumquirkxyz)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/quantumquirkxyz/work-item-router

---


## Contract

- **Input:** problem or task defined by the skill body.
- **Output:** Markdown artifact or structured result with completion criteria met.
- **Side effects:** none (design/review/documentation only unless explicitly stated).
- **Dependencies:** none (self-contained unless linked to other skills).
- **Stop condition:** all process steps completed; artifact saved; criteria checked.
- **Risk:** low.
- **Boundary:** produces reasoning or documentation artifacts; does not modify external systems unless explicitly instructed.


This skill routes only. It does not create issues, tickets, PRs, or project items.

# Work Item Router

Use this skill before `to-spec`, `to-tickets`, or `make-project` when the task involves tracker metadata, project boards, or publication flow.

## Contract

- Input: a request involving specs, tickets, spec/ticket audits, projects, PR metadata, or review-fix comments.
- Output: a routing note that identifies the downstream skill and the relevant governance documents.
- Scope: routing only. Do not draft the artifact here.
- Rule: always read [`docs/agents/index.md`](../../../../docs/agents/index.md) first.
- Rule: prefer the canonical work-item format over ad hoc tracker metadata.

## Workflow

1. Read `docs/agents/index.md`.
2. Identify whether the request is a spec, ticket, spec completion audit, ticket coverage audit, corrective ticket publication, project board, PR publication, review-fix plan, or closeout.
3. Route to the thinnest downstream skill that can finish the work.
4. If metadata is involved, preserve the canonical shape from `docs/agents/work-item-format.md`.

## Completion criteria

- the governance index has been read
- the downstream skill is named
- any required metadata contract is explicit