agentleFS
PracticalSwanPracticalSwan/agent-skills/agent-task-mapping/SKILL.md

agent-task-mapping

Skill22 starsChanged 24 days agoMITView on GitHub

Map tasks to specialist agents. Use when choosing which agent for a job, comparing agent capabilities, or routing to React/Next.js/Playwright/docs/code-quality experts. Keywords: which agent, best agent for this, delegate to expert, agent capability mapping.

The file

Show its rules and text

We split this skill into the rules it gives an agent

19 rules. About 0 are common, 18 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈18

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use symptom -> action triggers: when one matches, apply this skill and verify with the protocol below.

    line 15
  2. Distinctive:

    Use this skill when:

    line 17
  3. Distinctive:

    When to use each agent

    line 27
  4. Distinctive:

    Do not claim an MCP operation was used when the active host does not expose it.

    line 50
  5. Distinctive:

    Treat local files, tests, rendered outputs, logs, or screenshots as the fallback evidence path.

    line 51
  6. Distinctive:

    Before claiming "skill applied successfully":

    line 63
  7. Distinctive:

    When choosing an agent for delegation:

    line 94
  8. Distinctive:

    Check availability: Verify agent exists and has proper frontmatter configuration

    line 98
  9. Distinctive:

    Use Code Explainer for analyzing existing code patterns

    line 104
  10. Distinctive:

    Use Tech Writer for formal developer documentation

    line 105
  11. Distinctive:

    Use Specification for generating feature specifications

    line 106
  12. Distinctive:

    Use Universal Janitor for cleanup and tech debt remediation

    line 109
  13. Distinctive:

    Use Critical Thinking for challenging assumptions

    line 110
  14. Very specific:

    Use Next.js Expert for Next.js 15/16+ architecture and optimizations

    line 113
  15. Distinctive:

    Use Expert React Frontend Engineer for React 19+ patterns

    line 114
  16. Distinctive:

    Use Playwright Tester Mode for comprehensive web application testing

    line 117
  17. Distinctive:

    Use Plan for research and outlining multi-step plans

    line 120
  18. Distinctive:

    Use Create PRD Chat Mode for generating Product Requirements Documents

    line 121
  19. Distinctive:

    Use UI Designer for UI/UX improvements and design implementations

    line 124

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Agent Task Mapping

  • Leverage native parallel subagent dispatch and 200k+ context windows where available.

Activation Conditions

Use symptom -> action triggers: when one matches, apply this skill and verify with the protocol below.

Use this skill when:

  • Determining which specialized agent to delegate a task to
  • Reviewing agent capabilities and expertise areas
  • Trying to match a specific task to an appropriate specialist
  • Needing quick reference for available agents and their purposes

Available Agents

See Agent Details for comprehensive information about each agent:

  • Description and specialization areas
  • When to use each agent
  • Typical tasks handled by each
<!-- MCP:START --><!-- PORTABILITY:START -->

Cross-Client Portability

This skill is written to stay usable across GitHub Copilot, Claude Code, and Codex.

  • GitHub Copilot: keep the folder in a Copilot-visible skill path or wrap the workflow in project instructions when folder discovery is unavailable.
  • Claude Code: keep the folder in a local skills directory or a compatible plugin source.
  • Codex: install or sync the folder into $CODEX_HOME/skills/agent-task-mapping and restart Codex after major changes.
<!-- PORTABILITY:END -->

MCP Availability And Fallback

Preferred MCP Server: None required

  • Fallback prompt: "Use the Agent Task Mapping skill without MCP. Rely on its local instructions, bundled resources, standard shell or editor tools, and direct verification. Show the evidence used before concluding."
  • Do not claim an MCP operation was used when the active host does not expose it.
  • Treat local files, tests, rendered outputs, logs, or screenshots as the fallback evidence path.
<!-- MCP:END -->

Anti-Patterns

  • Delegating or evaluating without a scoped success condition: The output becomes hard to review and easy to overbuild.
  • Skipping the evidence step: A workflow that cannot be re-checked quickly is not ready for handoff.
  • Bundling unrelated subtasks together: It creates noisy prompts, weaker ownership, and avoidable integration risk.

Verification Protocol

Before claiming "skill applied successfully":

  1. Pass/fail: The Agent Task Mapping workflow names the agent boundary, delegated scope, and expected return artifact.
  2. Pass/fail: Context passed to helpers is minimal, task-local, and free of hidden expected answers.
  3. Pass/fail: Results are integrated only after evidence, diffs, or citations are checked by the controller.
  4. Pressure-test scenario: Run the workflow on two similar tasks that must not share assumptions or leaked context.
  5. Success metric: Zero context leakage; every delegated output is independently reviewable.

Examples & Scripts

  • Delegation Examples — Code examples for delegating to different agents
  • Agent Discovery Script — Node.js script to discover available agents

Quick Reference

Agent NameBest For
Code ExplainerAnalyzing and documenting existing code
UI DesignerUI/UX improvements and design implementations
Universal JanitorCode cleanup, simplification, and tech debt removal
Critical ThinkingChallenging assumptions and exploring alternatives
Next.js ExpertNext.js 15/16+ architecture and optimizations
Expert React Frontend EngineerReact 19+ patterns and best practices
Playwright Tester ModeComprehensive testing with exploratory testing
Tech WriterCreating formal developer documentation
Create PRD Chat ModeGenerating Product Requirements Documents
SpecificationGenerating or updating specification documents
PlanResearch and outlining multi-step plans

Decision Framework

When choosing an agent for delegation:

  1. Identify task type: Is it documentation, testing, two-stage review (spec compliance first, then code quality), or development?
  2. Match to specialization: Find agent whose description aligns with task
  3. Check availability: Verify agent exists and has proper frontmatter configuration
  4. Use specific agentName: Delegate using exact name from agent's frontmatter

Task Categories

Code Analysis & Documentation

  • Use Code Explainer for analyzing existing code patterns
  • Use Tech Writer for formal developer documentation
  • Use Specification for generating feature specifications

Code Quality & Maintenance

  • Use Universal Janitor for cleanup and tech debt remediation
  • Use Critical Thinking for challenging assumptions

Development Work

  • Use Next.js Expert for Next.js 15/16+ architecture and optimizations
  • Use Expert React Frontend Engineer for React 19+ patterns

Testing

  • Use Playwright Tester Mode for comprehensive web application testing

Planning & Requirements

  • Use Plan for research and outlining multi-step plans
  • Use Create PRD Chat Mode for generating Product Requirements Documents

Design

  • Use UI Designer for UI/UX improvements and design implementations

Related Skills

  • custom-agent-usage: Use it when the workflow also needs loading and invoking custom agent definitions safely.
  • subagent-delegation: Use it when the workflow also needs safe, scoped delegation to helper agents.
  • subagent-driven-development: Use it when the workflow also needs plan-driven implementation with reviewer loops.
  • agentic-eval: Use it when the workflow also needs rubric-driven evaluation loops.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.