speckit-agent-assign

Assemble task-to-agent rosters and dispatch skill-builder sessions for unmatched tasks.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-agent-assign-narenkarthikbm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-agent-assign
Source: https://github.com/NarenKarthikBM/specseyal/tree/main/.claude/skills/speckit-agent-assign
Command: npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-agent-assign-narenkarthikbm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After tasks are categorized in a spec-driven development pipeline, someone must match every task to a specialized agent and skill set — and decide what to do when no existing skill covers a task. This Skill automates that matching deterministically, verifies the categorization is still fresh against tasks.md, and orchestrates the creation of new skills to close coverage gaps before implementation begins. ## Core Features & Use Cases - Deterministic roster assembly: Runs assemble.py over categorization.md and the .claude/agents + .claude/skills library to write the assignment.md roster table, with a hard freshness check (S14) that blocks stale categorizations. - Gap handoff with skill-builder dispatch: On unmatched tasks, dispatches one Sonnet skill-builder session per shared-tag cluster, validates candidates with validate-skill.py, persists passing skills to .claude/skills/, and re-runs assembly so the final roster carries built marks. - Workforce gate integration: Honors the D67 elevated-grant tripwire and the workforce_depth: light profile mode, which short-circuits gap-filling while still writing the roster. - Use Case: After running /speckit-categorize on a feature, invoke this Skill to produce a signed-ready agent roster; if three tasks share an uncovered tag, one new skill is built, validated, persisted, and reflected in the final assignment. ## Quick Start Run /speckit-agent-assign in the repository after /speckit-categorize has produced categorization.md to generate the agent assignment roster and fill any skill gaps.

Frequently Asked Questions about speckit-agent-assign

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I assign categorized tasks to agents in a spec-driven pipeline?

Run /speckit-agent-assign after /speckit-categorize. It invokes assemble.py to match every task in categorization.md to a base specialist plus up to three ranked skills, writing the roster table into agents/assignment.md deterministically.

What happens when no skill matches a task during agent assignment?

Unmatched tasks appear in the GAP_TASKS output, clustered by shared tags. One Sonnet skill-builder session is dispatched per cluster, its candidate validated with validate-skill.py, and passing skills persisted to .claude/skills/ before assemble.py re-runs.

Why does agent assignment stop with a tasks.md freshness error?

The Skill compares the tasks.md commit SHA recorded in categorization.md against the current git SHA and checks for uncommitted changes. Any mismatch or drift triggers a hard stop requiring you to re-run /speckit-categorize first.

Can I re-run agent assignment after the workforce gate is signed?

Only if the gate decision is rejected. An approved or approved-with-notes decision causes the Skill to stop, because assemble.py re-renders the entire assignment.md and would silently destroy the recorded human decision.

What does workforce_depth light mode change in agent assignment?

Light mode skips the entire gap-handoff loop — no skill-builder dispatches, validation, or re-run — regardless of the gap list. The roster is still written via the same assemble.py invocation, and the grant tripwire still applies.