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.
Install
npx skills add https://github.com/0xDarkMatter/claude-mods/tree/main/skills/tool-discovery
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install 0xdarkmatter-claude-mods@llmmart
git clone https://github.com/0xDarkMatter/claude-mods.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole 0xdarkmatter/claude-mods collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
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 |
| shadcn-ops | shadcn/ui, components.json, shadcn add, registries, admin dashboard, data table |
| 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)
Files (claude-mods)
-
assets
-
.gitkeep 0 B · in bundle
-
-
references
-
agents-catalog.md 4.4 KB
Loading… -
skills-catalog.md 19.4 KB
Loading…
-
-
scripts
-
.gitkeep 0 B · in bundle
-
-
reference.md 5.8 KB
Loading… -
SKILL.md 5.8 KB
--- name: tool-discovery description: "Recommend the right agents (Agent tool) and skills (Skill tool) for any task. Triggers on: which agent, which skill, what tool should I use, help me choose, recommend agent, find the right tool." license: MIT allowed-tools: "Read Glob" metadata: author: claude-mods related-skills: claude-code-ops --- # 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 | | **shadcn-ops** | shadcn/ui, components.json, shadcn add, registries, admin dashboard, data table | | **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)
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.