CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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".

Quality

88%

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 solid, well-sequenced research workflow with concrete repo-specific guidance (gh command, vendored path rules, verification requirements) and explicit validation checkpoints throughout. All dimensions land at 4: the guidance is actionable and efficient, with only minor room to tighten section 6, add a concrete search command, and strengthen output structure.

Suggestions

Add a concrete search command example to step 2 (e.g., an rg/grep invocation for locating content by URL or keyword) so the locate step is as executable as the gh issue fetch.

Tighten section 6 (Assess documentation impact) into a short decision rule or checklist format — its three paragraphs of prose are the least token-efficient part of the body.

Spell out the /manuals prefix URL-to-path mapping inline or move it to a clearly signaled reference file, instead of only reminding the reader that it exists.

DimensionReasoningScore

Conciseness

The body is efficient and contains no explanations of concepts Claude already knows — every section carries repo-specific guidance (vendored paths, the /manuals prefix mapping, the gh command). It is not a 5 because sections 6 and 8 run slightly long and could be trimmed ('A code change or release-note entry is evidence to investigate, not a reason by itself to add documentation...').

4 / 5

Actionability

Mostly executable guidance: a copy-paste 'gh issue view' command with exact JSON fields, exact read-only path lists (_vendor/, data/cli/, content/reference/cli/), the live-site URL format, and a concrete good/bad specificity example in section 8. It is not a 5 because step 2 says 'Search content/' without a concrete search command example, and the /manuals prefix mapping is deferred rather than shown.

4 / 5

Workflow Clarity

A clear 8-step sequence with explicit verification checkpoints — confirming the reported problem in the file (step 2), checking vendored ownership before planning any edit (step 3), and refusing to plan fixes on unverified claims with blocker reporting (step 5). It sits between anchors 4 and 5: validation is explicit and there is a conditional failure path, but there are no checklists or retry loops, so the 4 anchor ('clear sequence with most checkpoints present; minor validation gaps') is the best fit.

4 / 5

Progressive Disclosure

A well-organized single file with clearly labeled sections and one clearly signaled one-level-deep reference ('See the vendored content table in CLAUDE.md'); nothing inlined clearly belongs in a separate file. The 5 anchor's simple-skill exception (under 50 lines) does not apply at ~112 lines, and section 6's three-paragraph treatment of impact assessment is a minor organization gap, matching the 4 anchor.

4 / 5

Total

16

/

20

Passed

Description

95%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: concrete third-person actions, an explicit 'Use when' clause, and a rich set of natural trigger phrases with synonyms. Both what and when are answered clearly, and the pre-fix research framing keeps it distinct from write-oriented skills.

DimensionReasoningScore

Specificity

The description lists three concrete third-person actions — 'locate affected files, understand the problem, identify what to change' — which matches the anchor for several specific actions with minor gaps. It is not a 5 because coverage is not comprehensive (fact verification, impact assessment, and reporting are not mentioned), and not a 3 because it names more than 1-2 concrete actions in the domain.

4 / 5

Completeness

Both questions are explicitly answered: the 'what' ('Research a documentation topic — locate affected files, understand the problem, identify what to change') and the 'when' ('Use when investigating an issue, a question, or a topic before writing a fix' plus concrete trigger phrases). This matches the anchor for clearly and explicitly answering both what AND when with concrete triggers.

5 / 5

Trigger Term Quality

Six natural trigger phrases ('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') cover synonyms users would actually say (research/investigate/look into), matching the comprehensive-coverage anchor. It exceeds the 4 anchor because no significant natural terms are missing.

5 / 5

Distinctiveness Conflict Risk

It carves out a clear niche — pre-fix documentation research — with distinct triggers ('what files are affected by #200', 'is our docs page about Y accurate') and the 'before writing a fix' qualifier separating it from write/edit skills. Conflict risk is minimal, matching the 5 anchor rather than the 4 anchor's 'minor overlap risk with closely related skills'.

5 / 5

Total

19

/

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

docker/docs

Path

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