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-ops	git, gh, lazygit, delta, commit, PR, release, rebase
python-env	uv, venv, pyproject
go-ops	golang, go, goroutine, channel, context, errgroup, go test
rust-ops	rust, cargo, ownership, tokio, serde, trait, Result, Option
typescript-ops	typescript, type system, generics, utility types, Zod
docker-ops	docker, Dockerfile, docker-compose, multi-stage build
ci-cd-ops	github actions, CI, CD, pipeline, release, workflow
api-design-ops	api design, gRPC, GraphQL, REST advanced, protobuf
rest-ops	http methods, status codes
sql-ops	cte, window functions
postgres-ops	postgresql, postgres, EXPLAIN ANALYZE, vacuum, pgbouncer, JSONB, RLS, replication
sqlite-ops	sqlite, EXPLAIN QUERY PLAN, covering index, rows_read, D1, wrangler d1, node:sqlite, better-sqlite3, bun:sqlite, aiosqlite, libsql, fts5
tailwind-ops	tailwind, tw classes, dark mode, responsive
mcp-ops	mcp server, fastmcp, tool handler, transport
react-ops	react, hooks, useState, next.js, RSC, zustand
vue-ops	vue, composition api, pinia, nuxt, script setup
javascript-ops	javascript, node, esm, async/await, event loop
astro-ops	astro, islands, content collections, partial hydration
laravel-ops	laravel, eloquent, artisan, sanctum, pest
payloadcms-ops	payload, payload cms, headless cms, collections
craftcms-ops	craft, craftcms, twig, matrix fields
asus-router-ops	asus router, asuswrt, merlin, network hardening
nginx-ops	nginx, reverse proxy, ssl, load balancer, proxy_pass
cloudflare-ops	cloudflare, workers, KV, D1, R2, pages, wrangler, edge
cypress-ops	cypress, e2e, component testing, custom commands, stubbing
bash-ops	bash, shell scripting, traps, CI scripts, defensive scripting
claude-code-ops	claude code extensions, skills, agents, hooks, MCP, plugins
auth-ops	jwt, oauth2, session, rbac, passkey, mfa, login
monitoring-ops	prometheus, grafana, opentelemetry, SLO, alerting
debug-ops	debug, crash, memory leak, race condition, bisect
perf-ops	performance, profiling, flamegraph, bundle size, load test, benchmark
migrate-ops	migrate, upgrade, breaking changes, codemod, version upgrade
refactor-ops	refactor, extract, code smell, dead code, rename, restructure
scaffold	scaffold, boilerplate, project template, init project, new project
log-ops	JSONL, log analysis, parse logs, lnav, log search, timeline

Quick Agent Reference

Agent	Triggers
firecrawl-expert	web scraping, crawling, anti-bot
project-organizer	restructure, organize, cleanup
git-agent	commit, push, PR (dispatched by git-ops)
Explore	"where is", "find"
Plan	design, architect

For Cloudflare/Workers, Cypress/E2E, shell scripting, Claude Code extension work, and CMS/device domains (Payload, Craft, Asus routers), use the matching -ops skill (cloudflare-ops, cypress-ops, bash-ops, claude-code-ops, payloadcms-ops, craftcms-ops, asus-router-ops). For language/framework work (Python, TypeScript, React, Postgres, etc.), use the matching -ops skill — or dispatch general-purpose with an instruction to read that skill's SKILL.md first.

How to Launch

Skills:

Skill tool → skill: "file-search"

Agents (the Agent tool was named Task before Claude Code 2.1.63; Task(...) still works as an alias):

Agent tool → subagent_type: "firecrawl-expert"
          → prompt: "Your task"

Match by Task Type

Task	Skill First	Agent If Needed
"How to write a CTE?"	sql-ops	—
"Optimize this query"	postgres-ops	—
"Find files named X"	file-search	Explore
"Set up Python project"	python-env	—
"What HTTP status for X?"	rest-ops	—
"React Server Components?"	react-ops	—
"Vue 3 composable pattern"	vue-ops	—
"Configure nginx SSL"	nginx-ops	—
"JWT vs session auth"	auth-ops	—
"Set up Prometheus"	monitoring-ops	—
"Debug memory leak"	debug-ops	—
"Scrape a blocked site"	jina-ops	firecrawl-expert

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 - Detail for a subset of skills, plus a selection guide (not the full list)