Agent skill

Research To Diagram

by wshuyi in wshuyi/research-to-diagram

深度调研主题并自动生成知识关系图谱PDF。接收研究主题后自动进行网络调研、信息收集、知识整理,最终生成专业的可视化关系图谱。适用于"研究...并做图"、"深度分析...并可视化"、"生成知识图谱"等场景。

MITAuto-check passedDocuments & Office

Install Research To Diagram

skills CLI
$ npx skills add wshuyi/research-to-diagram --skill research-to-diagram -a claude-code

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

GitHub CLI
$ gh skill install wshuyi/research-to-diagram research-to-diagram --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/wshuyi/research-to-diagram.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/research-to-diagram .claude/skills/research-to-diagram && 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-to-diagram
GitHub stars
157
Used in
1 other repo
Token cost
~1.1k tokens
SKILL.md length
301 words
Files
8 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

深度调研主题并自动生成知识关系图谱PDF。接收研究主题后自动进行网络调研、信息收集、知识整理,最终生成专业的可视化关系图谱。适用于"研究...并做图"、"深度分析...并可视化"、"生成知识图谱"等场景。

  • Works in 6 steps: 任务规划(TodoWrite) → 深度调研阶段 → 结构设计阶段 → …
  • Tasks that involve Diagrams
  • SKILL.md covers Description, 核心特性, Trigger Conditions and Workflow, plus 10 more sections
  • Runs Shell scripts from its folder; calls brew and npm

What it does

Research To Diagram is an agent skill from wshuyi/research-to-diagram. 深度调研主题并自动生成知识关系图谱PDF。接收研究主题后自动进行网络调研、信息收集、知识整理,最终生成专业的可视化关系图谱。适用于"研究...并做图"、"深度分析...并可视化"、"生成知识图谱"等场景。

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including scripts (for example `COMPARISON.md`, `README.md` and `USAGE_EXAMPLES.md`).

It sits in Documents & Office, covering Diagrams and PDF. The repository describes itself as: Deep research and auto-generate knowledge relationship diagrams in PDF. From research to visualization in one tool. 深度调研并自动生成知识关系图谱PDF。 The licence is MIT.

When your agent uses it

  • Tasks that involve Diagrams
  • Tasks that involve PDF

Example prompts

  • “研究...并做图”
  • “深度分析...并可视化”
  • “生成知识图谱”
  • “/research-to-diagram”

Requirements

  • Node.js
  • A Bash shell

Workflow steps

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

  1. 任务规划(TodoWrite)
  2. 深度调研阶段
  3. 结构设计阶段
  4. 可视化实现
  5. PDF 生成
  6. 文档整理

What it can do on your machine

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

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

    Shell commands in SKILL.md call:

    • brew
    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use npm, 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 no API keys, tokens, secrets or passwords.

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

Context cost

Research To Diagram loads about 1.1k tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 301 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~31
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); the scripts in this folder are not scanned.

SKILL.md

The full file from wshuyi/research-to-diagram at commit c13ec59, republished under its MIT licence (© wshuyi). 301 words, ~1,112 tokens.

Download SKILL.mdSave it as .claude/skills/research-to-diagram/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
research-to-diagram
description
深度调研主题并自动生成知识关系图谱PDF。接收研究主题后自动进行网络调研、信息收集、知识整理,最终生成专业的可视化关系图谱。适用于"研究...并做图"、"深度分析...并可视化"、"生成知识图谱"等场景。

Research to Diagram

深度调研主题并自动生成知识关系图谱PDF。从研究到可视化的一站式工具。

Description

这个 Skill 接收用户提供的研究主题,自动进行深度网络调研、信息收集、知识整理、结构设计,最终生成专业的可视化关系图谱PDF。与 structure-to-pdf 不同,本 Skill 专注于主动研究和知识挖掘,而非被动的数据转换。

核心特性

  • 自动调研:使用 WebSearch 进行多轮深度调研
  • 智能整理:自动提取、分类、结构化信息
  • 专业设计:根据主题特点选择最佳可视化方案
  • 多种输出:支持 Graphviz、PlantUML、Mermaid 等工具
  • 高质量PDF:生成矢量图形,可无限缩放

