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
1---2name: tool-discovery3description: Recommend the right agents and skills for any task. Covers both heavyweight agents (Task tool) and lightweight skills (Skill tool). Triggers on: which agent, which skill, what tool should I use, help me choose, recommend agent, find the right tool.4---56# Tool Discovery78Recommend the right agents and skills for any task.910## Decision Flowchart1112```13Is this a reference/lookup task?14├── YES → Use a SKILL (lightweight, auto-injects)15└── NO → Does it require reasoning/decisions?16 ├── YES → Use an AGENT (heavyweight, spawns subagent)17 └── MAYBE → Check catalogs below18```1920**Rule:** Skills = patterns/reference. Agents = decisions/expertise.2122## Quick Skill Reference2324| Skill | Triggers |25|-------|----------|26| **file-search** | fd, rg, fzf, find files |27| **find-replace** | sd, batch replace |28| **code-stats** | tokei, difft, line counts |29| **data-processing** | jq, yq, json, yaml |30| **structural-search** | ast-grep, sg, ast pattern |31| **git-workflow** | lazygit, gh, delta, rebase |32| **python-env** | uv, venv, pyproject |33| **rest-patterns** | http methods, status codes |34| **sql-patterns** | cte, window functions |35| **sqlite-ops** | sqlite, aiosqlite |36| **tailwind-patterns** | tailwind, tw classes |37| **mcp-patterns** | mcp server, protocol |3839## Quick Agent Reference4041| Agent | Triggers |42|-------|----------|43| **python-expert** | Python, async, pytest |44| **typescript-expert** | TypeScript, types, generics |45| **react-expert** | React, hooks, state |46| **postgres-expert** | PostgreSQL, query optimization |47| **cloudflare-expert** | Workers, KV, D1, R2 |48| **Explore** | "where is", "find" |49| **Plan** | design, architect |5051## How to Launch5253**Skills:**54```55Skill tool → skill: "file-search"56```5758**Agents:**59```60Task tool → subagent_type: "python-expert"61 → prompt: "Your task"62```6364## Match by Task Type6566| Task | Skill First | Agent If Needed |67|------|-------------|-----------------|68| "How to write a CTE?" | sql-patterns | sql-expert |69| "Optimize this query" | — | postgres-expert |70| "Find files named X" | file-search | Explore |71| "Set up Python project" | python-env | python-expert |72| "What HTTP status for X?" | rest-patterns | — |7374## Tips7576- **Skills are cheaper** - Use for lookups, patterns77- **Agents are powerful** - Use for decisions, optimization78- **Don't over-recommend** - Max 2-3 tools per task7980## Additional Resources8182For complete catalogs, load:83- `./references/agents-catalog.md` - All agents with capabilities84- `./references/skills-catalog.md` - All skills with details
ComeOnOliver