Tool Discovery Skill | Agent Skills

Tool Discovery

Recommend the right agents and skills for any task.

Decision Flowchart

Is this a reference/lookup task?
├── YES → Use a SKILL (lightweight, auto-injects)
└── NO → Does it require reasoning/decisions?
         ├── YES → Use an AGENT (heavyweight, spawns subagent)
         └── MAYBE → Check catalogs below

Rule: Skills = patterns/reference. Agents = decisions/expertise.

Quick Skill Reference

| Skill | Triggers | |-------|----------| | file-search | fd, rg, fzf, find files | | find-replace | sd, batch replace | | code-stats | tokei, difft, line counts | | data-processing | jq, yq, json, yaml | | structural-search | ast-grep, sg, ast pattern | | git-workflow | lazygit, gh, delta, rebase | | python-env | uv, venv, pyproject | | rest-patterns | http methods, status codes | | sql-patterns | cte, window functions | | sqlite-ops | sqlite, aiosqlite | | tailwind-patterns | tailwind, tw classes | | mcp-patterns | mcp server, protocol |

Quick Agent Reference

| Agent | Triggers | |-------|----------| | python-expert | Python, async, pytest | | typescript-expert | TypeScript, types, generics | | react-expert | React, hooks, state | | postgres-expert | PostgreSQL, query optimization | | cloudflare-expert | Workers, KV, D1, R2 | | Explore | "where is", "find" | | Plan | design, architect |

How to Launch

Skills:

Skill tool → skill: "file-search"

Agents:

Task tool → subagent_type: "python-expert"
         → prompt: "Your task"

Match by Task Type

| Task | Skill First | Agent If Needed | |------|-------------|-----------------| | "How to write a CTE?" | sql-patterns | sql-expert | | "Optimize this query" | — | postgres-expert | | "Find files named X" | file-search | Explore | | "Set up Python project" | python-env | python-expert | | "What HTTP status for X?" | rest-patterns | — |

Tips

Skills are cheaper - Use for lookups, patterns
Agents are powerful - Use for decisions, optimization
Don't over-recommend - Max 2-3 tools per task

Additional Resources

For complete catalogs, load:

./references/agents-catalog.md - All agents with capabilities
./references/skills-catalog.md - All skills with details

Agent Skills: Tool Discovery

Skill Files