Agent skill

Research

by Weizhena in Weizhena/Deep-Research-skills

Conduct preliminary research on a topic and generate research outline.

MITAuto-check passedResearch & Science

Install Research

skills CLI
$ npx skills add Weizhena/Deep-Research-skills --skill research -a claude-code

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

GitHub CLI
$ gh skill install Weizhena/Deep-Research-skills 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/Weizhena/Deep-Research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/research-en/research .claude/skills/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
research
GitHub stars
2.3k
Used in
3 other repos
Token cost
~1.1k tokens
SKILL.md length
253 words
Files
2
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Conduct preliminary research on a topic and generate research outline.

  • Works in 5 steps: Generate Initial Framework from Model… → Web Search Supplement → Ask User for Existing Fields → …
  • Tasks that involve Deep research
  • SKILL.md covers Trigger, Workflow, Output Path and Follow-up Commands
  • Runs Python scripts from its folder

What it does

Research is an agent skill from Weizhena/Deep-Research-skills. Conduct preliminary research on a topic and generate research outline. For academic research, benchmark research, technology selection, etc.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `validate_json.py`).

It sits in Research & Science, covering Deep research. The repository describes itself as: Structured deep research skill for Claude Code/Open Code/Codex with human-in-the-loop control. The licence is MIT.

When your agent uses it

  • Tasks that involve Deep research

Example prompts

  • “/research”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Read, Write, Glob, WebSearch, Task, AskUserQuestion

Workflow steps

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

  1. Generate Initial Framework from Model Knowledge
  2. Web Search Supplement
  3. Ask User for Existing Fields
  4. Generate Outline (Separate Files)
  5. Output and Confirm

What it can do on your machine

Read from SKILL.md and the folder at commit 6ce38f6. 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
    • Write
    • Glob
    • WebSearch
    • Task
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    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

Research loads about 1.1k tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 253 words of instructions outside code blocks.

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

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 Weizhena/Deep-Research-skills at commit 6ce38f6, republished under its MIT licence (© Weizhena). 253 words, ~1,084 tokens.

Download SKILL.mdSave it as .claude/skills/research/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
research
description
Conduct preliminary research on a topic and generate research outline. For academic research, benchmark research, technology selection, etc.
allowed-tools
Read, Write, Glob, WebSearch, Task, AskUserQuestion
user-invocable
true

Research Skill - Preliminary Research

Trigger

/research <topic>

Workflow

Step 1: Generate Initial Framework from Model Knowledge

Based on topic, use model's existing knowledge to generate:

  • Main research objects/items list in this domain
  • Suggested research field framework

Output {step1_output}, use AskUserQuestion to confirm:

  • Need to add/remove items?
  • Does field framework meet requirements?
Step 2: Web Search Supplement

Use AskUserQuestion to ask for time range (e.g., last 6 months, since 2024, unlimited).

Parameter Retrieval:

  • {topic}: User input research topic
  • {YYYY-MM-DD}: Current date
  • {step1_output}: Complete output from Step 1
  • {time_range}: User specified time range

Hard Constraint: The following prompt must be strictly reproduced, only replacing variables in {xxx}, do not modify structure or wording.

Launch 1 web-search-agent (background), Prompt Template:

python
prompt = f"""## Task
Research topic: {topic}
Current date: {YYYY-MM-DD}

Based on the following initial framework, supplement latest items and recommended research fields.

## Existing Framework
{step1_output}

## Goals
1. Verify if existing items are missing important objects
2. Supplement items based on missing objects
3. Continue searching for {topic} related items within {time_range} and supplement
4. Supplement new fields

## Output Requirements
Return structured results directly (do not write files):

### Supplementary Items
- item_name: Brief explanation (why it should be added)
...

### Recommended Supplementary Fields
- field_name: Field description (why this dimension is needed)
...

### Sources
- [Source1](url1)
- [Source2](url2)
"""

One-shot Example (assuming researching AI Coding History):

## Task
Research topic: AI Coding History
Current date: 2025-12-30

Based on the following initial framework, supplement latest items and recommended research fields.

## Existing Framework
### Items List
1. GitHub Copilot: Developed by Microsoft/GitHub, first mainstream AI coding assistant
2. Cursor: AI-first IDE, based on VSCode
...

### Field Framework
- Basic Info: name, release_date, company
- Technical Features: underlying_model, context_window
...

## Goals
1. Verify if existing items are missing important objects
2. Supplement items based on missing objects
3. Continue searching for AI Coding History related items within since 2024 and supplement
4. Supplement new fields

## Output Requirements
Return structured results directly (do not write files):

### Supplementary Items
- item_name: Brief explanation (why it should be added)
...

### Recommended Supplementary Fields
- field_name: Field description (why this dimension is needed)
...

### Sources
- [Source1](url1)
- [Source2](url2)
Step 3: Ask User for Existing Fields

Use AskUserQuestion to ask if user has existing field definition file, if so read and merge.

Step 4: Generate Outline (Separate Files)

