New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Deep Research

by davidondrej in davidondrej/skills

Run deep research through DeepAPI and save a report with sources.

MITAuto-check passedResearch & Science

Install Deep Research

skills CLI
$ npx skills add davidondrej/skills --skill deep-research -a claude-code

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

GitHub CLI
$ gh skill install davidondrej/skills 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/davidondrej/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/research-and-web/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
4.1k
Token cost
~705 tokens
SKILL.md length
277 words
Files
2
Skills in repo
51
Repo updated
First seen
Licence
MIT

At a glance

Run deep research through DeepAPI and save a report with sources.

  • Works in 3 steps: Build the prompt → Run it → Save the report
  • Asked for deep research
  • SKILL.md covers API key, 1. Build the prompt, 2. Run it and 3. Save the report, plus 1 more section
  • Calls jq and curl; needs API_KEY

What it does

Deep Research is an agent skill from davidondrej/skills. Run deep research through DeepAPI and save a report with sources. Use when asked for deep research, DeepAPI research, or Perplexity deep research.

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Research & Science, covering Deep research. It works with Perplexity. The repository describes itself as: access to david ondrej's personal agent skills. The licence is MIT.

When your agent uses it

  • Asked for deep research
  • DeepAPI research
  • Perplexity deep research

Example prompts

  • “/deep-research”

Requirements

  • A credential in API_KEY

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Build the prompt
  2. Run it
  3. Save the report

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq
    • curl

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

  • Network

    No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • API_KEY

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

Context cost

Deep Research loads about 705 tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 277 words of instructions outside code blocks.

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

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 davidondrej/skills at commit 7874889, republished under its MIT licence (© davidondrej). 277 words, ~705 tokens.

Download SKILL.mdSave it as .claude/skills/deep-research/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
deep-research
description
Run deep research through DeepAPI and save a report with sources. Use when asked for deep research, DeepAPI research, or Perplexity deep research.
disable-model-invocation
true
triggers
user, model

Deep Research

Use DeepAPI (POST /v1/research/deep) for all deep research.

API key

Read the API key from the environment or your configured secret store. Never source ~/.zshrc; it breaks the shell (exit 126).