Trigger Conditions

当用户想要:

  • 研究某个复杂主题的知识结构(如"红楼梦人物关系")
  • 生成人物关系图、概念图谱、知识图谱
  • 理解某个领域的组织架构、技术架构
  • 可视化复杂的关系网络
  • 需要从零开始研究并可视化某个主题

关键词:

  • "调研...并做图"
  • "研究...的关系"
  • "深度分析...并可视化"
  • "生成...知识图谱"
  • "画...关系图"(无现成数据)

Workflow

1. 任务规划(TodoWrite)
- 深度调研主题和相关知识
- 设计图谱结构和层次
- 创建可视化图表
- 生成PDF文档
2. 深度调研阶段
  • 多轮 WebSearch:从不同角度收集信息
    • 主题概述和背景
    • 核心要素和人物/概念
    • 关系和联系
    • 层次和分类
  • 信息源记录:保存所有参考资料链接
  • 知识提取:识别关键实体和关系
3. 结构设计阶段

根据主题类型选择最佳结构:

人物关系图:

  • 家族谱系:多层次树状结构
  • 社会网络:网状关系图
  • 组织架构:层次化布局

概念图谱:

  • 知识分类:树状或思维导图
  • 概念关系:有向图
  • 流程图:线性或分支流程

技术架构:

  • 系统组件:模块化布局
  • 依赖关系:层次或网络图
  • 数据流向:流程图
4. 可视化实现

优先使用 Graphviz (DOT 语言):

dot
digraph G {
    // 全局样式
    graph [rankdir=TB bgcolor="#fdfdf5" fontname="Arial Unicode MS"]
    node [shape=box style="rounded,filled" fillcolor="#e8f4f8"]
    edge [fontname="Arial Unicode MS"]

    // 使用 subgraph cluster 分组
    subgraph cluster_group1 {
        label="分组名称"
        node1 [label="节点1"]
        node2 [label="节点2"]
    }

    // 定义关系
    node1 -> node2 [label="关系类型" color=red]
}

备选工具:

  • PlantUML:UML 图、时序图
  • Mermaid:简单流程图、时序图
5. PDF 生成
bash
dot -Tpdf diagram.dot -o output.pdf
6. 文档整理

可选生成说明文档,包含:

  • 研究主题概述
  • 图谱说明
  • 参考资料来源(Sources)
  • 使用说明

设计原则

视觉设计
  1. 颜色编码:使用不同颜色区分类别
  2. 形状区分:不同类型实体用不同形状
  3. 层次清晰:使用 subgraph cluster 分组
  4. 关系标注:边的颜色、样式、标签表达关系类型
  5. 中文支持:使用 "Arial Unicode MS" 或系统中文字体
信息层次
  1. 标题层:主标题
  2. 分组层:主要类别/家族
  3. 实体层:具体人物/概念
  4. 关系层:连接和标注
  5. 图例层:说明符号含义
布局策略
  • rankdir=TB:自上而下(家族树、组织架构)
  • rankdir=LR:从左到右(流程图、时间线)
  • rankdir=BT:自下而上(依赖图)
  • splines=ortho:正交边(清晰的组织图)
  • splines=curved:曲线边(美观的关系网)

输出文件

默认保存位置:~/Downloads/ 或用户指定目录

生成文件:

  • <topic>_relations.dot - Graphviz 源文件
  • <topic>_relations.pdf - 最终PDF图谱
  • <topic>_sources.md - 参考资料(可选)

使用示例

示例 1:文学作品人物关系
用户:深度调查《三国演义》里人物之间的关系,然后做个结构图 PDF

Skill 执行:

  1. 调研三国主要人物、阵营、关系
  2. 设计:魏蜀吴三大阵营 + 人物层次 + 联盟/对抗关系
  3. 使用 Graphviz 创建多层次关系图
  4. 生成 PDF
示例 2:技术概念图谱
用户:研究 Kubernetes 架构并生成可视化图谱

