CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

Install with Tessl CLI

npx tessl i github:brianlovin/claude-config --skill find-skills
What are skills?

Overall
score

86%

Does it follow best practices?

Agent success when using this skill

Validation for skill structure

SKILL.md
Review
Evals

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 excellent trigger term coverage and clear when-to-use guidance. The main weakness is that the 'what' portion could be more specific about the concrete actions involved in skill discovery (e.g., searching a registry, comparing options, handling installation). The description effectively carves out a distinct meta-level niche.

Suggestions

Expand the capabilities section with more specific actions like 'search skill registries, compare available options, handle installation and configuration'

DimensionReasoningScore

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'). Has explicit trigger guidance.

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 solid, actionable skill that clearly guides Claude through discovering and installing skills. Its main strength is the concrete, executable commands and well-structured workflow. The primary weakness is moderate verbosity—some sections explain things Claude would understand implicitly, and the content could be more token-efficient.

Suggestions

Remove or significantly condense the 'What is the Skills CLI?' section—Claude can infer this from the commands themselves

Consider moving the 'Common Skill Categories' table to a separate reference file or removing it entirely, as Claude can generate relevant search terms contextually

DimensionReasoningScore

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 requests, 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 a clear fallback path, completing the workflow coverage.

3 / 3

Progressive Disclosure

Content is well-organized with clear sections, but everything is inline in one file. The common categories table and tips sections could potentially be separate references. For a skill of this length (~120 lines), some content could be externalized.

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

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.