CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

research

Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.

Quality

85%

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

The canonical home for this skill is research in mattpocock/skills

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 tight, well-sequenced instruction-only skill body: it tells Claude exactly what the background agent must do, what counts as a primary source, and where to save the output, with zero padding. The only meaningful improvement would be a validation step (verify the agent's output file exists and claims are cited) and a touch more executable detail on the agent prompt.

Suggestions

Add a post-run validation step, e.g. 'Confirm the Markdown file exists and each claim carries a citation before reporting done', to close the workflow_clarity gap.

Include a one-line example of the agent prompt or the expected findings-file skeleton (claim + source link per point) to make the delegation fully copy-paste ready.

DimensionReasoningScore

Conciseness

The 12-line body is lean and assumes Claude's competence — it never explains what a primary source is beyond a compact parenthetical, what Markdown is, or how background agents work. Every line either directs action or constrains it, matching the 'every token earns its place' anchor.

5 / 5

Actionability

The guidance is mostly executable: 'Spin up a background agent', the enumerated criteria for primary sources ('official docs, source code, specs, first-party APIs'), 'Write the findings to a single Markdown file, citing each claim's source', and a concrete save-location rule. It is not a 5 because it stops short of copy-paste-ready specifics — no example agent prompt, no suggested file-naming pattern or findings-file structure — leaving minor gaps, and not a 3 because the steps are concrete directives rather than high-level hints.

4 / 5

Workflow Clarity

The three numbered steps form a clear, correctly-ordered sequence (investigate → write findings → save to conventional location) with explicit decision guidance ('if there is none, put it somewhere sensible and say where'). It is not a 5 because there is no validation checkpoint (e.g., confirm the agent's file exists or that claims actually cite sources), and not a 3 because the sequence is unambiguous with only that minor gap — no destructive or batch operation is involved, so no cap applies.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references — no references/, scripts/, or assets/ exist in the bundle, and nothing in the body points to missing files — and the body is well organized as a directive followed by a three-item job list. Per the rubric's simple-skill guideline, this matches the top anchor for a self-contained skill.

5 / 5

Total

18

/

20

Passed

Description

78%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 in third-person voice that clearly states both what the skill does and when to use it, with natural trigger phrasings. Its main gap is modest action specificity — it names two concrete actions but omits the deeper capability details (citation of each claim, matching repo conventions) that live only in the body.

Suggestions

Fold one more concrete capability into the description, e.g. 'citing each claim's source' or 'matching the repo's existing notes convention', to lift specificity from 1-2 actions to several.

Add a synonym trigger such as 'look this up' or 'dig into a topic' alongside 'topic researched' to broaden natural keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain and two concrete actions — "Investigate a question against high-trust primary sources" and "capture the findings as a Markdown file in the repo" — which matches the anchor for naming the domain with 1-2 concrete actions. It is not a 4 because it stops short of listing several specific actions (e.g., verifying citations, following claims back to owners, organizing output), and not a 2 because the actions it does state are concrete rather than generic.

3 / 5

Completeness

It explicitly answers what ("Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo") and when ("Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent") with concrete trigger phrases, matching the top anchor exactly. It is not a 4 because the 'when' clause is already explicit and specific, listing three distinct trigger scenarios.

5 / 5

Trigger Term Quality

"Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent" covers good natural phrases — "topic researched", "docs or API facts gathered", "reading legwork" — that users would plausibly say. It is not a 5 because common variations like "look this up", "find out about", "dig into", or specific artifact terms are missing, and not a 3 because multiple natural trigger phrasings are present rather than a few keywords with missing synonyms.

4 / 5

Distinctiveness Conflict Risk

"Investigate a question against high-trust primary sources", "capture the findings as a Markdown file in the repo", and "delegated to a background agent" carve out a recognizable niche of delegated repo-documented research with minimal overlap risk. It is not a 5 because 'research' and 'docs' as triggers could overlap with general web-research or documentation-writing skills, and not a 3 because the primary-sources constraint and file-output requirement make it largely distinct.

4 / 5

Total

16

/

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

tonykay/transcriber

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.