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

85%

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

The canonical home for this skill is find-docs in phatblat/dotfiles

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 maximally concise, unambiguous redirect stub: perfect token efficiency and clear single-step workflow, but it contains none of the skill's actual guidance — everything is delegated to an external shared path that is not part of the bundle and does not resolve in this environment. As a standalone SKILL.md it is not self-contained, which hurts actionability and progressive disclosure.

Suggestions

Inline a minimal quick-start (e.g., the core documentation-retrieval workflow or a representative command/example) in the body so the skill provides actionable guidance even when the shared file cannot be resolved.

Move or vendor the shared skill content into the skill's own bundle (e.g., a references/ directory with a relative path) so the reference is verifiable and one level deep within the skill.

Add a fallback instruction for when `~/.agents/skills/find-docs/SKILL.md` is absent, since the external path does not exist in this environment and the skill currently dead-ends without it.

DimensionReasoningScore

Conciseness

The body is two lines — a generator comment and one instruction ("Load and follow the shared skill at `~/.agents/skills/find-docs/SKILL.md`.") — with zero explanation of concepts Claude already knows, matching anchor 5 ('lean and efficient; every token earns its place'). Nothing can be trimmed; there is no over-explanation to penalize.

5 / 5

Actionability

The single directive is concrete (an exact file path, unambiguous action), but it delegates 100% of the actual guidance to an external file outside the skill bundle, so no steps, commands, or examples for the skill's core task exist in the skill itself — matching anchor 3 ('some concrete guidance but incomplete; missing key details'). Not a 2 because the pointer is specific rather than a high-level hint; not a 4 because there is no executable content for the task itself.

3 / 5

Workflow Clarity

This is a single-action skill and the action is unambiguous: load and follow the named file. Per the simple-skill guideline ('single task... can score 5 if the single action is unambiguous'), it matches anchor 5. No destructive or batch operations are involved, so no validation checkpoints are required.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories), and the body's sole reference points outside the skill to `~/.agents/skills/find-docs/SKILL.md`, which does not exist in this environment and cannot be verified as one-level-deep navigable content; the comment's `scripts/agent-harnesses.py` also does not exist. The pointer itself is clearly signaled, but the skill is a pure redirect stub with no in-bundle structure or content, landing at anchor 3. Not a 4: 'most content is appropriately placed' fails when all content is external and unverifiable.

3 / 5

Total

16

/

20

Passed

Description

87%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 clearly states what the skill retrieves, gives an explicit and well-enumerated 'Use for' trigger clause, names example frameworks, and explicitly distinguishes itself from plain web search. The only deductions are the single-verb action list (with a second-person clause drawing the voice penalty) and a few missing natural synonym phrasings.

DimensionReasoningScore

Specificity

"Retrieve current documentation, API references, and code examples for any library, framework, SDK, CLI tool, or cloud service" names the domain and concrete deliverables, matching anchor 4 ('several specific actions; minor gaps') rather than 5, since there is essentially one action verb (retrieve) with three object types instead of multiple distinct actions. The second-person clause "even when you already think you know the answer" also draws the voice penalty from the judging guidelines; it is not a 3 because coverage of deliverables, targets, and use contexts exceeds '1-2 concrete actions'.

4 / 5

Completeness

Explicitly answers '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"), matching anchor 5: both what and when with concrete trigger phrases. Not a 4 because the 'when' clause is specific and enumerated rather than merely present-but-vague.

5 / 5

Trigger Term Quality

"API syntax, configuration options, version migrations, setup instructions, and library-specific debugging" plus named frameworks ("React, Next.js, Prisma, Django, or Spring Boot") give good natural-keyword coverage matching anchor 4. It falls short of anchor 5's 'comprehensive coverage including synonyms' because common user phrasings like "docs", "how to use X", "upgrade guide", or "API reference lookup" variations are absent.

4 / 5

Distinctiveness Conflict Risk

"Prefer this over web search for library documentation" carves out a clear niche and explicitly disambiguates against the closest competing skill, and named-framework triggers are distinct — matching anchor 5 ('clear niche with distinct triggers; minimal conflict risk'). Not a 4: it does not merely have minor overlap risk, it actively positions against the main competitor.

5 / 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

.agents/harness/adapters/antigravity/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.