CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

deep-research

Run autonomous research tasks that plan, search, read, and synthesize information into comprehensive reports.

Quality

73%

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 ./cli-tool/components/skills/ai-research/deep-research/SKILL.md

The canonical home for this skill is deep-research in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 well-structured, highly actionable skill body with copy-paste-ready commands for every mode, concrete cost/time expectations, and a clear workflow with exit codes. The main issues are minor duplication between the two use-case sections and a broken bundle structure where the referenced scripts/research.py and requirements.txt are missing.

Suggestions

Ship the referenced scripts (scripts/research.py and requirements.txt) in the bundle, or inline the essential behavior, since every usage command depends on files that are absent.

Merge the overlapping "When to Use This Skill" and "Best Use Cases" sections into one list to remove duplication.

Add brief error-recovery guidance for exit code 1 (e.g., check GEMINI_API_KEY, retry on timeout) to close the workflow validation gap.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no explanations of known concepts, with useful concrete tables ("Time | 2-10 minutes per task", "$2-5 per task", token usage). It loses a point because "When to Use This Skill" and "Best Use Cases" largely duplicate the same use-case lists (market analysis, competitive landscaping, due diligence appear in both), which could be merged.

4 / 5

Actionability

Every usage mode is given as a copy-paste-ready command (e.g., `python3 scripts/research.py --query "Research the history of Kubernetes"`, `--status <interaction_id>`, `--wait`, `--continue`, `--list`), plus concrete setup steps, output formats, and exit codes. The examples cover the common cases completely.

5 / 5

Workflow Clarity

The Workflow section gives a clear 5-step sequence with monitoring checkpoints ("Monitor with --stream or poll with --status") and exit codes signal error outcomes. It falls short of 5 because there is no error-recovery guidance for exit code 1 (e.g., what to check or whether to retry), and no validation of the returned report.

4 / 5

Progressive Disclosure

The SKILL.md itself is well organized into clear sections, but its references ("python3 scripts/research.py", "pip install -r requirements.txt") point to files that are not present in the bundle — no scripts/ directory exists — so the one-level-deep reference structure is broken and the skill cannot actually be executed as bundled. This is more than a minor organization gap, placing it below 4.

3 / 5

Total

16

/

20

Passed

Description

58%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 concise, third-person description with a clear statement of what the skill does and several concrete action verbs. Its main weaknesses are the complete absence of a "Use when..." clause (capping completeness) and thin natural trigger-term coverage relative to the use cases the body itself enumerates.

Suggestions

Add an explicit trigger clause, e.g.: "Use when the user asks for deep-dive research, market analysis, competitive landscaping, literature reviews, due diligence, or a detailed cited report on a topic."

Include natural trigger terms and synonyms users would actually say ("deep research", "literature review", "market analysis", "competitive landscape", "due diligence") to mirror the use cases already listed in the body.

Mention distinctive capabilities such as continuing a prior research session or streaming progress to differentiate the skill from generic web-search skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "plan, search, read, and synthesize information into comprehensive reports" — which names the domain and multiple specific capabilities. It falls short of 5 because coverage has gaps (no mention of citations, follow-up questions, or the report format control the skill actually supports).

4 / 5

Completeness

The "what" is clearly stated ("Run autonomous research tasks that plan, search, read, and synthesize information into comprehensive reports"), but there is no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not 2 because the "what" is specific rather than vague.

3 / 5

Trigger Term Quality

"research tasks" and "comprehensive reports" are relevant natural keywords, but common variations users would actually say are missing (e.g., "deep dive", "literature review", "market analysis", "due diligence"). It is above 2 because the keywords present are natural rather than jargon, but below 4 due to the missing synonyms and variations.

3 / 5

Distinctiveness Conflict Risk

"Autonomous research tasks that... synthesize information into comprehensive reports" carves out a mostly distinct niche with only minor overlap risk against generic web-search or summarization skills. It is not 5 because no explicit distinct triggers are given, so broad "research X" requests could still overlap with simpler search skills.

4 / 5

Total

14

/

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

metadata_version

'metadata.version' is missing

Warning

referenced_paths_exist

Referenced path issues: 8 missing

Warning

Total

14

/

16

Passed

Repository

davila7/claude-code-templates

Path

cli-tool/components/skills/ai-research/deep-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.