Agent skill

Research Report

by Weizhena in Weizhena/Deep-Research-skills

“将deep调研结果汇总为markdown报告,覆盖所有字段,跳过不确定值。”

— description from SKILL.md by Weizhena
MITAuto-check: notesResearch & Science

Install Research Report

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

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

GitHub CLI
$ gh skill install Weizhena/Deep-Research-skills research-report --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-zh/research-report .claude/skills/research-report && 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-report
GitHub stars
2.3k
Used in
1 other repo
Token cost
~568 tokens
SKILL.md length
105 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

  • Works in 4 steps: 定位结果目录 → 扫描可选摘要字段 → 生成Python转换脚本 → …
  • SKILL.md covers 触发方式, 执行流程 and 输出
  • Calls python

About this skill

Research Report is a skill in Weizhena/Deep-Research-skills (2.3k stars). Its SKILL.md is about 568 tokens, and copies of it appear in 1 other owners' repositories. Licence: MIT.

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Glob, Bash, AskUserQuestion

Workflow steps

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

  1. 定位结果目录
  2. 扫描可选摘要字段
  3. 生成Python转换脚本
  4. 执行脚本

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
    • Bash
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    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 Report loads about 568 tokens when it runs. Until then it costs about 13 tokens; SKILL.md has 105 words of instructions outside code blocks.

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

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.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Glob, Bash, AskUserQuestion

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). 105 words, ~568 tokens.

