agent-selector

Route user prompts to specialized agents using priority-ordered keyword matching.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/MacroMan5/claude-code-workflow-plugins --skill agent-selector-macroman5
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-selector
Source: https://github.com/MacroMan5/claude-code-workflow-plugins/tree/main/.claude/skills/agent-selector
Command: npx skills add https://github.com/MacroMan5/claude-code-workflow-plugins --skill agent-selector-macroman5

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically routes prompts to the most appropriate specialized agent (tester, researcher, reviewer, refactor, documentation, etc.) based on user prompt keywords and task type, reducing misrouting and speeding results.

Core Features & Use Cases

  • Dynamic routing: Determines the best agent (tester, researcher, reviewer, refactor, documentation, or coder) based on prompt keywords and context.
  • Context-aware decisions: Considers task type and surrounding context to improve outcomes.
  • Use Case: You ask for "write unit tests for auth module" and the Skill routes to the tester; "explain OAuth2" routes to the researcher.

Quick Start

Provide a prompt like: "Please write unit tests for the payment module."

Frequently Asked Questions about agent-selector

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

FAQPage Schema
How do I automatically route coding tasks to the right specialist?

Agent selector routes prompts to specialized agents based on keywords and task type. Provide a prompt like 'write unit tests for auth module' and it automatically selects the tester agent; 'refactor payment logic' routes to the refactor agent, speeding task execution.

What task types does agent selection support?

Agent selector routes seven task categories: testing, research, code review, refactoring, documentation, cleanup, and feature implementation. Each maps to a specialized agent optimized for that specific work type.

How does prompt keyword matching improve task routing accuracy?

Agent selector uses priority-ordered keyword matching to parse user prompts and identify intent. Keywords like 'test,' 'review,' 'document,' and 'refactor' trigger routing to the corresponding agent, reducing misrouting and ensuring faster, more accurate task completion.

Can agent selection handle multiple task types in one prompt?

Agent selector analyzes prompt context and keywords to identify the primary task type, then routes to the best-fit agent. For mixed requests, the priority-ordered matching mechanism selects the dominant task type to route appropriately.

What happens if a prompt doesn't match standard task keywords?

Agent selector falls back to context analysis and task type inference. If no clear keyword match exists, it evaluates surrounding prompt context to determine the closest agent fit, ensuring routing even for ambiguous or novel requests.