Skill 执行:

  1. 调研 K8s 核心组件、架构层次
  2. 设计:控制平面/数据平面/插件生态
  3. 生成技术架构图
  4. 输出 PDF
示例 3:历史事件关系
用户:分析二战主要国家和联盟关系,做成图表

Skill 执行:

  1. 调研参战国家、阵营、关键时间节点
  2. 设计:轴心国/同盟国/中立国关系网
  3. 生成带时间线的关系图
  4. 输出 PDF

与 structure-to-pdf 的区别

特性research-to-diagramstructure-to-pdf
输入仅主题/研究问题现成的结构化数据
调研✅ 自动深度调研❌ 无需调研
知识整理✅ 自动提取和结构化❌ 直接使用用户数据
应用场景知识探索、研究可视化快速数据转换
时间较长(需调研)快速

何时使用本 Skill:

  • ✅ 没有现成数据,需要从零研究
  • ✅ 想要深度了解某个主题的知识结构
  • ✅ 需要权威来源支持的可视化

何时使用 structure-to-pdf:

  • ✅ 已有结构化数据
  • ✅ 需要快速转换为图表
  • ✅ 数据格式简单清晰

依赖工具

必需:

  • Graphviz: brew install graphviz (macOS)
  • WebSearch: Claude Code 内置

可选:

  • PlantUML: brew install plantuml
  • Mermaid CLI: npm install -g @mermaid-js/mermaid-cli

配置选项

用户可以通过参数自定义:

  • --tool: 指定可视化工具 (graphviz/plantuml/mermaid)
  • --layout: 指定布局方向 (TB/LR/BT/RL)
  • --output: 指定输出目录
  • --depth: 调研深度 (quick/medium/deep)
  • --sources: 是否生成参考资料文档

最佳实践

  1. 明确主题范围:主题越具体,图谱越清晰
  2. 合理分组:使用 cluster 将相关实体分组
  3. 控制复杂度:单个图谱不超过 50 个节点
  4. 渐进细化:先生成总览图,再深入细节
  5. 颜色一致:同类实体使用相同配色
  6. 标注来源:在 PDF 底部或单独文档标注参考资料

常见图谱类型模板

人物关系图模板
dot
- 家族/组织用 cluster 分组
- 人物用 box/ellipse,重要人物用特殊形状
- 血缘关系用实线,婚姻用红色,其他用虚线
- 添加图例说明符号含义
概念图谱模板
dot
- 顶层概念在上方
- 子概念逐层展开
- is-a 关系用实线,has-a 用虚线
- 使用颜色区分不同类别
技术架构图模板
dot
- 分层架构用 rankdir=TB
- 组件用矩形,服务用圆角矩形
- 依赖关系用箭头
- 关键路径用粗线或特殊颜色

故障排除

中文显示乱码:

dot
graph [fontname="Arial Unicode MS"]
node [fontname="Arial Unicode MS"]
edge [fontname="Arial Unicode MS"]

图谱过于复杂:

  • 使用 concentrate=true 合并相同边
  • 分割成多个子图
  • 使用不同的 rankdir

布局不理想:

  • 调整 ranksep 和 nodesep
  • 使用 rank=same 强制节点同层
  • 尝试不同的 splines 设置

版本历史

  • v1.0 (2026-01-02): 初始版本
    • 基于《红楼梦》人物关系图谱项目总结
    • 支持 Graphviz 自动生成
    • 集成 WebSearch 深度调研
    • TodoWrite 任务管理

© wshuyi, 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 7 other files (scripts) in skills/research-to-diagram of wshuyi/research-to-diagram.

  • SKILL.md
  • COMPARISON.md
  • README.md
  • USAGE_EXAMPLES.md
  • examples/character_relationships.dot
  • examples/concept_map.dot
  • examples/tech_architecture.dot
  • scripts/generate_pdf.sh

Open the folder on GitHubat commit c13ec59

Used in 1 other repository

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

Compare with similar skills

