CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-researcher

Comprehensive research toolkit for discovering patterns, best practices, and technical knowledge across Web search, MCP servers, GitHub repositories, and documentation. Use when researching technologies, exploring codebases, finding examples, or gathering requirements for skill development.

59

Quality

74%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/skill-researcher/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

55%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 skill has excellent workflow structure — clear operation sequencing, per-operation validation checklists, and issue/solution feedback loops — but it is severely bloated: nearly a thousand lines that re-teach research basics Claude already knows and inline detailed content that duplicates the existing references/ files. The strongest fix is to collapse the body into a lean overview that points explicitly to each reference guide and the helper script.

Suggestions

Cut the body to a concise overview (roughly the 'Quick Reference' section plus one-paragraph summaries per operation) and move each operation's detailed steps, examples, and issue/solution pairs into the corresponding references/ file, which already covers the same ground.

Replace the repeated 'When to Use / Prerequisites / Expected Outcome / Common Issues / Tips' scaffolding and the twice-present source-credibility hierarchy with a single short section — Claude already knows how to run web searches, judge credibility, and read a README.

Signal each reference explicitly next to its operation (e.g. 'Web Search: see references/web-search-strategies.md') and document the concrete commands of scripts/research-helper.py (init/add-source/add-finding/synthesize/export) instead of the generic single-line mention at the end.

DimensionReasoningScore

Conciseness

The ~930-line body extensively explains concepts Claude already knows (how to formulate a web search, evaluate source credibility, navigate documentation, read a README) and pads every operation with repeated 'When to Use / Prerequisites / Steps / Expected Outcome / Validation / Common Issues / Tips' scaffolding. The credibility hierarchy and search-query advice appear multiple times. This is noticeably below the midpoint — most of the per-operation prose could be cut without losing actionable content — though it stops short of anchor 1's purely elementary tutorial tone.

2 / 5

Actionability

There is concrete material — example search queries ('"MCP server" database access', 'topic:claude-code language:markdown'), a copy-paste synthesis template, and example findings documents — but much of the step guidance restates what Claude trivially knows ('Use WebSearch tool with formulated query', 'Review README for relevance', 'Check stars, activity'). Compared to anchor 4, the guidance is incomplete: no executable code in the body, generic process directions where specific non-obvious instructions are needed, though it is not merely vague as in anchors 1-2.

3 / 5

Workflow Clarity

The five operations are clearly introduced up front ('Task-based (5 independent research operations)'), each is sequenced with numbered steps, and every operation ends with an explicit validation checklist. 'Common Issues' with paired Solutions provide the error-recovery feedback loops anchor 5 requires (e.g. 'Search too broad → add specific technical terms', 'Conflicting information → prioritize official docs'), and the Research Quality Checklist closes the overall process. It clearly exceeds anchor 4's 'most checkpoints present'.

5 / 5

Progressive Disclosure

The bundle is real and well-matched — four references/ guides (one per research type) plus scripts/research-helper.py, all one level deep — but the body only gestures at them generically at the very end ('see the references/ directory') rather than signaling them per section, and ~600 lines of per-operation detail that duplicates the reference files are fully inlined in SKILL.md itself. This matches anchor 3 ('references present but not clearly signaled; content that should be separate is inline'); the good section structure keeps it from anchor 2, while the duplication and weak signaling keep it from anchor 4.

3 / 5

Total

13

/

20

Passed

Description

83%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 that clearly states what the skill does and when to use it, with an explicit 'Use when' clause and natural trigger phrases. The main gaps are slightly generic action verbs and a few missing synonyms/trigger variations.

DimensionReasoningScore

Specificity

The description lists several specific actions — 'discovering patterns, best practices, and technical knowledge', 'researching technologies', 'exploring codebases', 'finding examples', 'gathering requirements' — across named sources (Web search, MCP servers, GitHub repositories, documentation). It falls short of anchor 5 because the verbs remain somewhat generic ('researching', 'gathering') and it omits concrete operations like synthesizing findings or comparing MCP servers, while 'Comprehensive research toolkit' is mild padding.

4 / 5

Completeness

It explicitly answers 'what' (discover patterns, best practices, and technical knowledge across Web search, MCP servers, GitHub, documentation) and 'when' with a concrete 'Use when...' clause listing four trigger scenarios. Both halves are explicit with concrete trigger phrases, matching anchor 5; anchor 4's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

The 'Use when' clause provides good natural trigger phrases ('researching technologies', 'exploring codebases', 'finding examples', 'gathering requirements for skill development'). It misses common variations users might say, such as 'web search', 'look up', 'best practices', 'find documentation', so it does not reach anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The enumeration of specific channels (Web search, MCP, GitHub, docs) and the skill-development framing give it a recognizable niche with distinct triggers, but 'researching technologies' is broad enough to overlap with general web-search or code-exploration skills, keeping it below anchor 5.

4 / 5

Total

17

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (937 lines); consider splitting into references/ and linking

Warning

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

14

/

16

Passed

Repository
fernandezbaptiste/Skrillz
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.