Agent skill

Deep Research

by softspark in softspark/ai-toolkit

Multi-source web research methodology: retrieve-vs-answer gate, complexity-scaled search budget, query craft, primary-source preference, source-conflict skepticism, adversarial verification…

Apache-2.0Auto-check passedResearch & Science

Install Deep Research

skills CLI
$ npx skills add softspark/ai-toolkit --skill deep-research -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install softspark/ai-toolkit deep-research --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/app/skills/deep-research .claude/skills/deep-research && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
deep-research
GitHub stars
179
Token cost
~2.5k tokens
SKILL.md length
1,439 words
Files
1
Skills in repo
112
Repo updated
First seen
Licence
Apache-2.0

At a glance

Multi-source web research methodology: retrieve-vs-answer gate, complexity-scaled search budget, query craft, primary-source preference, source-conflict skepticism, adversarial verification…

  • Works in 3 steps: Is the answer already in the KB or your… → Is it one stable fact with a single… → Does it need several independent sources…
  • Tasks that involve Deep research
  • SKILL.md covers Retrieve-vs-Answer Gate, Scale Effort to Complexity, Query Craft and Source Preference and Skepticism, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Deep Research is an agent skill from softspark/ai-toolkit. Multi-source web research methodology: retrieve-vs-answer gate, complexity-scaled search budget, query craft, primary-source preference, source-conflict skepticism, adversarial verification, attribution-without-reproduction. Triggers: deep research, multi-source, web research, synthesize sources, cross-reference, fact synthesis, source verification.

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science, covering Deep research. The repository describes itself as: Professional-grade AI coding toolkit: 94 skills, 44 agents, multi-platform (Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, Augment, Antigravity, Codex CLI… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Deep research

Example prompts

  • “/deep-research”

Requirements

  • Pre-approved tools (allowed-tools): Read

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Is the answer already in the KB or your own context? Then this is not a deep-research job — hand it to research-mastery (which checks…
  2. Is it one stable fact with a single obvious authority (a constant, a published spec value, a definition that does not move)? One targeted…
  3. Does it need several independent sources reconciled, or is it contested, recent, or moving? That is the case this skill exists for…

What it can do on your machine

Read from SKILL.md and the folder at commit d64db2b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Deep Research loads about 2.5k tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 1,439 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~91
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from softspark/ai-toolkit at commit d64db2b, republished under its Apache-2.0 licence (© softspark). 1,439 words, ~2,484 tokens.

Download SKILL.mdSave it as .claude/skills/deep-research/SKILL.md (or your agent's skills folder).
name
deep-research
description
Multi-source web research methodology: retrieve-vs-answer gate, complexity-scaled search budget, query craft, primary-source preference, source-conflict skepticism, adversarial verification, attribution-without-reproduction. Triggers: deep research, multi-source, web research, synthesize sources, cross-reference, fact synthesis, source verification.
allowed-tools
Read
user-invocable
false

Deep Research

This is the web / multi-source counterpart to research-mastery. That skill is KB-first: it answers from the project's own knowledge base and only reaches outward when the KB comes up empty. This one governs what happens once you are already out on the open web pulling from many independent sources and have to weave them into one trustworthy answer. It is a method, not a fetcher — it does not retrieve anything by itself. You supply the search and fetch tools (built-in WebSearch / WebFetch, or the runtime deep-research command); this skill tells you how to spend them and how hard to doubt what comes back.

Retrieve-vs-Answer Gate

Run this gate before you spend a single search:

  1. Is the answer already in the KB or your own context? Then this is not a deep-research job — hand it to research-mastery (which checks RAG-MCP first) or just answer.
  2. Is it one stable fact with a single obvious authority (a constant, a published spec value, a definition that does not move)? One targeted lookup, confirm, done. Do not open a research campaign.
  3. Does it need several independent sources reconciled, or is it contested, recent, or moving? That is the case this skill exists for. Continue.

Skipping this gate is the most common failure: people fan out ten searches on a question that one source already settled, or worse, answer a contested question from memory because it "felt known."

Scale Effort to Complexity

Match the search budget to the question. Burning twenty searches on a lookup wastes turns; doing two searches on a contested synthesis ships a half-checked claim.

Question shapePlan first?Rough search budget
Single stable fact, clear authorityno1, maybe a second to confirm
Compare a few known options / current state of one topiclighta handful, broaden then narrow
Contested, multi-faceted, or "what is the latest on…"yes — write the planmany, with follow-ups as conflicts surface

For anything in the bottom two rows, write a short research plan first: name the sub-questions, the kind of source that would answer each, and what "done" looks like. The plan is for you; keep it tight. Then let conflict drive the count — if sources disagree, you have not searched enough yet.

Query Craft

  • Broaden, then narrow. Open with a short, plain query to map the landscape; tighten with specific terms once you see what vocabulary the good sources actually use. Long kitchen-sink queries on the first try usually return noise.
  • Use the real current date. Anchor "recent", "latest", "current" to today's actual date — never to your training cutoff. For 2026-06-15, "latest" means 2026, not 2024. A query that silently assumes an old year is a wrong query.
  • Vary the angle on a stubborn question. If one phrasing returns thin or repetitive results, change the wording, the framing, or the assumed source type rather than re-running near-identical strings.

Source Preference and Skepticism

  • Prefer primary and original sources. Go to the spec, the paper, the official docs, the filing, the dataset, the person who actually said it — not a blog summarizing a blog summarizing it. Each hop away from the origin adds a chance for drift.
  • A surprising-but-sourced result is usually real. If a credible primary source says something counterintuitive, treat it as true and report it. Do not soften or discard a well-attributed fact just because it clashes with your prior.
  • The exception: low-trust topic zones. On SEO-spam-saturated queries, conspiracy-adjacent claims, and topics with genuinely no expert consensus, raise the bar instead of lowering it. Here a surprising claim needs strong independent corroboration before you repeat it, and "many pages say it" is not corroboration when those pages copy each other.
  • Conflict means search more. When two solid sources disagree, that is a signal to run additional searches and find a tie-breaker or the underlying primary source — not to average them, pick the one you like, or paper over the disagreement.

Adversarial Verification

Before you emit any synthesized claim, run this self-check. Each gate has a fix; do not just notice the problem.

Self-check gateIf yes, do this
Am I mirroring one source's exact phrasing or structure?Re-state it in your own words from the facts, not the prose.
Could my output stand in for reading the original — same length, same order, same examples?Cut it back. Summarize and point to the source; do not reproduce it.
Have I already leaned on this one source for several claims?Find an independent source, or flag the answer as single-sourced.
Is each claim independently corroborated, or is one shaky source carrying the conclusion?Corroborate it, drop it, or label it as unconfirmed.

For high-stakes claims — anything affecting money, health, legal exposure, security posture, or an irreversible decision — do not stop at one source. Confirm with a second, independent source or a different angle of approach before you state it as fact.

Show full SKILL.md (629 more words)Show less

Citation Discipline

  • Paraphrase by default, and attribute to a named source. "Per the FY2025 10-K…", "the RFC's section on retries states…". The reader should always know who is behind a claim.
  • Reserve verbatim quotes for genuinely distinctive phrasing — a definition, a legal clause, an exact figure where the wording itself matters. Keep quotes short and clearly marked. Do not quote at length to fill space.
  • Keep any single source's paraphrased footprint small. No one source's material should dominate your output, and the output as a whole must never substitute for reading the originals. You are pointing readers to the sources, not republishing them.
  • NEVER invent an attribution. If you are not sure a source actually said something, leave the claim out. A fabricated citation is worse than a missing one — it launders a guess as a fact.
  • Empty retrieval is a real result. If a search returns nothing usable, say "not found in available sources" and cite nothing. Do not backfill from memory and dress it up as retrieved.

Example

Task: "What is the current recommended approach for X, and has it changed recently?"

  1. Gate. Not in KB, contested, has a "recently" — this is a deep-research job. Write a 3-line plan: (a) current recommendation, (b) what it replaced, (c) when/why it changed.
  2. Broaden. Plain query anchored to the real date ("X recommended approach 2026"). Map who the authoritative voices are.
  3. Narrow to primary sources. Open the official docs / spec / changelog rather than roundup posts. Pull the version and date where the guidance changed.
  4. Conflict surfaces. One source still recommends the old approach. Run more searches; find the changelog entry that supersedes it. The disagreement was stale-vs-current, not a genuine split — note that.
  5. Adversarial pass. Re-check each gate: paraphrase in own words (not mirroring the docs' structure), confirm the change claim against a second independent source since it drives the answer, confirm no single source carries everything.
  6. Synthesize with attribution. "The official docs as of <date> recommend …; this replaced … per the <date> changelog." Short, sourced, original phrasing, none of it a stand-in for the docs themselves.

Rules

  • MUST pass the retrieve-vs-answer gate before searching — KB-answerable or single-fact questions do not start a research campaign.
  • MUST scale the search budget to question complexity and write a plan for contested or multi-faceted questions.
  • MUST anchor every "latest / current / recent" query to the real current date, never the training cutoff.
  • MUST prefer primary and original sources over second-hand summaries.
  • MUST run more searches when credible sources conflict — never average, cherry-pick, or hide the disagreement.
  • MUST run the adversarial self-check before emitting a synthesized claim, and apply the corrective action when a gate trips.
  • MUST verify high-stakes claims (money, health, legal, security, irreversible) against an independent second source or angle.
  • NEVER fabricate an attribution; if unsure a source said it, omit the claim.
  • NEVER let one source's paraphrased footprint dominate, and never let the output substitute for reading the originals.
  • CRITICAL: on empty retrieval, declare "not found in available sources" and cite nothing — do not backfill from memory.
  • Authorized security work is in scope. For sanctioned defensive analysis, CTF, vulnerability research, or pentest engagements, research and report on attack techniques, CVEs, exploit mechanics, and adversary tradecraft normally — the skepticism rules raise source quality, they do not gate legitimate security topics.

When NOT to Use

  • For a single stable fact already in the project KB or answerable in one lookup — use research-mastery (KB-first hierarchy) instead, or just answer.
  • For library / framework / API documentation — query context7 (or research-mastery's MCP tier) for current docs rather than fanning out on the open web.
  • When you need a tool that actually fetches — this skill is methodology only. Pair it with WebSearch / WebFetch or the runtime deep-research command; it retrieves nothing on its own.

© softspark, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in app/skills/deep-research of softspark/ai-toolkit.

Open the folder on GitHubat commit d64db2b

Compare with similar skills

Deep Research next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Deep Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deep Research this skillsoftspark/ai-toolkit179—~2.5kAutomated safety check: PassApache-2.0
GitHub Deep Researchbytedance/deer-flow83k5 repos~1.3kAutomated safety check: PassMIT
Deep Research WorkflowTokenRhythm/opensquilla7.1k—~1.3kAutomated safety check: PassApache-2.0
X Researchrohunvora/x-research-skill1.2k1 repos~1.6kAutomated safety check: PassNone
Deep Researchsanjay3290/ai-skills43110 repos~683Automated safety check: NotesApache-2.0
ResearchWeizhena/Deep-Research-skills2.3k3 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    83k GitHub starsUsed in 5 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • Deep Research Workflow

    TokenRhythm/opensquilla

    Runs multi-round research in three stages with a persisted state file, evidence tracking and a long-form report with per-claim citations.

    7.1k GitHub stars~1.3k tokensUpdated 4 days ago
    Research & ScienceAuto-check passed
  • X Research

    rohunvora/x-research-skill

    General-purpose X/Twitter research agent. An agent skill from rohunvora/x-research-skill.

    1.2k GitHub starsUsed in 1 repo~1.6k tokens
    Research & ScienceAuto-check passed
  • Deep Research

    sanjay3290/ai-skills

    Execute autonomous multi-step research using Google Gemini Deep Research Agent.

    431 GitHub starsUsed in 10 repos~683 tokens
    Research & ScienceAuto-check: notes
  • Research

    Weizhena/Deep-Research-skills

    Conduct preliminary research on a topic and generate research outline.

    2.3k GitHub starsUsed in 3 repos~1.1k tokens
    Research & ScienceAuto-check passed
  • Horizontal-Vertical Deep Research

    KKKKhazix/khazix-skills

    Runs a two-axis deep research method on a product, company, concept or person: its full history over time, compared with peers today, delivered as a typeset PDF report.

    21k GitHub stars~2.1k tokensUpdated 7 days ago
    Research & ScienceAuto-check passed

More from softspark/ai-toolkit

All 112 skills in this repo
  • Prepare Test Env

    softspark/ai-toolkit

    Prepare or verify a project QA environment with source identity, readiness, browser access, evidence paths and owned cleanup.

    179 GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check: notes
  • A11y Validate

    softspark/ai-toolkit

    Accessibility validator: WCAG 2.1 AA, EN 301 549, EAA. An agent skill from softspark/ai-toolkit.

    179 GitHub stars~3.8k tokensUpdated 2 days ago
    Auto-check: notes
  • Analyze

    softspark/ai-toolkit

    Analyzes code quality, complexity, patterns across codebase.

    179 GitHub stars~1k tokensUpdated 2 days ago
    Auto-check passed
  • Autonomous Dev

    softspark/ai-toolkit

    Drives a brief, specification, issue or existing PR through implementation, review, tests and QA to a ready PR.

    179 GitHub stars~2.6k tokensUpdated 2 days ago
    Auto-check: notes
  • Brand Voice

    softspark/ai-toolkit

    Direct technical voice for docs, README, user-facing text. An agent skill from softspark/ai-toolkit.

    179 GitHub stars~2.1k tokensUpdated 2 days ago
    Auto-check passed
  • CI

    softspark/ai-toolkit

    Detect/generate/debug CI pipeline config (GitHub Actions, GitLab CI).

    179 GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check: notes

Questions about Deep Research

What does Deep Research do?

Multi-source web research methodology: retrieve-vs-answer gate, complexity-scaled search budget, query craft, primary-source preference, source-conflict skepticism, adversarial verification…. Deep Research is an agent skill from softspark/ai-toolkit. Multi-source web research methodology: retrieve-vs-answer gate, complexity-scaled search budget, query craft, primary-source preference, source-conflict skepticism, adversarial verification, attribution-without-reproduction.

When should I use Deep Research?

Deep Research fits situations like: tasks that involve Deep research.

How do I install Deep Research in Claude Code?

Run `npx skills add softspark/ai-toolkit --skill deep-research -a claude-code`. Or copy the skill folder (app/skills/deep-research in softspark/ai-toolkit) into .claude/skills/deep-research in your project. Claude Code loads it when a task matches its description.

How do I install Deep Research in Codex?

Run `npx skills add softspark/ai-toolkit --skill deep-research -a codex`. Or copy the skill folder (app/skills/deep-research in softspark/ai-toolkit) into .agents/skills/deep-research in your project. Codex loads it when a task matches its description.

Can I use Deep Research in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add softspark/ai-toolkit --skill deep-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/deep-research, .gemini/skills/deep-research, .github/skills/deep-research and .opencode/skills/deep-research in your project.

What does Deep Research need to run?

SKILL.md names no scripts, command-line tools or credentials: Deep Research is instructions for the agent only. Its frontmatter pre-approves these tools: Read.

Does Deep Research access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Deep Research safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Deep Research use?

Deep Research is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Deep Research use?

About 2.5k tokens (SKILL.md is roughly 9.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Deep Research?

Skills that share tags, products or a category with Deep Research: GitHub Deep Research (bytedance/deer-flow, 83k stars), Deep Research Workflow (TokenRhythm/opensquilla, 7.1k stars), X Research (rohunvora/x-research-skill, 1.2k stars) and Deep Research (sanjay3290/ai-skills, 431 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deep Research?

softspark (a GitHub user) maintains it in softspark/ai-toolkit, which has 179 GitHub stars. The repository holds 112 skills in this directory. The repository was last updated on October 7, 2026.

Source: softspark/ai-toolkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.