SKILL.md
Tool Finder
This skill is coordination-exempt: skip the ai-coord gate for its declared work.
Recommend the current option that best fits the user's actual constraints, backed by fresh primary evidence.
Workflow
- Infer the ecosystem, existing stack, must-haves, switching cost, and decision criteria from the request and
repository. Ask only when an unknown would materially change the recommendation.
- Check whether the standard library, platform, or an already-installed tool is sufficient before adding a dependency.
- Search current authoritative sources. Read [references/tool-finder.md](references/tool-finder.md) only for the
relevant ecosystem's source routing, fallback criteria, install conventions, and red flags.
- Compare the viable options against the user's criteria. Use adoption, maintenance, security, documentation,
performance, operational cost, and ecosystem fit only where they affect this decision; do not force fixed weights or a fixed number of candidates.
- Recommend one option when the evidence supports it. State the decisive tradeoff, material red flags, and the closest
alternative. Say when the evidence is too close or no external tool is justified.
Defaults
- With no repository evidence, default to JavaScript/TypeScript and Node.js tooling.
- For JavaScript installs, prefer the repository's package manager and otherwise
ni; for macOS CLIs, prefer an
official or well-maintained Homebrew formula.
- Prefer registries, official docs, repositories, changelogs, and security advisories over secondary comparisons. For
agent skills, search registries and GitHub because no single index is complete.
Completion
The answer is complete when the recommendation is traceable to current sources, the deciding criteria are explicit, installation guidance matches the user's environment, and uncertainties or disqualifying risks are visible. Use a table only when repeated fields make the comparison easier to scan.
Lead with ### 🏆 Pick: <tool> and the decisive reason. Follow with ### 📦 Install and the exact command, a compact criteria/evidence table only when fields repeat, ### 🥈 Closest alternative only for a credible material runner-up, and ### ⚠️ Caveats only when material. Use symbols in comparison cells only with text; never manufacture scores. Keep URL targets exact and use descriptive Markdown links for human output. Keep install commands, versions, security advisories, and installer-risk wording exact and undecorated.