Tool discovery

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