tool-discovery

by @0xDarkMatter in AI & LLM

# Install this skill:

npx skills add 0xDarkMatter/claude-mods --skill "tool-discovery"

Install specific skill from multi-skill repository

# Description

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.

# SKILL.md

name: tool-discovery
description: "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."
allowed-tools: "Read Glob"
depends-on: []
related-skills: [claude-code-templates, claude-code-debug]

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

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.