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