Intent Classifier

Classify user requests and route them to the most appropriate skill, command, or specialized agent.

When to Use

• User asks which skill to use or how to route a request
• Need to determine which skill handles a given task
• Multiple skills could handle a request and disambiguation is needed
• Even if they just say "which skill should I use" or "route this"

Classification Workflow

1. Intent Extraction

• Parse the user's natural language request
• Identify primary action (create, update, delete, analyze, etc.)
• Extract entities (file paths, technologies, specific terms)

2. Skill Matching

• Compare against available skills catalog
• Score match confidence for each candidate
• Consider skill descriptions and keywords

3. Route Decision

• Select highest-confidence match
• Handle ties and ambiguous cases
• Fall back to general assistance if no match

Classification Rules

Priority Order

1. Exact keyword match - Skill description contains exact phrase
2. Domain match - Technology stack alignment
3. Action match - Verb/action alignment
4. Context match - File paths, extensions, surrounding context

Confidence Scoring

High (0.8-1.0):   Exact description match, multiple keyword hits
Medium (0.5-0.7): Partial match, related domain
Low (0.3-0.4):    Weak match, shared keywords only
None (<0.3):      No relevant match

Multi-Intent Handling

When a request contains multiple intents:

1. Sequential - Chain skills in dependency order
2. Parallel - Execute independent skills simultaneously
3. Composite - Use parent skill that orchestrates sub-skills

Fallback Strategies

Dynamic Catalog

Update the skill catalog using:

./scripts/generate-skill-catalog.sh

This scans .agents/skills/ and regenerates the skill registry with:

• Skill names and full descriptions (1024-char budget, Not for guards retained)
• Categories, with a per-category index

Regenerate after adding, renaming, or removing a skill. The previous dynamic-catalog.sh entry point is a deprecated shim that delegates here.

Skill Selection Examples

See Also

• skill-creator — Create and improve skills
• skill-evaluator — Evaluate and score skills
• goap-agent — Orchestrator for complex multi-step tasks

Rationalizations

Red Flags

• Routing to a skill without checking confidence score
• Ignoring multi-intent requests that require chaining skills
• Failing to update the dynamic catalog after adding new skills

References

• references/classification-rules.md - Detailed classification algorithm
• references/skill-catalog.md - Auto-generated skill registry
• references/workflow-patterns.md - Multi-skill orchestration patterns

Voice & Context

• Default: professional + blog
• Reference: voice-profiles skill for definitions and auto-detection.