CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

deep-research

Read this skill when the user asks for a research report, deep research, industry report, analysis report, whitepaper, or any substantive document deliverable; or when the topic requires multi-source retrieval and cross-validation (competitive analysis, market analysis, industry research, deep dive, landscape survey); or when the user is unsatisfied with the depth of an existing answer. Keyword signals: research, deep research, deep dive, analysis, investigate, report, survey, industry analysis, competitive analysis, market analysis. Trigger when: (1) the user wants to produce a formal report or research document as the deliverable; (2) the topic requires current, verifiable data from multiple sources — news, market analysis, competitive landscape, industry research; (3) the user is unsatisfied with the depth of an existing answer. Skip when a single search or model recall suffices and no document output is needed.

Quality

68%

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 ./backend/super-magic/agents/skills/deep-research/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

46%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 body is well-structured with a clear kickoff workflow and explicit authorization checkpoints, but it is a pointer document whose two referenced files are missing from the bundle — the actual research workflow and report template it depends on are absent, making the skill unexecutable as shipped. Repetition of the approval rules across four sections also inflates the token cost.

Suggestions

Ship the referenced files: create reference/research-workflow.md (with the Phase 1-6 workflow) and reference/report-template.html, or inline a minimal version of the workflow if the bundle is meant to be single-file.

Consolidate the authorization rules into the Interaction Rules section and reference them once from the Non-Negotiable Rules, the deepening section, and the pseudoflow to remove the quadruple repetition.

Inline a brief outline of the post-approval research phases (even 5-6 bullet lines) so the core sequence survives even when the external workflow file is unavailable.

DimensionReasoningScore

Conciseness

The body avoids explaining known concepts and is sectioned, but the authorization/non-approval logic is repeated four times (Non-Negotiable Rules, Interaction Rules items 4-7, the deepening section, and the pseudoflow), and the pseudoflow restates the Step 1-4 sequence verbatim. Mostly efficient but could be tightened by stating the authorization rules once, which keeps it below 4.

3 / 5

Actionability

The kickoff phase is genuinely concrete ('Run one web_search call with 2-3 queries in parallel... (e.g. "what is X" + "X current debates" + "X use cases")', exact ask_user question structure, timeout policy), but the execution phase is entirely delegated to 'reference/research-workflow.md' and the deliverable to 'reference/report-template.html' — neither file exists in the bundle, so 'execute full workflow' and 'follow template rules' cannot actually be executed. Some concrete, incomplete guidance matches the 3 anchor rather than 4.

3 / 5

Workflow Clarity

The pre-execution sequence (pre-search -> plan draft -> ask_user kickoff -> continue from answer) is clearly ordered with explicit authorization checkpoints, and the deepening mode has its own flow. However, the sequence after approval is a black box ('execute full workflow', 'Phase 6's gap diagnosis') pointing at a missing reference file, leaving key steps undefined — a present-but-gapped sequence, hence 3 rather than 4.

3 / 5

Progressive Disclosure

The 'References (Read On Demand)' section is well designed — two files, one level deep, each mapped to a condition — but neither 'reference/research-workflow.md' nor 'reference/report-template.html' exists in the bundle (no reference/, references/, scripts/, or assets/ directories are present). Scored against the actual bundle structure, both referenced paths are dead, so the on-demand content the whole skill depends on is undeliverable; the signaling is good but the disclosure chain is broken, which lands at 2 rather than 3.

2 / 5

Total

11

/

20

Passed

Description

77%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, trigger-oriented description with excellent natural keyword coverage and an unusually explicit when-to-use/when-to-skip structure. Its main weakness is that the skill's own capabilities are implied rather than stated, leaving the 'what' side softer than the 'when' side.

Suggestions

Open with an explicit capability statement in third person (e.g., 'Plans, retrieves, cross-validates, and writes up multi-source research into an evidence-backed HTML report') before the trigger conditions.

Narrow the broad keyword signals 'analysis' and 'report' to research-specific forms (e.g., 'research report', 'analysis report') to reduce overlap with generic analysis/writing skills.

DimensionReasoningScore

Specificity

The domain is clearly named (research reports, deep research, whitepapers) and 'multi-source retrieval and cross-validation' are concrete actions, but they are framed as conditions on the topic ('the topic requires multi-source retrieval and cross-validation') rather than the skill's own capabilities. It does not reach 4 because the skill's actions (plan, retrieve, cross-validate, write up) are never enumerated as what the skill does; it stays above 2 because the language is more concrete than bare domain naming.

3 / 5

Completeness

Both halves are present: the 'when' is maximally explicit ('Trigger when: (1)... (2)... (3)...' plus a 'Skip when' clause) with concrete trigger phrases, and the 'what' is derivable from 'the user wants to produce a formal report or research document as the deliverable'. It does not reach 5 because the description never explicitly states what the skill itself does (e.g., 'plans, retrieves, cross-validates, and writes up research into an HTML report') — the capability side is implied through user-side framing.

4 / 5

Trigger Term Quality

Comprehensive natural-term coverage including synonyms and variants: 'research, deep research, deep dive, analysis, investigate, report, survey, industry analysis, competitive analysis, market analysis' plus deliverable names like 'whitepaper' and 'landscape survey' — these are phrases users would actually say. Only marginal terms (e.g., 'literature review', 'fact-check') are absent, so it does not fall to 4.

5 / 5

Distinctiveness Conflict Risk

A clear deep-research niche with distinctive triggers (deep research, whitepaper, landscape survey, competitive analysis) and an explicit skip clause ('Skip when a single search or model recall suffices') that delineates it from plain search skills. Not 5 because standalone broad keyword signals like 'analysis' and 'report' create minor overlap risk with generic data-analysis or writing skills.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

dtyq/magic

Path

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