CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

docs-research

Gather official, up-to-date documentation and convert it into a concise implementation checklist for the current coding task.

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/docs-research/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

92%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 lean, well-organized instruction skill: every token earns its place, the workflow is a clear five-step sequence, and the structure suits a small single-file skill with no external references. The only notable gap is the absence of a worked example showing what a checklist entry or citation should look like.

DimensionReasoningScore

Conciseness

The body is 19 lines with zero padding: a one-line trigger, five terse steps, and a four-item output format. It assumes Claude's competence (e.g. 'Call out unknowns explicitly instead of guessing' with no elaboration), so every token earns its place. Not 4 because there are no over-explanations to trim at all.

5 / 5

Actionability

Concrete, specific guidance throughout: exact constraint categories ('(versions, limits, required fields, auth, edge cases)'), a defined four-section output format, and explicit citation and unknowns requirements. As an instruction-only skill the absence of code is not penalized, but minor gaps remain — no example of a checklist entry or citation format. Not 5 because it never shows what the deliverable looks like; not 3 because the guidance is specific and directly executable rather than incomplete.

4 / 5

Workflow Clarity

Five clearly numbered, unambiguous steps in correct order (prioritize sources, capture constraints, convert to checklist, cite, flag unknowns). This is a non-destructive, single-purpose skill under 50 lines, so the simple-skill exception applies and the well-organized sequence scores 5 without explicit multi-step validation loops. Not 4 because nothing in the sequence is missing or implicit.

5 / 5

Progressive Disclosure

Under 50 lines with no need for external references (none exist in the bundle, and none are referenced). Per the judging guideline, well-organized sections alone warrant 5: the body is cleanly split into a trigger condition, a numbered process, and a labeled output format. Not 4 because there is no content that should be split out and navigation is trivial.

5 / 5

Total

19

/

20

Passed

Description

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

The description states a clear, concrete capability (gather official docs, convert to a checklist) but omits any explicit 'Use when' trigger guidance, which caps completeness and limits trigger-term quality. Keywords are relevant but lack natural variations users would actually say. It is reasonably distinct but overlaps with general research skills.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks how to implement something that depends on external documentation, library APIs, or version-specific behavior.'

Include natural trigger phrases users would say, such as 'check the docs', 'latest API', 'official documentation', 'version-specific', and 'implementation guidance'.

Mention the source types it targets (e.g. official docs sites, API references, changelogs) to sharpen distinctiveness against generic web-research skills.

DimensionReasoningScore

Specificity

Names the domain ("official, up-to-date documentation") and two concrete actions ("Gather... documentation", "convert it into a concise implementation checklist"), matching the anchor for 1-2 concrete actions without comprehensive coverage. Not 4 because it does not list several distinct actions; not 2 because the actions are specific rather than minimal or generic.

3 / 5

Completeness

It clearly answers 'what' (gather official docs, convert to implementation checklist) but has no 'Use when...' clause or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3. Not 2 because the 'what' is concrete, not vague; not 4 because the 'when' is entirely absent rather than just imprecise.

3 / 5

Trigger Term Quality

Relevant keywords like "documentation", "implementation checklist", and "coding task" are present, but common natural phrases users would say ("check the docs", "latest API", "how do I use X") and synonyms/extensions are missing. This fits 'Some relevant keywords but missing common variations or synonyms', not 4, which requires good coverage with only a few gaps.

3 / 5

Distinctiveness Conflict Risk

The pairing of official docs with a checklist deliverable is somewhat specific, but "documentation" is a broad trigger that would overlap with general research, web-search, or API-reference skills. Fits 'Somewhat specific but could still overlap with similar skills'; not 4 because the trigger surface is not distinct enough to avoid overlap with closely related research skills.

3 / 5

Total

12

/

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

JoseMD12/finance-hub

Path

.agents/skills/docs-research/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.