Merge {step1_output}, {step2_output} and user's existing fields, generate two files:

outline.yaml (items + config):

  • topic: Research topic
  • items: Research objects list
  • execution:
    • batch_size: Number of parallel agents (confirm with AskUserQuestion)
    • items_per_agent: Items per agent (confirm with AskUserQuestion)
    • output_dir: Results output directory (default: ./results)

fields.yaml (field definitions):

  • Field categories and definitions
  • Each field's name, description, detail_level
  • detail_level hierarchy: brief -> moderate -> detailed
  • uncertain: Uncertain fields list (reserved field, auto-filled in deep phase)
Step 5: Output and Confirm
  • Create directory: ./{topic_slug}/
  • Save: outline.yaml and fields.yaml
  • Show to user for confirmation

Output Path

{current_working_directory}/{topic_slug}/
  ├── outline.yaml    # items list + execution config
  └── fields.yaml     # field definitions

Follow-up Commands

  • /research-add-items - Supplement items
  • /research-add-fields - Supplement fields
  • /research-deep - Start deep research

© Weizhena, 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-en/research of Weizhena/Deep-Research-skills.

  • SKILL.md
  • validate_json.py

Open the folder on GitHubat commit 6ce38f6

Used in 3 other repositories

We found 13 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in Weizhena/Deep-Research-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

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.

Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research this skillWeizhena/Deep-Research-skills2.3k3 repos~1.1kAutomated safety check: PassMIT
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
Horizontal-Vertical Deep ResearchKKKKhazix/khazix-skills21k—~2.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
  • 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
  • Academic Research Pipeline

    Imbad0202/academic-research-skills

    Orchestrates a ten-stage academic workflow from research to finished manuscript, including integrity checks, two rounds of peer review and revision.

    51k GitHub stars~15k tokensUpdated 5 days ago
    Research & ScienceAuto-check passed

More from Weizhena/Deep-Research-skills

All 10 skills in this repo
  • Research Deep

    Weizhena/Deep-Research-skills

    Read research outline, launch independent agent for each item for deep research.

    2.3k GitHub starsUsed in 3 repos~850 tokens
    Auto-check: notes
  • Research Report

    Weizhena/Deep-Research-skills

    Summarize deep research results into markdown report, cover all fields, skip uncertain values.

    2.3k GitHub starsUsed in 3 repos~963 tokens
    Auto-check: notes
  • Research

    Weizhena/Deep-Research-skills

    对目标话题进行初步调研,生成调研outline。用于学术调研、benchmark调研、技术选型等场景. An agent skill from Weizhena/Deep-Research-skills.

    2.3k GitHub starsUsed in 2 repos~603 tokens
    Auto-check passed
  • Research Deep

    Weizhena/Deep-Research-skills

    读取调研outline,为每个item启动独立agent进行深度调研。禁用task output. An agent skill from Weizhena/Deep-Research-skills.

    2.3k GitHub starsUsed in 2 repos~521 tokens
    Auto-check: notes
  • Research Add Fields

    Weizhena/Deep-Research-skills

    Add field definitions to existing research outline. An agent skill from Weizhena/Deep-Research-skills.

    2.3k GitHub starsUsed in 3 repos~238 tokens
    Auto-check: notes
  • Research Add Items

    Weizhena/Deep-Research-skills

    Add items (research objects) to existing research outline. An agent skill from Weizhena/Deep-Research-skills.

    2.3k GitHub starsUsed in 3 repos~204 tokens
    Auto-check: notes

Questions about Research

What does Research do?

Conduct preliminary research on a topic and generate research outline. Research is an agent skill from Weizhena/Deep-Research-skills. Conduct preliminary research on a topic and generate research outline.

When should I use Research?

Research fits situations like: tasks that involve Deep research.

How do I install Research in Claude Code?

Run `npx skills add Weizhena/Deep-Research-skills --skill research -a claude-code`. Or copy the skill folder (skills/research-en/research in Weizhena/Deep-Research-skills) into .claude/skills/research in your project. Claude Code loads it when a task matches its description.

How do I install Research in Codex?

Run `npx skills add Weizhena/Deep-Research-skills --skill research -a codex`. Or copy the skill folder (skills/research-en/research in Weizhena/Deep-Research-skills) into .agents/skills/research in your project. Codex loads it when a task matches its description.

Can I use 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 Weizhena/Deep-Research-skills --skill 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/research, .gemini/skills/research, .github/skills/research and .opencode/skills/research in your project.

What does Research need to run?

Going by SKILL.md and its folder, Research needs Python for the scripts in its folder. Our summary lists: Python 3. Its frontmatter pre-approves these tools: Read, Write, Glob, WebSearch, Task, AskUserQuestion.

Does 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 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 Research use?

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 Research use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Research?

Skills that share tags, products or a category with 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 Research?

Weizhena (a GitHub user) maintains it in Weizhena/Deep-Research-skills, which has 2,312 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on August 23, 2026.

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