CtrlK
BlogDocsLog inGet started
Tessl Logo

research

Research a documentation topic — locate affected files, understand the problem, identify what to change. Use when investigating an issue, a question, or a topic before writing a fix. Triggers on: "research issue 1234", "investigate what needs changing for #500", "what files are affected by #200", "where is X documented", "is our docs page about Y accurate", "look into how we document Z".

80

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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-sequenced research workflow with concrete commands, specific file paths, and explicit verification checkpoints. It assumes Claude's competence and provides a model for the expected specificity of findings.

DimensionReasoningScore

Conciseness

Short 2–4 line sections with no padding and no explanation of concepts Claude already knows (GitHub issues, Hugo modules, URLs) match the score-3 "lean and efficient; assumes Claude's competence" anchor rather than the score-2 "could be tightened" bar.

3 / 3

Actionability

Provides a copy-paste-ready command ("gh issue view <number> --repo docker/docs --json ..."), exact directory paths ("_vendor/", "data/cli/", "content/reference/cli/", "content/includes/"), and a concrete model finding ("In `compose/networking.md`, the 'Custom networks' section, remove the note about `driver_opts`"). The remaining prose steps are appropriate for an instruction-only research skill, which the rubric does not penalize when guidance is actionable, keeping it above the score-2 "pseudocode / missing key details" anchor.

3 / 3

Workflow Clarity

Seven numbered sections are clearly sequenced with explicit validation checkpoints — "confirm it contains the reported problem" (step 2), "Before planning any edit, verify the file is editable locally" (step 3), and "Do not plan a fix based on an unverified claim" / "report it as a blocker" (step 5) — matching the score-3 "clear sequence with explicit validation steps" anchor rather than score-2's implicit checkpoints.

3 / 3

Progressive Disclosure

A single well-organized file with clear section headings and one clearly-signaled one-level-deep external reference ("See the vendored content table in CLAUDE.md"); no nested/deep references and no inappropriately inline content, so it clears the score-3 bar for well-organized content rather than the score-2 "could be better organized / unsignaled references" anchor.

3 / 3

Total

12

/

12

Passed

Description

100%

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 that clearly states the skill's purpose and provides explicit, natural trigger phrases. It answers both 'what' and 'when' concisely without padding or over-claims.

DimensionReasoningScore

Specificity

"locate affected files, understand the problem, identify what to change" lists multiple concrete actions, matching the score-3 anchor for several specific actions rather than the score-2 "some actions" anchor.

3 / 3

Completeness

It states what the skill does ("Research a documentation topic — locate affected files...") and when to use it ("Use when investigating an issue..." plus explicit triggers), satisfying both halves required for score 3; it is not capped at 2 because the 'when' is explicit, not implied.

3 / 3

Trigger Term Quality

The explicit "Triggers on:" clause supplies six natural user utterances ("research issue 1234", "where is X documented", "is our docs page about Y accurate"), giving good coverage of terms a user would actually say, beyond the score-2 "some relevant keywords" bar.

3 / 3

Distinctiveness Conflict Risk

The docs-research niche and issue-number/docs-page triggers ("research issue 1234", "where is X documented") form a distinct niche unlikely to fire for unrelated skills, matching the score-3 "clear niche with distinct triggers" anchor.

3 / 3

Total

12

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
docker/docs
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.