Skill Router

<!-- PROACTIVE SKILL INVOCATION: Claude MUST use the Skill tool to invoke matched skills -->

CRITICAL: Automatic Skill Invocation

When this skill is loaded, Claude MUST immediately:

1. Analyze the user's request using the routing patterns below
2. Invoke the matched skill using: Skill(skill-name)
3. Chain additional skills as required by quality gates

DO NOT just document which skill to use - INVOKE IT with the Skill tool.

Quick Reference - Invoke These Skills:

Mandatory Chaining

After ANY skill completes work that modifies code:

→ Skill(qa-testing) MUST be invoked before claiming success

Skill Router

Overview

The Skill Router is an intelligent system that automatically selects the most appropriate skill based on user input, project context, and established quality requirements. It eliminates the need to manually choose from 27+ specialized skills while enforcing mandatory quality gates.

Core Features

1. Pattern-Based Routing

• Matches user intent using regex patterns
• Context-aware skill selection
• Automatic workflow chaining

2. Mandatory Quality Gates

• Testing Required: Routes to qa-testing for feature validation
• Verification Required: Routes to qa-verify before success claims
• Audit Required: Routes to qa-audit-ui-ux for UI changes

3. User Override System

• Explicit skill selection when needed
• Bypass routing for specific scenarios
• Learning system for improvement

Routing Configuration

Pattern Matching Rules

const ROUTING_PATTERNS = {
  // Testing & Quality Assurance
  'test.*': 'qa-testing',
  'verify.*': 'qa-verify',
  'claim.*works': 'qa-verify',
  'validate.*': 'qa-testing',
  'deploy.*': 'qa-testing',

  // Debugging & Fixes
  'fix.*bug': 'comprehensive-debugging',
  'debug.*': 'comprehensive-debugging',
  'broken.*': 'comprehensive-debugging',
  'error.*': 'comprehensive-debugging',
  'issue.*': 'comprehensive-debugging',

  // Performance
  'performance.*': 'dev-optimize-performance',
  'slow.*': 'dev-optimize-performance',
  'optimize.*': 'dev-optimize-performance',
  'speed.*': 'dev-optimize-performance',

  // Vue Development
  'vue.*component': 'dev-vue',
  'component.*': 'dev-vue',
  'reactive.*': 'dev-vue',
  'composable.*': 'dev-vue',

  // State Management
  'pinia.*': 'dev-pinia-state',
  'store.*': 'dev-pinia-state',
  'state.*': 'dev-pinia-state',

  // Canvas & UI
  'canvas.*': 'calendar-canvas-integration',
  'drag.*drop': 'calendar-canvas-integration',
  'ui.*consistency': 'qa-audit-ui-ux',
  'design.*system': 'qa-audit-ui-ux',

  // Undo/​Redo System
  'undo.*redo': 'dev-undo-redo',
  'history.*': 'dev-undo-redo',
  'state.*sync': 'dev-undo-redo',

  // Timer Functionality
  'timer.*': 'fix-timer-bugs',
  'pomodoro.*': 'fix-timer-bugs',
  'session.*': 'fix-timer-bugs',

  // Task Management
  'task.*store': 'fix-task-store',
  'task.*creation': 'fix-task-store',
  'task.*management': 'fix-task-store',

  // Keyboard & Accessibility (routed to dev-debugging)
  'keyboard.*': 'dev-debugging',
  'shortcut.*': 'dev-debugging',
  'accessibility.*': 'dev-debugging',

  // Port Management
  'port.*': 'ops-port-manager',
  'server.*': 'ops-port-manager',
  'localhost.*': 'ops-port-manager',

  // Planning & Architecture
  'plan.*': 'chief-architect',
  'architecture.*': 'chief-architect',
  'refactor.*': 'chief-architect',
  'roadmap.*': 'chief-architect'
}

Mandatory Quality Gates

const MANDATORY_ROUTES = {
  // Before claiming success
  'claim.*works': ['qa-testing', 'qa-verify'],
  'ready.*production': ['qa-testing', 'qa-verify'],
  'done.*': ['qa-testing', 'qa-verify'],
  'finished.*': ['qa-testing', 'qa-verify'],

  // Before deployment
  'deploy.*': ['qa-testing', 'qa-verify'],
  'merge.*': ['qa-testing', 'qa-verify'],
  'release.*': ['qa-testing', 'qa-verify'],

  // After feature changes
  'feature.*': ['qa-testing'],
  'implement.*': ['qa-testing'],
  'add.*feature': ['qa-testing']
}