Research To Diagram 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 To Diagram compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research To Diagram this skillwshuyi/research-to-diagram1571 repos~1.1kAutomated safety check: PassMIT
Harness Book Best Practicewquguru/harness-books3.2k—~4.1kAutomated safety check: PassNone
Ky Markdown RebuilderKyrieCheungYep/ky-markdown-rebuilder117—~5.7kAutomated safety check: PassNone
Paper Interpreterchujianyun/skills742—~810Automated safety check: PassCustom licence
Gemini Document Processingeinverne/dotfiles121—~1.6kAutomated safety check: NotesGPL-3.0
Paper Interpreterdigoal/blog8.6k—~1.1kAutomated safety check: PassGPL-2.0

Similar skills

  • Harness Book Best Practice

    wquguru/harness-books

    Best practices for working on the Harness books repo. An agent skill from wquguru/harness-books.

    3.2k GitHub stars~4.1k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Ky Markdown Rebuilder

    KyrieCheungYep/ky-markdown-rebuilder

    Rebuild visual documents into reliable Markdown by combining text extraction with page or screenshot alignment.

    117 GitHub stars~5.7k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • Paper Interpreter

    chujianyun/skills

    论文解读助手。适用于用户发送 arXiv 论文链接,并希望下载论文、解读论文、生成读书笔记、做论文拆解或输出详细报告时使用。会在工作目录创建论文文件夹、下载 PDF 与 TeX Source(如有)、生成中文 Markdown 报告。默认先交付初稿,不自动复查;如果用户明确同意,再安排后续复查。不适用于只要简短推荐语的情况。

    742 GitHub stars~810 tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Guide for implementing Google Gemini API document processing - analyze PDFs with native vision to extract text, images, diagrams, charts, and tables.

    121 GitHub stars~1.6k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • 深度解读学术论文,将论文 PDF(文件或 URL)转化为通俗易懂、图文并茂的 Markdown 解读文档,保存到项目的 markdown/ 目录。触发条件:用户上传或提供论文 PDF、提到"解读论文"/"读论文"/"分析这篇论文"/"帮我看这篇 paper",或任何需要深入理解一篇学术论文的场景。即使用户只说"帮我看这个 PDF"但内容是论文,也应使用本…

    8.6k GitHub stars~1.1k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Report Writing

    GAIK-project/gaik-toolkit

    Converts scattered documents and media (recordings, notes, diagrams, PDFs, spreadsheets) into structured MS Word reports.

    100 GitHub stars~4.9k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed

Questions about Research To Diagram

What does Research To Diagram do?

深度调研主题并自动生成知识关系图谱PDF。接收研究主题后自动进行网络调研、信息收集、知识整理,最终生成专业的可视化关系图谱。适用于"研究...并做图"、"深度分析...并可视化"、"生成知识图谱"等场景。. Research To Diagram is an agent skill from wshuyi/research-to-diagram.

When should I use Research To Diagram?

Research To Diagram fits situations like: tasks that involve Diagrams; tasks that involve PDF.

How do I install Research To Diagram in Claude Code?

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

How do I install Research To Diagram in Codex?

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

Can I use Research To Diagram 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 wshuyi/research-to-diagram --skill research-to-diagram -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-to-diagram, .gemini/skills/research-to-diagram, .github/skills/research-to-diagram and .opencode/skills/research-to-diagram in your project.

What does Research To Diagram need to run?

Going by SKILL.md and its folder, Research To Diagram needs a shell for the scripts in its folder and the command-line tools its instructions call (brew and npm). Our summary lists: Node.js; A Bash shell.

Does Research To Diagram access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Research To Diagram 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Research To Diagram use?

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

About 1.1k tokens (SKILL.md is roughly 4.4k 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 To Diagram?

Skills that share tags, products or a category with Research To Diagram: Harness Book Best Practice (wquguru/harness-books, 3.2k stars), Ky Markdown Rebuilder (KyrieCheungYep/ky-markdown-rebuilder, 117 stars), Paper Interpreter (chujianyun/skills, 742 stars) and Gemini Document Processing (einverne/dotfiles, 121 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research To Diagram?

wshuyi (a GitHub user) maintains it in wshuyi/research-to-diagram, which has 157 GitHub stars. The repository was last updated on January 2, 2026.

Source: wshuyi/research-to-diagram on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.