task-router

Generate task briefs from a GSD plan and route them to external models.

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/gerardloupecyb/claude-code-project-template --skill task-router-gerardloupecyb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-router
Source: https://github.com/gerardloupecyb/claude-code-project-template/tree/main/.claude/skills/task-router
Command: npx skills add https://github.com/gerardloupecyb/claude-code-project-template --skill task-router-gerardloupecyb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Pre-routes tasks from a GSD planning workflow to the appropriate execution model and automatically prepares structured context briefs for external executors (e.g., Codex or VS Code-based agents). This packaging-only skill delegates actual review and retry governance to the model-routing rules.

Core Features & Use Cases

  • Generates .task-briefs/ documents for each external task derived from a GSD plan.
  • Classifies tasks by routing rules to decide between opus (direct execution) or external delegation.
  • Accepts an active plan from .planning/ or a specific plan path as input to pre-generate briefs.

Quick Start

Trigger the skill with /task-router to pre-generate all briefs from your active GSD plan.

Frequently Asked Questions about task-router

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

FAQPage Schema
How do I generate context briefs for Codex from a GSD plan?

To generate context briefs for Codex from a GSD plan, trigger the task-router skill to automatically package and route tasks from your active plan in .planning/ into structured .task-briefs/ documents for external executors.

What is task routing in software engineering planning workflows?

Task routing in software engineering planning workflows is the process of classifying tasks from a GSD plan to decide between direct execution or external delegation, automatically preparing structured context briefs for external agents like Codex.

How do I route tasks to external model executors from a planning directory?

You route tasks to external model executors by applying routing logic defined in .claude/rules/model-routing.md, which classifies tasks from your active plan and generates structured handoff briefs for external execution.

Can I use task-router to delegate work to external agents like VS Code-based executors?

Yes, you can use task-router to delegate work to external agents like VS Code-based executors by pre-generating structured context briefs from your active GSD plan, though actual review and retry governance are managed by model-routing rules.

Do I need a specific plan path to pre-generate task briefs?

You do not need a specific plan path to pre-generate task briefs; the skill accepts an active plan from the .planning/ directory by default, but you can also provide a specific plan path as input.

What are the limitations of using automated task routing for external executors?

A limitation of automated task routing is that it is a packaging-only skill; it pre-routes tasks and generates briefs but delegates actual review and retry governance to the model-routing rules rather than handling execution directly.