Usage Examples

Example 1: Feature Development Workflow

User: "I need to add drag and drop for tasks"
Router:
1. Route to 'dev-vue' (component implementation)
2. Auto-route to 'calendar-canvas-integration' (drag/​drop logic)
3. Force route to 'qa-testing' (validation)
4. Auto-route to 'qa-verify' (quality gate)

Example 2: Bug Fix Workflow

User: "The timer isn't working correctly"
Router:
1. Route to 'fix-timer-bugs' (domain-specific debugging)
2. Auto-route to 'qa-testing' (validation)
3. Auto-route to 'qa-verify' (quality gate)

Example 3: Performance Optimization

User: "The app is running slow"
Router:
1. Route to 'dev-optimize-performance' (performance analysis)
2. Route to 'comprehensive-debugging' (if needed)
3. Force route to 'qa-testing' (validation)

⚡ Action: Route Request

To determine the best skill for a task, ALWAYS run:

node .claude/​skills/​meta-skill-router/​router.js "YOUR_QUERY_HERE"

Then, invoke the skill returned by the router.

Example

User: "Fix the timer bug" Agent:

1. Run node .claude/​skills/​meta-skill-router/​router.js "fix timer bug"
2. Output: dev-bug-fixer
3. Agent invokes dev-bug-fixer skill.s

Configuration

Custom Routing Rules

Add project-specific patterns to .claude/​skill-router/​config.json:

{
  "customPatterns": {
    "custom.*feature": "custom-skill-name",
    "specific.*bug": "specific-debug-skill"
  },
  "mandatoryGates": {
    "critical.*feature": ["testing", "security-review", "code-review"]
  },
  "userOverrides": {
    "allowExplicitSelection": true,
    "rememberPreferences": true
  }
}

Skill Metadata

Each skill can provide routing metadata:

---
name: qa-testing
description: Validate application functionality
routing:
  patterns:
    - 'test.*'
    - 'validate.*'
    - 'verify.*'
  mandatoryFor:
    - 'feature.*'
    - 'bug.*fix'
    - 'deploy.*'
  priority: 10
  context: ['vue', 'component', 'feature']
---

Implementation Details

Router Architecture

User Input → Intent Analysis → Pattern Matching → Quality Gates → Skill Selection
     ↓              ↓                ↓                ↓              ↓
Context Analysis  → Scoring System  → Chain Builder → Override Check → Execution

Error Handling

• Fallback to general-purpose debugging skill
• Request clarification for ambiguous requests
• Provide skill suggestions when routing fails

Performance Considerations

• Cache pattern matching results
• Lazy load skill metadata
• Optimize for common routing patterns

Benefits

1. Improved Development Velocity

• No need to remember all skill names
• Automatic quality gate enforcement
• Consistent workflow across team

2. Quality Assurance

• Mandatory testing for all changes
• Verification before claiming success
• Consistent application of best practices

3. Reduced Cognitive Load

• Natural language skill selection
• Automatic workflow chaining
• Clear guidance on next steps

4. Scalability

• Easy to add new skills and patterns
• Adaptive routing based on usage
• Project-specific customization

Troubleshooting

Common Issues

• Router selects wrong skill: Check pattern priority and specificity
• Mandatory gates not firing: Verify pattern matching for gate triggers
• User override not working: Ensure override syntax is correct

Debug Mode

Enable routing diagnostics with ROUTER_DEBUG=true environment variable to see:

• Pattern matching scores
• Routing decision process
• Quality gate application

Future Enhancements

1. Machine Learning Integration

• Learn from user routing corrections
• Improve pattern matching based on usage
• Predict skill needs based on context

2. Advanced Context Analysis

• Git integration for change-based routing
• File system analysis for context awareness
• Team workflow integration

3. Custom Router Creation

• Project-specific router templates
• Team-based routing configurations
• Integration with external tools

---

The Skill Router transforms the development experience by making skill selection intelligent, automatic, and consistent while maintaining the flexibility for expert users to override when needed.