bash
KEY=${API_KEY:?Set API_KEY in the environment}
BASE=${DEEPAPI_API_BASE_URL:-https://deepapi.co}

If the key is missing, stop and ask the user. Never print or log it. Get a key at deepapi.co.

1. Build the prompt

Follow the research-prompt skill. Write one self-contained paragraph:

  • Lead with the main question and the decision it informs.
  • Include all context and 3-6 numbered sub-questions. Keep one mission per prompt.
  • State what to include or avoid. Prefer primary sources; separate fact from inference.

Field limits: query ≤ 4000 characters (the prompt), optional context ≤ 8000, optional instructions ≤ 2000. Do not send model or provider; the API rejects them.

2. Run it

One call returns a cited answer, targeting 700-1,120 words. The server allows up to ~5 minutes.

bash
IDK=$(uuidgen)   # keep this; retries must reuse the SAME Idempotency-Key
jq -n --rawfile p /tmp/dr_prompt.txt '{query:$p, maxCostUsd:"0.70"}' > /tmp/dr_body.json
curl -s --max-time 320 "$BASE/v1/research/deep" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDK" \
  -d @/tmp/dr_body.json > /tmp/dr_result.json

Minimum maxCostUsd is "0.35". Default to "0.70"; ask the user before raising it.

3. Save the report

bash
jq -r '.status'                    /tmp/dr_result.json   # succeeded | failed
jq -r '.output.answer'             /tmp/dr_result.json   # the report
jq -r '.output.sources[]?.url'     /tmp/dr_result.json   # source URLs

Save a Markdown report with citation URLs beneath it. Only report costs if the user asks. If the answer has [n] citations but output.sources is empty, deliver it and tell the user.

For longer reports, run each numbered sub-question separately with its own Idempotency-Key, then combine the answers and sources into one Markdown file.

Failures and retries

  • HTTP 402 insufficient_credits: stop for a top-up at deepapi.co/credits, then retry with the same Idempotency-Key.
  • HTTP 429 rate_limit_exceeded: wait Retry-After seconds, then retry once.
  • status: failed / HTTP 502: report requestId and error.message. Do not retry in a loop.
  • Reusing an Idempotency-Key returns HTTP 200 with replayed: true and no new charge.
  • See the deepapi skill for envelope/auth details and other endpoints.

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

Files

SKILL.md and 1 other file in skills/research-and-web/deep-research of davidondrej/skills.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 7874889

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 skilldavidondrej/skills4.1k—~705Automated safety check: PassMIT
Librariumjkudish/librarium134—~1.9kAutomated safety check: PassMIT
Bmad Deep Recondelorenj/mcp-server-trello445—~2.3kAutomated safety check: PassMIT
Deep Researchjuanandresgs/claude-ctrl193—~3.1kAutomated safety check: NotesNone
Brain-Augmented Web Researchgarrytan/gbrain31k—~2kAutomated safety check: NotesMIT
Weekly Signal DiffNateBJones-Projects/OB14.7k—~1.7kAutomated safety check: PassCustom licence

Similar skills

  • Librarium

    jkudish/librarium

    Runs evidence-aware, multi-provider research with the Librarium v2 CLI.

    134 GitHub stars~1.9k tokensUpdated yesterday
    Research & ScienceAuto-check passed

  • Bmad Deep Recon

    delorenj/mcp-server-trello

    Decision-grade research, three ways: draft a deep-research prompt for the user to run in their own tool (ChatGPT, Gemini, Grok, Perplexity, …), process a finished research report — file it, distill…

    445 GitHub stars~2.3k tokensUpdated 16 days ago
    Research & ScienceAuto-check passed

  • Deep Research

    juanandresgs/claude-ctrl

    Multi-model deep research with comparative assessment (OpenAI + Perplexity + Gemini).

    193 GitHub stars~3.1k tokensUpdated 2 mo ago
    Research & ScienceAuto-check: notes

  • Brain-Augmented Web Research

    garrytan/gbrain

    Sends what your notes already know about a topic to Perplexity, so the cited web search reports only what is new, such as entity updates or deal changes.

    31k GitHub stars~2k tokensUpdated today
    Research & ScienceAuto-check: notes

  • Weekly Signal Diff

    NateBJones-Projects/OB1

    Turns a noisy week of AI or software market news into a short list of structural changes, weighted by what the user already tracks in Open Brain memory.

    4.7k GitHub stars~1.7k tokensUpdated yesterday
    Research & ScienceAuto-check passed

  • Research Lookup

    K-Dense-AI/claude-scientific-writer

    Compile current scholarly evidence for a scientific manuscript or research brief.

    2.4k GitHub starsUsed in 2 repos~3.6k tokens
    Research & ScienceAuto-check passed

More from davidondrej/skills

All 51 skills in this repo

  • Nagent

    davidondrej/skills

    Launch a new bb worker thread with the right project, model, worktree, and task brief.

    4.1k GitHub stars~1.7k tokensUpdated 2 days ago
    Auto-check: notes

  • Browser Harness

    davidondrej/skills

    Direct browser control via CDP. An agent skill from davidondrej/skills.

    4.1k GitHub starsUsed in 2 repos~3k tokens
    Auto-check passed

  • Persistent Localhost

    davidondrej/skills

    Manage persistent dev servers, APIs, and other local processes on a port using macOS LaunchAgents.

    4.1k GitHub stars~618 tokensUpdated 2 days ago
    Auto-check passed

  • Reset Cursor Acp

    davidondrej/skills

    Reset a stuck Cursor ACP thread in <chat-system and reload its configuration.

    4.1k GitHub stars~728 tokensUpdated 2 days ago
    Auto-check passed

  • Anti Sleep

    davidondrej/skills

    Keep a Mac awake for a set duration or while a process runs.

    4.1k GitHub stars~640 tokensUpdated 2 days ago
    Auto-check: warnings

  • Bb CLI

    davidondrej/skills

    Use this when controlling bb. An agent skill from davidondrej/skills.

    4.1k GitHub stars~823 tokensUpdated 2 days ago
    Auto-check passed

Works with

Categories

Questions about Deep Research

What does Deep Research do?

Run deep research through DeepAPI and save a report with sources. Deep Research is an agent skill from davidondrej/skills. Run deep research through DeepAPI and save a report with sources.

When should I use Deep Research?

Deep Research fits situations like: asked for deep research; deepAPI research; perplexity deep research.

How do I install Deep Research in Claude Code?

Run `npx skills add davidondrej/skills --skill deep-research -a claude-code`. Or copy the skill folder (skills/research-and-web/deep-research in davidondrej/skills) 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 davidondrej/skills --skill deep-research -a codex`. Or copy the skill folder (skills/research-and-web/deep-research in davidondrej/skills) 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 davidondrej/skills --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?

Going by SKILL.md and its folder, Deep Research needs the command-line tools its instructions call (jq and curl) and credentials named API_KEY. Our summary lists: A credential in API_KEY.

Does Deep Research access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. 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 MIT 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 705 tokens (SKILL.md is roughly 2.8k 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: Librarium (jkudish/librarium, 134 stars), Bmad Deep Recon (delorenj/mcp-server-trello, 445 stars), Deep Research (juanandresgs/claude-ctrl, 193 stars) and Brain-Augmented Web Research (garrytan/gbrain, 31k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deep Research?

davidondrej (a GitHub user) maintains it in davidondrej/skills, which has 4,112 GitHub stars. The repository holds 51 skills in this directory. The repository was last updated on October 8, 2026.

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