CtrlK
BlogDocsLog inGet started
Tessl Logo

find-examples

Find usage examples of an API, library, or code pattern across internal repositories — use when looking for how other teams use an internal API, library, or pattern before implementing something new.

68

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-sequenced skill body with concrete search queries, an explicit vetting checkpoint, and error-recovery guidance. Its main weakness is the verbosity of the inlined output templates, which slightly inflates the token budget and could be split into references.

Suggestions

Move the Phase 5 presentation template and the 'If No Good Examples' template into a reference file (e.g. references/output-templates.md) and link to them, reducing inline tokens while keeping the workflow in SKILL.md.

Trim the vetting table's prose where the ✅/⚠️/❌ cells repeat information already implied by the Anti-Pattern Signals list, to tighten conciseness.

Add a one-line note clarifying that `code_search`/`search` are the available search tools, so the queries are unambiguously executable in environments where tool names differ.

DimensionReasoningScore

Conciseness

The body is efficient: short principle bullets, copy-paste search queries, and a compact vetting table, with no padding explaining concepts Claude already knows. It is not a 5 because the two large placeholder markdown output templates (Phase 5 and 'If No Good Examples') are verbose and could be trimmed or factored out, and not a 3 because the surrounding material is genuinely lean rather than merely 'mostly efficient'.

4 / 5

Actionability

Guidance is concrete and executable throughout — copy-paste-ready `code_search`/`search` query templates, numeric recency thresholds (<6 / 6-12 / 12+ months), explicit anti-pattern signals, and a fill-in output template covering common cases. It is not a 4 because the commands and criteria are specific rather than having only minor gaps.

5 / 5

Workflow Clarity

A clearly sequenced 5-phase process (Search → Vary → Document → Vet → Present) with an explicit validation checkpoint in Phase 4 (the vetting table and reject/warn signals act as a checklist) and an error-recovery branch ('If No Good Examples Found'). Because validation is present, the batch-operation cap does not apply; it is not a 4 because checkpoints and feedback handling are explicit rather than minor-gap.

5 / 5

Progressive Disclosure

The skill is a single well-organized file with clear section headers, no nested references, and no bundle files to misroute — good structure and easy navigation. It is not a 5 because at ~130 lines the two sizable output templates could arguably live in separate reference files, and not a 3 because the organization is clean with no buried or poorly signaled references.

4 / 5

Total

18

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-crafted description that clearly states both what the skill does and when to use it, with natural trigger phrasing. Its only real limitation is that it names a single concrete action rather than a broader set, which caps specificity.

DimensionReasoningScore

Specificity

The description names a clear domain ('an API, library, or code pattern across internal repositories') and one concrete action ('Find usage examples'), but offers only that single action rather than a comprehensive set, matching the '1-2 concrete actions' anchor. It is not a 4 because there are not several specific actions listed, and not a 2 because the action is concrete rather than minimal or generic.

3 / 5

Completeness

It explicitly answers both 'what' ('Find usage examples of an API, library, or code pattern across internal repositories') and 'when' with concrete trigger phrasing ('use when looking for how other teams use an internal API, library, or pattern before implementing something new'). It mirrors the rubric's 5-anchor example structure, so it is not a 4 where the 'when' is only weakly specified.

5 / 5

Trigger Term Quality

Natural phrases a user would say appear — 'usage examples', 'how other teams use', 'API', 'library', 'pattern', 'before implementing something new' — giving good keyword coverage. It is not a 5 because it lacks synonyms and file/extension-style variants, and not a 3 because the terms go beyond bare keywords to genuinely natural phrasing.

4 / 5

Distinctiveness Conflict Risk

The 'internal repositories / how other teams use / before implementing something new' framing carves a mostly distinct niche with minimal conflict risk against unrelated skills. It is not a 5 because of some overlap risk with generic code-search skills, and not a 3 because the trigger is specific rather than merely 'somewhat specific'.

4 / 5

Total

16

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
gleanwork/claude-plugins
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.