Ky Markdown Rebuilder
KyrieCheungYep/ky-markdown-rebuilder
Rebuild visual documents into reliable Markdown by combining text extraction with page or screenshot alignment.
深度解读学术论文,将论文 PDF(文件或 URL)转化为通俗易懂、图文并茂的 Markdown 解读文档,保存到项目的 markdown/ 目录。触发条件:用户上传或提供论文 PDF、提到"解读论文"/"读论文"/"分析这篇论文"/"帮我看这篇 paper",或任何需要深入理解一篇学术论文的场景。即使用户只说"帮我看这个 PDF"但内容是论文,也应使用本…
$ npx skills add digoal/blog --skill paper-interpreter -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install digoal/blog paper-interpreter --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skills_for_claude_web/paper-interpreter .claude/skills/paper-interpreter && rm -rf skills-srcUse ~/.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/
Install the "paper-interpreter" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/paper-interpreter into .claude/skills/paper-interpreter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "paper-interpreter", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/paper-interpreterType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add digoal/blog --skill paper-interpreter -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install digoal/blog paper-interpreter --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/skills_for_claude_web/paper-interpreter .agents/skills/paper-interpreter && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "paper-interpreter" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/paper-interpreter into .agents/skills/paper-interpreter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "paper-interpreter", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add digoal/blog --skill paper-interpreter -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install digoal/blog paper-interpreter --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/skills_for_claude_web/paper-interpreter .cursor/skills/paper-interpreter && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "paper-interpreter" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/paper-interpreter into .cursor/skills/paper-interpreter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "paper-interpreter", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/digoal/blog.git --path skills/skills_for_claude_web/paper-interpreter--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add digoal/blog --skill paper-interpreter -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install digoal/blog paper-interpreter --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/skills_for_claude_web/paper-interpreter .gemini/skills/paper-interpreter && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "paper-interpreter" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/paper-interpreter into .gemini/skills/paper-interpreter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "paper-interpreter", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install digoal/blog paper-interpreterInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add digoal/blog --skill paper-interpreter -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/skills_for_claude_web/paper-interpreter .github/skills/paper-interpreter && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "paper-interpreter" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/paper-interpreter into .github/skills/paper-interpreter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "paper-interpreter", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add digoal/blog --skill paper-interpreter -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install digoal/blog paper-interpreter --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/skills_for_claude_web/paper-interpreter .opencode/skills/paper-interpreter && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "paper-interpreter" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/paper-interpreter into .opencode/skills/paper-interpreter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "paper-interpreter", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
paper-interpreter深度解读学术论文,将论文 PDF(文件或 URL)转化为通俗易懂、图文并茂的 Markdown 解读文档,保存到项目的 markdown/ 目录。触发条件:用户上传或提供论文 PDF、提到"解读论文"/"读论文"/"分析这篇论文"/"帮我看这篇 paper",或任何需要深入理解一篇学术论文的场景。即使用户只说"帮我看这个 PDF"但内容是论文,也应使用本…
Paper Interpreter is an agent skill from digoal/blog. 深度解读学术论文,将论文 PDF(文件或 URL)转化为通俗易懂、图文并茂的 Markdown 解读文档,保存到项目的 markdown/ 目录。触发条件:用户上传或提供论文 PDF、提到"解读论文"/"读论文"/"分析这篇论文"/"帮我看这篇 paper",或任何需要深入理解一篇学术论文的场景。即使用户只说"帮我看这个 PDF"但内容是论文,也应使用本 skill。输出文件包含:论文定位、知识地图、5W1H精读、术语词典、批判性评估五大板块,并在关键位置插入 mermaid/svg/text 图表辅助理解。
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.
It sits in Documents & Office, covering Diagrams, PDF and Markdown. It works with Mermaid. The repository describes itself as: AI,Opensource,Database,Business,Finance,Minds. git clone --depth 1 https://github.com/digoal/blog. The licence is GPL-2.0.
4 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 69fb793. It shows what the files ask for, not the result of running them.
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.
Shell commands in SKILL.md call:
pippython3From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Paper Interpreter loads about 1.1k tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 189 words of instructions outside code blocks.
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.
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.
The full file from digoal/blog at commit 69fb793, republished under its GPL-2.0 licence (© digoal). 189 words, ~1,087 tokens.
.claude/skills/paper-interpreter/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.将学术论文转化为通俗易懂、图文并茂的深度解读文档。
输入(PDF文件/URL) → 全文提取 → 5步解读 → 输出 Markdown 文件到 markdown/读取路径 /mnt/user-data/uploads/ 下的 PDF 文件,用 bash_tool 提取文本:
pip install pdfminer.six --break-system-packages -q
python3 - <<'EOF'
from pdfminer.high_level import extract_text
text = extract_text("/mnt/user-data/uploads/论文文件名.pdf")
print(text[:50000]) # 先输出前50000字符
EOF若论文有图表密集或文字提取不完整,追加用 pymupdf 逐页提取并描述图表内容:
pip install pymupdf --break-system-packages -q
python3 - <<'EOF'
import fitz
doc = fitz.open("/mnt/user-data/uploads/论文文件名.pdf")
for i, page in enumerate(doc):
print(f"\n=== Page {i+1} ===")
print(page.get_text())
# 列出图片
imgs = page.get_images()
if imgs:
print(f"[此页含 {len(imgs)} 张图片]")
EOF使用 web_fetch 工具抓取 PDF,或者先用 web_search 找到 arXiv/DOI 页面,再抓取 HTML 摘要 + 全文。
web_fetch(url) → 提取文本内容重要:提取完成后,记录以下信息备用:
mkdir -p markdown
# 文件名格式:论文标题关键词(英文)+ _解读.md
# 例:attention_is_all_you_need_解读.md按以下结构逐步撰写输出文档。每一步都必须完成,不可跳过。
目标:让读者在30秒内判断"这篇论文值不值得读、跟我有什么关系"。
写法要求:
示例格式:
## 📍 论文定位
**一句话**:本文提出了 XXX 方法,解决了 YYY 场景下 ZZZ 的问题。
**🎓 学术价值**:首次将...应用于...领域,填补了...的空白。
**🏭 工业价值**:可直接用于...系统,降低...成本,提升...效率。
**💡 直觉类比**:这篇论文就像是给 AI 配了一个...,让它能够...目标:用结构化方式呈现读懂本文所需的前置知识,降低阅读门槛。
写法要求:
Mermaid 知识树模板:
graph TD
A[读懂本文需要] --> B[核心概念 必须懂]
A --> C[支撑概念 有助理解]
A --> D[扩展概念 感兴趣再看]
B --> B1[概念1 ⭐⭐]
B --> B2[概念2 ⭐⭐⭐]
C --> C1[概念3 ⭐]
D --> D1[概念4 ⭐⭐]目标:按"问题-方案-验证"三段式完整解读论文内容。
Mermaid 架构图示例:
graph LR
输入 --> 模块A
模块A --> 模块B
模块B --> 模块C
模块C --> 输出目标:让读者看完就记住关键术语的含义和重要性。
每个术语使用固定三件套模板:
### 术语名(英文原名)
- **是什么**:...
- **为什么重要**:...
- **现实类比**:就像...只收录论文中真正关键的术语(5~15个),不要堆砌所有专业词汇。
目标:培养读者的独立思考能力,呈现论文的局限性与未来方向。
必须覆盖以下四个维度:
假设前提的合理性
实验设计的可质疑之处
方法的适用边界
未来改进方向
完整的 Markdown 文件结构如下:
# 📄 论文解读:{论文标题}
> **原文信息**:作者 | 年份 | 期刊/会议
> **解读日期**:{今天日期}
---
## 📍 论文定位
...
---
## 🗺️ 知识地图
...
---
## 🔬 论文精读
### Why — 研究动机
### What — 核心方法
### How — 技术细节
### So What — 实验结果
### Now What — 价值总结
---
## 📖 术语词典
...
---
## ⚖️ 批判性评估
...
---
## 📚 参考资料
- 原文链接
- 相关论文(如论文中引用的关键文献)最后执行:
# 保存文件
cp /home/claude/解读文件.md markdown/文件名.md
echo "✅ 解读文档已保存至 markdown/文件名.md"生成文档后,逐项确认:
markdown/ 目录关于图片:论文中的图片无法直接嵌入 Markdown,应用文字描述 + mermaid 重新表达其核心信息。
关于公式:保留核心公式(使用 LaTeX 格式 $公式$),但每个公式后面必须跟一段白话解释。
关于篇幅:解读文档通常在 2000~5000 字之间。太短说明解读不够深入,太长可能存在不必要的堆砌。
关于语气:用"我们"和"读者"的视角写作,像一位熟悉该领域的朋友在讲解,避免学术腔。
© digoal, GPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 1 other file in skills/skills_for_claude_web/paper-interpreter of digoal/blog.
Open the folder on GitHubat commit 69fb793
Paper Interpreter 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Paper Interpreter this skilldigoal/blog | 8.6k | — | ~1.1k | Automated safety check: Pass | GPL-2.0 | |
| Ky Markdown RebuilderKyrieCheungYep/ky-markdown-rebuilder | 117 | — | ~5.7k | Automated safety check: Pass | None | |
| Paper Interpreterchujianyun/skills | 740 | — | ~810 | Automated safety check: Pass | Custom licence | |
| Bangunai Blog ManagerLeoYeAI/openclaw-master-skills | 2.2k | — | ~5.7k | Automated safety check: Pass | MIT | |
| Markdown Syntax Guideantdigital-ai/agentic-ui | 224 | — | ~3.1k | Automated safety check: Pass | MIT | |
| Markdown Report WritingNeuroAIHub/BrainPilot | 1.1k | — | ~2.6k | Automated safety check: Warn | AGPL-3.0 |
KyrieCheungYep/ky-markdown-rebuilder
Rebuild visual documents into reliable Markdown by combining text extraction with page or screenshot alignment.
chujianyun/skills
论文解读助手。适用于用户发送 arXiv 论文链接,并希望下载论文、解读论文、生成读书笔记、做论文拆解或输出详细报告时使用。会在工作目录创建论文文件夹、下载 PDF 与 TeX Source(如有)、生成中文 Markdown 报告。默认先交付初稿,不自动复查;如果用户明确同意,再安排后续复查。不适用于只要简短推荐语的情况。
LeoYeAI/openclaw-master-skills
A skill your agent uses when managing BangunAI Blog content, automating blog workflows, and writing MDX articles with BangunAI conventions.
antdigital-ai/agentic-ui
指导用户使用 @ant-design/agentic-ui 的 Markdown Editor / Renderer 扩展语法。图表场景优先使用内置 chart(HTML 注释 chartType + 表格),只有当内置 chartType 都不能表达诉求时才回退 Mermaid。Triggers on keywords like 表格, 视频, 图表, 卡片, 提示块, 流程图, 语法…
NeuroAIHub/BrainPilot
Guide AI agents to write beautifully formatted, well-illustrated Markdown reports with proper structure, diagrams, and compatibility across GitHub and Obsidian.
BlackBeltTechnology/pi-agent-dashboard
Convert documents bidirectionally via the pi-doc-engine facade: ingest PDF/DOCX/PPTX/XLSX to provenance-stamped Markdown (with OCR), and produce templated DOCX/PDF from Markdown with diagrams, TOC…
digoal/blog
三层审查模型,逐段逐句验证文章真伪、证据链与逻辑结构。Use when the user asks to fact-check, verify, audit, or evaluate the credibility of an article, essay, report, opinion piece, social-media post, or any written claim —…
digoal/blog
Find latent bugs in a local PostgreSQL source tree (RELxxSTABLE branch or HEAD) the way a core hacker does: build a heavily-poisoned debug instance (cassert + cache-discard + -O0/-ggdb3 + core…
digoal/blog
Portable digital employee distilled from digoal's personal blog for PostgreSQL, PolarDB, DuckDB, AI+database, vector/RAG, database operations, source-code reading, technical content creation…
digoal/blog
从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读,并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF…
digoal/blog
Analyze a product from documentation, websites, PDFs, articles, release notes, pricing pages, app listings, reviews, filings, or related links; save separate intermediate analyses from seven roles…
digoal/blog
Turn a blog post, article, notes, or any source material into a set of vertical poster images — one cover plus several coherent content slides that explain the core points.
Works with
Categories
深度解读学术论文,将论文 PDF(文件或 URL)转化为通俗易懂、图文并茂的 Markdown 解读文档,保存到项目的 markdown/ 目录。触发条件:用户上传或提供论文 PDF、提到"解读论文"/"读论文"/"分析这篇论文"/"帮我看这篇 paper",或任何需要深入理解一篇学术论文的场景。即使用户只说"帮我看这个 PDF"但内容是论文,也应使用本…. Paper Interpreter is an agent skill from digoal/blog.
Paper Interpreter fits situations like: tasks that involve Diagrams; tasks that involve PDF; tasks that involve Markdown.
Run `npx skills add digoal/blog --skill paper-interpreter -a claude-code`. Or copy the skill folder (skills/skills_for_claude_web/paper-interpreter in digoal/blog) into .claude/skills/paper-interpreter in your project. Claude Code loads it when a task matches its description.
Run `npx skills add digoal/blog --skill paper-interpreter -a codex`. Or copy the skill folder (skills/skills_for_claude_web/paper-interpreter in digoal/blog) into .agents/skills/paper-interpreter in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add digoal/blog --skill paper-interpreter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/paper-interpreter, .gemini/skills/paper-interpreter, .github/skills/paper-interpreter and .opencode/skills/paper-interpreter in your project.
Going by SKILL.md and its folder, Paper Interpreter needs the command-line tools its instructions call (pip and python3). Our summary lists: Python 3.
SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
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.
Paper Interpreter is published under the GPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
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.
Skills that share tags, products or a category with Paper Interpreter: Ky Markdown Rebuilder (KyrieCheungYep/ky-markdown-rebuilder, 117 stars), Paper Interpreter (chujianyun/skills, 740 stars), Bangunai Blog Manager (LeoYeAI/openclaw-master-skills, 2.2k stars) and Markdown Syntax Guide (antdigital-ai/agentic-ui, 224 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
digoal (a GitHub user) maintains it in digoal/blog, which has 8,587 GitHub stars. The repository holds 98 skills in this directory. The repository was last updated on September 28, 2026.
Source: digoal/blog on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.