tool-discovery
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.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
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
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-28
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!