Download SKILL.mdSave it as .claude/skills/research-report/SKILL.md (or your agent's skills folder).
name
research-report
description
将deep调研结果汇总为markdown报告,覆盖所有字段,跳过不确定值。
allowed-tools
Read, Write, Glob, Bash, AskUserQuestion
user-invocable
true

Research Report - 汇总报告

触发方式

/research-report

执行流程

Step 1: 定位结果目录

在当前工作目录查找 */outline.yaml,读取topic和output_dir配置。

Step 2: 扫描可选摘要字段

读取所有JSON结果,提取适合在目录中显示的字段(数值型、简短指标),例如:

  • github_stars
  • google_scholar_cites
  • swe_bench_score
  • user_scale
  • valuation
  • release_date

使用AskUserQuestion询问用户:

  • 目录中除了item名称外,还需要显示哪些字段?
  • 提供动态选项列表(基于实际JSON中存在的字段)
Step 3: 生成Python转换脚本

在 {topic}/ 目录下生成 generate_report.py,脚本要求:

  • 读取output_dir下所有JSON
  • 读取fields.yaml获取字段结构
  • 覆盖每个JSON的所有字段值
  • 跳过值包含[不确定]的字段
  • 跳过uncertain数组中列出的字段
  • 生成markdown报告格式:目录(带锚点跳转+用户选择的摘要字段)+ 详细内容(按字段分类)
  • 保存到 {topic}/report.md

目录格式要求:

  • 必须包含每一个item
  • 每个item显示:序号、名称(锚点链接)、用户选择的摘要字段
  • 示例:1. [GitHub Copilot](#github-copilot) - Stars: 10k | Score: 85%
脚本技术要点(必须遵循)

1. JSON结构兼容 支持两种JSON结构:

  • 扁平结构:字段直接在顶层 {"name": "xxx", "release_date": "xxx"}
  • 嵌套结构:字段在category子dict中 {"basic_info": {"name": "xxx"}, "technical_features": {...}}

字段查找顺序:顶层 -> category映射key -> 遍历所有嵌套dict

2. Category多语言映射 fields.yaml的category名与JSON的key可能是任意组合(中中、中英、英中、英英)。必须建立双向映射:

python
CATEGORY_MAPPING = {
    "基本信息": ["basic_info", "基本信息"],
    "技术特性": ["technical_features", "technical_characteristics", "技术特性"],
    "性能指标": ["performance_metrics", "performance", "性能指标"],
    "里程碑意义": ["milestone_significance", "milestones", "里程碑意义"],
    "商业信息": ["business_info", "commercial_info", "商业信息"],
    "竞争与生态": ["competition_ecosystem", "competition", "竞争与生态"],
    "历史沿革": ["history", "历史沿革"],
    "市场定位": ["market_positioning", "market", "市场定位"],
}

3. 复杂值格式化

  • list of dicts(如key_events, funding_history):每个dict格式化为一行,用|分隔kv
  • 普通list:短列表用逗号连接,长列表换行显示
  • 嵌套dict:递归格式化,用分号或换行显示
  • 长文本字符串(超过100字符):添加换行符<br>或使用blockquote格式,提高可读性

4. 额外字段收集 收集JSON中有但fields.yaml中没定义的字段,放入"其他信息"分类。注意过滤:

  • 内部字段:_source_file, uncertain
  • 嵌套结构顶级key:basic_info, technical_features等
  • uncertain数组:需要逐行显示每个字段名,不要压缩成一行

5. 不确定值跳过 跳过条件:

  • 字段值包含[不确定]字符串
  • 字段名在uncertain数组中
  • 字段值为None或空字符串
Step 4: 执行脚本

运行 python {topic}/generate_report.py

输出

  • {topic}/generate_report.py - 转换脚本
  • {topic}/report.md - 汇总报告

© 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

Just SKILL.md in skills/research-zh/research-report of Weizhena/Deep-Research-skills.

Open the folder on GitHubat commit 6ce38f6

Used in 1 other repository

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

Compare with similar skills

Research Report 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 Report compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research Report this skillWeizhena/Deep-Research-skills2.3k1 repos~568Automated safety check: NotesMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
Deep Research WorkflowTokenRhythm/opensquilla7.1k—~1.3kAutomated safety check: PassApache-2.0
Deep Researchsanjay3290/ai-skills4329 repos~683Automated safety check: NotesApache-2.0
Horizontal-Vertical Deep ResearchKKKKhazix/khazix-skills21k—~2.1kAutomated safety check: PassMIT
Academic Research PipelineImbad0202/academic-research-skills51k—~15kAutomated safety check: PassCustom licence

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.

    84k GitHub starsUsed in 4 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 today
    Research & ScienceAuto-check passed
  • Deep Research

    sanjay3290/ai-skills

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

    432 GitHub starsUsed in 9 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 9 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 yesterday
    Research & ScienceAuto-check passed
  • Academic Research Suite for Codex

    Imbad0202/academic-research-skills-codex

    A router skill that sends academic work such as literature reviews, drafting, citation checks, peer review and revision to the right workflow in the ARS suite.

    12k GitHub stars~12k tokensUpdated 6 days ago
    Research & ScienceAuto-check passed

More from Weizhena/Deep-Research-skills

All 10 skills in this repo
  • Research

    Weizhena/Deep-Research-skills

    Conduct preliminary research on a topic and generate research outline.

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

    Weizhena/Deep-Research-skills

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

    2.3k GitHub starsUsed in 2 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 2 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 1 repo~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 1 repo~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 2 repos~238 tokens
    Auto-check: notes

Questions about Research Report

How do I install Research Report in Claude Code?

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

How do I install Research Report in Codex?

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

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

What does Research Report need to run?

Going by SKILL.md and its folder, Research Report needs the command-line tools its instructions call (python). Its frontmatter pre-approves these tools: Read, Write, Glob, Bash, AskUserQuestion.

Does Research Report 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 Report safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Research Report use?

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

About 568 tokens (SKILL.md is roughly 2.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 Report?

Skills that share tags, products or a category with Research Report: GitHub Deep Research (bytedance/deer-flow, 84k stars), Deep Research Workflow (TokenRhythm/opensquilla, 7.1k stars), Deep Research (sanjay3290/ai-skills, 432 stars) and Horizontal-Vertical Deep Research (KKKKhazix/khazix-skills, 21k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research Report?

Weizhena (a GitHub user) maintains it in Weizhena/Deep-Research-skills, which has 2,322 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.