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.

5.26x

Quality

83%

Does it follow best practices?

Impact

100%

5.26x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Quality

Content

77%

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-structured, concise routing/recommendation skill that efficiently uses tables and a decision flowchart to guide tool selection. Its main strengths are token efficiency and clear workflow logic. The primary weaknesses are slightly schematic launch examples that could be more concrete, and references to external catalog files that aren't provided in the bundle.

Suggestions

Make the 'How to Launch' examples more concrete with realistic task descriptions and expected outputs, e.g., a complete Task tool invocation with an actual prompt string.

Include the referenced bundle files (agents-catalog.md, skills-catalog.md) or remove the references if they don't exist.

Dimension	Reasoning	Score
Conciseness	Every section is lean and purposeful. The decision flowchart, tables, and launch examples are all compact with no unnecessary explanation of concepts Claude already knows. No padding or verbose descriptions.	3 / 3
Actionability	The tables and decision flowchart provide concrete guidance for tool selection, and the launch section shows specific invocation syntax. However, the launch examples are somewhat schematic rather than fully executable (e.g., pseudo-syntax for Skill/Task tool calls), and there's no complete worked example showing end-to-end tool selection and invocation.	2 / 3
Workflow Clarity	The decision flowchart provides a clear sequence for choosing between skills and agents. The 'Match by Task Type' table acts as a practical lookup with clear escalation paths (skill first, then agent if needed). For a recommendation/routing skill, this is an unambiguous single-decision workflow.	3 / 3
Progressive Disclosure	The skill references `./references/agents-catalog.md` and `./references/skills-catalog.md` for deeper content, which is good progressive disclosure design. However, no bundle files were provided, so these references are unverifiable. The inline content is well-structured with tables but the 'Additional Resources' section references files that may not exist.	2 / 3
	Total	10 / 12 Passed

Description

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 for a meta-skill that helps users choose the right tool or agent. It excels in trigger term coverage and completeness with explicit 'Triggers on' guidance, and occupies a clearly distinct niche. The main weakness is that the specificity of capabilities could be improved by describing what the recommendation process actually entails (e.g., comparing capabilities, suggesting based on task complexity, explaining tradeoffs).

Suggestions

Add more specific concrete actions beyond 'recommend', such as 'Compares agent capabilities, suggests optimal tool based on task complexity, explains tradeoffs between Task tool and Skill tool approaches.'

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 specific concrete actions beyond 'recommend'. It lacks detail on what the recommendation process involves.	2 / 3
Completeness	Clearly answers both 'what' (recommend the right agents and skills, covering Task tool and Skill tool) and 'when' (explicit trigger phrases listed after 'Triggers on:'). The trigger guidance is explicit and well-structured.	3 / 3
Trigger Term Quality	Includes a good set of natural trigger phrases users would actually say: 'which agent', 'which skill', 'what tool should I use', 'help me choose', 'recommend agent', 'find the right tool'. These cover common variations of how users would ask for help selecting tools.	3 / 3
Distinctiveness Conflict Risk	This is a meta-skill about choosing other skills/agents, which is a clear and distinct niche. The trigger terms are specific to tool/agent selection and unlikely to conflict with skills that actually perform tasks.	3 / 3
	Total	11 / 12 Passed

Validation

90%

Warnings & errors only

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: c7b7905

Reviewed: about 4 hours ago

Table of Contents

Discovery Implementation Validation

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.