Agent skill

Deep Research

by 21pounder in 21pounder/terminalAgent

Conduct comprehensive deep research on any topic using Dify-powered workflow - searches documentation, academic papers, tutorials, APIs, best practices, and returns structured analysis with insights.

Apache-2.0Auto-check: notesResearch & Science

Install Deep Research

skills CLI
$ npx skills add 21pounder/terminalAgent --skill deep-research -a claude-code

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

GitHub CLI
$ gh skill install 21pounder/terminalAgent 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/21pounder/terminalAgent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/deepresearch/.claude/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
120
Used in
2 other repos
Token cost
~883 tokens
SKILL.md length
258 words
Files
2 (incl. scripts)
Skills in repo
4
Repo updated
First seen
Licence
Apache-2.0

At a glance

Conduct comprehensive deep research on any topic using Dify-powered workflow - searches documentation, academic papers, tutorials, APIs, best practices, and returns structured analysis with insights.

  • Works in 4 steps: Locate the Client Script → Execute Research → Process Results → …
  • Tasks that involve Deep research
  • SKILL.md covers Parameters, Workflow, Error Handling and Output Format, plus 1 more section
  • Runs TypeScript scripts from its folder; calls npx; needs DIFY_API_KEY

What it does

Deep Research is an agent skill from 21pounder/terminalAgent. Conduct comprehensive deep research on any topic using Dify-powered workflow - searches documentation, academic papers, tutorials, APIs, best practices, and returns structured analysis with insights.

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/dify-client.ts`).

It sits in Research & Science, covering Deep research. It works with Dify. The repository describes itself as: A powerful terminal coding agent based on Claude Agent SDK. Better then Claude Code when start up a new project, or u have no idea. Just try it. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Deep research

Example prompts

  • “/deep-research”

Requirements

  • Node.js
  • A credential in DIFY_API_KEY
  • Pre-approved tools (allowed-tools): Bash, Glob, Read

Workflow steps

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

  1. Locate the Client Script
  2. Execute Research
  3. Process Results
  4. Implement

What it can do on your machine

Read from SKILL.md and the folder at commit 989b029. 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:

    • Bash
    • Glob
    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use npx, 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:

    • DIFY_API_KEY

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

Context cost

Deep Research loads about 883 tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 258 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:97
    1. The script automatically loads `.env` from the project root (no manual env setup needed)
  • NoteMentions a .env fileSKILL.md:98
    2. If still failing, check that `.env` contains `DIFY_API_KEY` and `DIFY_BASE_URL`
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Glob, Read

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); the scripts in this folder are not scanned.

SKILL.md

The full file from 21pounder/terminalAgent at commit 989b029, republished under its Apache-2.0 licence (© 21pounder). 258 words, ~883 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
Conduct comprehensive deep research on any topic using Dify-powered workflow - searches documentation, academic papers, tutorials, APIs, best practices, and returns structured analysis with insights.
allowed-tools
Bash, Glob, Read
version
3.1.0

Deep Research (Dify Powered)

This skill delegates research tasks to a specialized Dify Workflow that:

  1. Searches official documentation, tutorials, and academic resources
  2. Analyzes the topic with DeepSeek Reasoner for deep insights
  3. Iteratively searches for examples, solutions, and related research
  4. Generates a comprehensive research report with structured findings

Use this skill for:

  • Code implementation research (APIs, libraries, best practices)
  • Academic paper analysis and literature review
  • Technology comparison and evaluation
  • Any topic requiring comprehensive, structured research

Parameters

json
{
  "type": "object",
  "properties": {
    "coding_task": {
      "type": "string",
      "description": "The coding task or question to research (required)"
    },
    "tech_stack": {
      "type": "string",
      "description": "Technology stack context (e.g., 'React 18, TypeScript, Next.js')"
    },
    "depth": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "default": 3,
      "description": "Research depth (1=quick, 3=standard, 5=comprehensive)"
    }
  },
  "required": ["coding_task"]
}

Workflow

Step 1: Locate the Client Script

The client script is at: .claude/skills/deep-research/scripts/dify-client.ts Use Glob to find the absolute path if needed.

Step 2: Execute Research

Use Bash to run the script with npx tsx:

bash
npx tsx "<path_to_script>" "<coding_task>" "<tech_stack>" <depth>

Examples:

bash
# Basic research
npx tsx ".claude/skills/deep-research/scripts/dify-client.ts" "How to implement OAuth2 in Next.js"

# With tech stack
npx tsx ".claude/skills/deep-research/scripts/dify-client.ts" "Add real-time notifications" "React 18, Socket.io"

# With depth
npx tsx ".claude/skills/deep-research/scripts/dify-client.ts" "Optimize database queries" "PostgreSQL, Prisma" 5
Step 3: Process Results

The script returns JSON with two main fields:

  • analysis: Task analysis with knowledge gaps and tech requirements
  • guide: Complete implementation guide with:
    • TASK_SUMMARY
    • DEPENDENCIES (install commands)
    • FILES_TO_CREATE (complete code)
    • FILES_TO_MODIFY (change instructions)
    • ENVIRONMENT_CONFIG
    • VERIFICATION (test commands)
    • GOTCHAS (common issues)
    • SOURCES
Step 4: Implement

Use the guide to:

  1. Install dependencies
  2. Create new files with provided code
  3. Modify existing files as instructed
  4. Set up environment variables
  5. Run verification commands

Error Handling

If the script returns an error:

  1. The script automatically loads .env from the project root (no manual env setup needed)
  2. If still failing, check that .env contains DIFY_API_KEY and DIFY_BASE_URL
  3. Verify the Dify API is accessible

Output Format

json
{
  "success": true,
  "data": {
    "analysis": "{ JSON task analysis }",
    "guide": "# Implementation Guide\n\n### TASK_SUMMARY\n..."
  },
  "metadata": {
    "duration_ms": 45000,
    "workflow_run_id": "abc123"
  }
}

When to Use

  • Complex implementation tasks requiring research
  • Integrating unfamiliar APIs or libraries
  • Finding best practices and working examples
  • Understanding new frameworks or patterns

© 21pounder, 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

SKILL.md and 1 other file (scripts) in deepresearch/.claude/skills/deep-research of 21pounder/terminalAgent.

  • SKILL.md
  • scripts/dify-client.ts

Open the folder on GitHubat commit 989b029

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in 21pounder/terminalAgent, which our catalogue first saw on October 7, 2026.

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 skill21pounder/terminalAgent1202 repos~883Automated safety check: NotesApache-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 21pounder/terminalAgent

  • Code Review

    21pounder/terminalAgent

    A skill your agent uses when user asks to "review code", "check for issues", "analyze code quality", "find bugs", or wants feedback on code implementation.

    120 GitHub starsUsed in 1 repo~650 tokens
    Auto-check passed
  • Git Commit

    21pounder/terminalAgent

    A skill your agent uses when user asks to "commit changes", "create a commit", "stage and commit", or wants help with git commit workflow.

    120 GitHub starsUsed in 1 repo~642 tokens
    Auto-check: notes
  • Web Scrape

    21pounder/terminalAgent

    Intelligent web scraper with content extraction, multiple output formats, and error handling

    120 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed

Works with

Questions about Deep Research

What does Deep Research do?

Conduct comprehensive deep research on any topic using Dify-powered workflow - searches documentation, academic papers, tutorials, APIs, best practices, and returns structured analysis with insights. Deep Research is an agent skill from 21pounder/terminalAgent. Conduct comprehensive deep research on any topic using Dify-powered workflow - searches documentation, academic papers, tutorials, APIs, best practices, and returns structured analysis with insights.

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 21pounder/terminalAgent --skill deep-research -a claude-code`. Or copy the skill folder (deepresearch/.claude/skills/deep-research in 21pounder/terminalAgent) 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 21pounder/terminalAgent --skill deep-research -a codex`. Or copy the skill folder (deepresearch/.claude/skills/deep-research in 21pounder/terminalAgent) 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 21pounder/terminalAgent --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 TypeScript for the scripts in its folder, the command-line tools its instructions call (npx) and credentials named DIFY_API_KEY. Our summary lists: Node.js; A credential in DIFY_API_KEY. Its frontmatter pre-approves these tools: Bash, Glob, Read.

Does Deep Research access the network?

SKILL.md contains no URLs. Its commands use npx, 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 notes only (mentions a .env file; pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

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 883 tokens (SKILL.md is roughly 3.5k 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?

21pounder (a GitHub user) maintains it in 21pounder/terminalAgent, which has 120 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on May 28, 2026.

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