CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

find-docs

Retrieve current documentation, API references, and code examples for any library, framework, SDK, CLI tool, or cloud service — including well-known ones like React, Next.js, Prisma, Django, or Spring Boot. Use for API syntax, configuration options, version migrations, setup instructions, and library-specific debugging, even when you already think you know the answer: training data on API details and signatures is frequently outdated. Prefer this over web search for library documentation.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/find-docs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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.

The body is a generated stub that delegates entirely to an external shared skill file. While maximally lean, it offers no actionable guidance, no workflow, and no overview on its own — and its single reference targets an absolute home-directory path that is not part of the skill bundle (and does not exist in this environment), making the skill unusable as written.

Suggestions

Inline a minimal quick-start section (e.g., the core documentation-retrieval command or workflow) so the skill remains actionable when the shared file at ~/.agents/skills/find-docs/SKILL.md is unavailable.

Replace the environment-dependent absolute path with a bundle-relative reference (e.g., files under references/) so the skill is self-contained and portable.

Add a brief overview of what the shared skill covers so SKILL.md functions as an index/entry point rather than a bare redirect.

DimensionReasoningScore

Conciseness

The body is two lines — a generator comment and one directive — with zero padding and no explanation of concepts Claude already knows. Every token present is doing work, matching the lean 5 anchor.

5 / 5

Actionability

The single instruction "Load and follow the shared skill at ~/.agents/skills/find-docs/SKILL.md" names an exact path and an unambiguous action, so it is not vague (not 1), but it contains no substantive guidance for the skill's actual task — everything actionable lives in a file outside this bundle. It provides only a high-level hint with the actual steps missing, matching the 2 anchor.

2 / 5

Workflow Clarity

The one directive given is unambiguous, but the real workflow (how to retrieve and verify library documentation) is entirely externalized with no visible sequencing or checkpoints. This sits between the 2 anchor (steps poorly defined) and the simple-skill 5 exception (single unambiguous action) — the delegation hides a multi-step process, so 3 fits best.

3 / 5

Progressive Disclosure

The sole reference is clearly signaled and exactly one level deep with no nesting (better than the 3 anchor's buried references), but the body contains no overview content whatsoever and the reference points to an environment-dependent absolute path outside the bundle rather than a bundled file. It is not a well-structured overview with appropriately split content, so it does not reach 4.

3 / 5

Total

13

/

20

Passed

Description

91%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 strong description: it states a clear capability, enumerates concrete use cases and trigger phrases, names popular libraries for matching, and explicitly resolves the main conflict with web search. Its only weaknesses are a somewhat generic core verb and broad scope that could overlap with framework-specific skills.

DimensionReasoningScore

Specificity

Lists several specific capabilities — "Retrieve current documentation, API references, and code examples" plus enumerated use cases "API syntax, configuration options, version migrations, setup instructions, and library-specific debugging" — with only minor coverage gaps. Not 5 because the core action is a single generic verb ("retrieve") rather than multiple distinct concrete operations.

4 / 5

Completeness

Explicitly answers both: what ("Retrieve current documentation, API references, and code examples for any library...") and when ("Use for API syntax, configuration options, version migrations, setup instructions, and library-specific debugging, even when you already think you know the answer") with concrete trigger phrases. Clearly matches the 5 anchor rather than the 4 anchor's "'when' could be more explicit".

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage: domain synonyms ("library, framework, SDK, CLI tool, or cloud service"), concrete well-known names ("React, Next.js, Prisma, Django, or Spring Boot"), and phrases users actually say ("API syntax", "version migrations", "setup instructions", "debugging"). Re-checked against the 4 anchor ("a few natural terms missing") — nothing significant is missing for this domain.

5 / 5

Distinctiveness Conflict Risk

Explicitly disambiguates its main competitor ("Prefer this over web search for library documentation"), giving it a mostly distinct niche. Not 5 because the scope "any library, framework, SDK, CLI tool, or cloud service" is broad and overlaps with narrower, framework-specific skills.

4 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.claude/skills/find-docs/SKILL.md

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.