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.
91
87%
Does it follow best practices?
Impact
100%
5.26xAverage score across 3 eval scenarios
Passed
No known issues
Quality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a solid description with strong trigger terms and clear completeness. Its main weakness is that the 'what' portion could be more specific about the concrete actions performed (e.g., comparing agents, explaining tradeoffs, listing available tools). The explicit trigger clause and distinct meta-skill niche are notable strengths.
Suggestions
Add more specific concrete actions beyond 'recommend', such as 'compare agent capabilities, explain tradeoffs between Task and Skill tools, list available tools for a given domain'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (recommending agents and skills) and distinguishes between heavyweight agents (Task tool) and lightweight skills (Skill tool), but doesn't list multiple concrete actions beyond 'recommend'. It lacks specifics like 'compare capabilities', 'explain tradeoffs', or 'suggest configurations'. | 2 / 3 |
Completeness | Clearly answers both 'what' (recommend the right agents and skills, covering Task tool and Skill tool) and 'when' (explicit 'Triggers on:' clause with multiple trigger phrases). The trigger guidance is explicit and well-structured. | 3 / 3 |
Trigger Term Quality | Includes a good set of natural trigger phrases: 'which agent', 'which skill', 'what tool should I use', 'help me choose', 'recommend agent', 'find the right tool'. These closely match what users would naturally say when seeking guidance on tool/agent selection. | 3 / 3 |
Distinctiveness Conflict Risk | This is a meta-skill about recommending other tools/agents, which is a clear and distinct niche. The trigger terms are specific to tool/agent selection and unlikely to conflict with the actual domain-specific skills it recommends. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted discovery/recommendation skill that efficiently uses tables and a decision flowchart to guide tool selection. It's concise, well-organized with progressive disclosure, and covers the key decision points. The only weakness is that the 'How to Launch' examples are slightly schematic rather than fully concrete invocations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section is lean and purposeful. No unnecessary explanations of what agents or skills are conceptually—jumps straight to decision criteria and lookup tables. The ASCII flowchart is minimal yet effective. | 3 / 3 |
Actionability | The tables and flowchart provide concrete guidance for choosing tools, and the 'How to Launch' section shows invocation syntax. However, the launch examples are somewhat schematic rather than fully executable (e.g., 'Skill tool → skill: "file-search"' is not a real command), and the matching table is helpful but limited. | 2 / 3 |
Workflow Clarity | For a recommendation/lookup skill, the workflow is clear: decision flowchart → identify tool type → match via tables → launch. This is a single-purpose skill where the decision tree and match tables provide an unambiguous sequence. No destructive operations require validation checkpoints. | 3 / 3 |
Progressive Disclosure | The skill provides a concise overview with quick-reference tables inline, then clearly points to one-level-deep references (agents-catalog.md and skills-catalog.md) for complete details. Well-structured navigation. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- Repository
- NeverSight/skills_feed
- Commit
f772de4
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.