find-skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
86
83%
Does it follow best practices?
Impact
86%
7.16xAverage score across 8 eval scenarios
Advisory
Suggest reviewing before use
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 well-crafted description that excels at trigger term quality and completeness, providing clear guidance on when to use the skill with natural user phrases. The main weakness is moderate specificity - it could benefit from listing more concrete actions beyond 'discover and install' such as searching, browsing catalogs, or comparing options.
Suggestions
Add more specific concrete actions like 'search skill catalogs, browse available extensions, compare skill options, configure installed skills'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (skill discovery/installation) and some actions ('discover and install agent skills'), but lacks comprehensive concrete actions like searching, browsing, comparing, or configuring skills. | 2 / 3 |
Completeness | Clearly answers both what ('discover and install agent skills') and when ('when they ask questions like...', 'when the user is looking for functionality that might exist as an installable skill'). Explicit trigger guidance is provided. | 3 / 3 |
Trigger Term Quality | Includes natural phrases users would say: 'how do I do X', 'find a skill for X', 'is there a skill that can...', 'extending capabilities'. Good coverage of discovery-related language. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on skill discovery and installation. The trigger phrases are distinct meta-level queries about capabilities rather than task execution, making conflicts unlikely. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
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, actionable skill that clearly guides Claude through discovering and installing skills. Its main strengths are the concrete commands, clear workflow steps, and good coverage of edge cases (no results found). The primary weakness is moderate verbosity - some sections explain things Claude would already understand, and the content could be tightened without losing clarity.
Suggestions
Remove or significantly condense the 'What is the Skills CLI?' section - Claude doesn't need the conceptual explanation, just the commands
Consider moving the 'Common Skill Categories' table to a separate reference file or removing it entirely, as Claude can infer appropriate search terms
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill includes some unnecessary explanation (e.g., 'What is the Skills CLI?' section explains concepts Claude could infer) and the common categories table, while useful, adds bulk. However, it's not egregiously verbose and most content serves a purpose. | 2 / 3 |
Actionability | Provides fully executable commands throughout (npx skills find, npx skills add with flags), concrete example queries mapped to user intents, and copy-paste ready install commands with clear flag explanations. | 3 / 3 |
Workflow Clarity | Clear 4-step workflow (Understand → Search → Present → Install) with explicit guidance at each stage. The 'When No Skills Are Found' section provides good error recovery guidance. Steps are well-sequenced and unambiguous. | 3 / 3 |
Progressive Disclosure | Content is reasonably organized with clear sections, but everything is inline in one file. The common categories table and tips sections could potentially be separate references. No external file references are used, though for this skill's complexity it may be acceptable. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- brianlovin/claude-config
- Commit
1a9819e
- 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.