Markdown Article Formatter
JimLiu/baoyu-skills
Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.
生成深度读书笔记的专用 Skill。输入书籍的豆瓣链接(或书名+作者),自动搜索书籍信息、高质量书评、学术评价等素材,结合 Claude 的深度思考,生成图文并茂、观点鲜明、适合分享的读书笔记,以 Markdown 格式保存到项目 markdown/…
$ npx skills add digoal/blog --skill book-note-writer -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install digoal/blog book-note-writer --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/book-note-writer .claude/skills/book-note-writer && 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 "book-note-writer" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/book-note-writer into .claude/skills/book-note-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-note-writer", 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/book-note-writerType 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 book-note-writer -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install digoal/blog book-note-writer --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/book-note-writer .agents/skills/book-note-writer && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "book-note-writer" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/book-note-writer into .agents/skills/book-note-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-note-writer", 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 book-note-writer -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install digoal/blog book-note-writer --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/book-note-writer .cursor/skills/book-note-writer && 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 "book-note-writer" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/book-note-writer into .cursor/skills/book-note-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-note-writer", 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/book-note-writer--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 book-note-writer -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install digoal/blog book-note-writer --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/book-note-writer .gemini/skills/book-note-writer && 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 "book-note-writer" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/book-note-writer into .gemini/skills/book-note-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-note-writer", 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 book-note-writerInstalls 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 book-note-writer -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/book-note-writer .github/skills/book-note-writer && 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 "book-note-writer" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/book-note-writer into .github/skills/book-note-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-note-writer", 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 book-note-writer -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 book-note-writer --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/book-note-writer .opencode/skills/book-note-writer && 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 "book-note-writer" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/book-note-writer into .opencode/skills/book-note-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-note-writer", 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.
book-note-writer生成深度读书笔记的专用 Skill。输入书籍的豆瓣链接(或书名+作者),自动搜索书籍信息、高质量书评、学术评价等素材,结合 Claude 的深度思考,生成图文并茂、观点鲜明、适合分享的读书笔记,以 Markdown 格式保存到项目 markdown/…
Book Note Writer is an agent skill from digoal/blog. 生成深度读书笔记的专用 Skill。输入书籍的豆瓣链接(或书名+作者),自动搜索书籍信息、高质量书评、学术评价等素材,结合 Claude 的深度思考,生成图文并茂、观点鲜明、适合分享的读书笔记,以 Markdown 格式保存到项目 markdown/ 目录。触发条件:用户提供豆瓣链接、提到"读书笔记"、"书评"、"帮我分析这本书"、"写一篇XX书的笔记",或任何希望深度理解一本书的场景。即使用户只说"帮我写一下这本书的感悟",也应使用本 skill。
Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/high-quality-sources.md` and `test-prompts.json`).
It sits in Documents & Office. 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.
9 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit ad6fcb7. 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.
No scripts in the folder and no shell commands in SKILL.md (its code samples are mermaid, markdown, bash and yaml).
From the folder's file list and the shell code blocks in SKILL.md.
Hosts in commands or code, which the agent is likely to contact:
book.douban.comFrom 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.
Book Note Writer loads about 1.5k tokens when it runs, and up to ~1.8k if it reads all its reference files. Until then it costs about 61 tokens; SKILL.md has 223 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 ad6fcb7, republished under its GPL-2.0 licence (© digoal). 223 words, ~1,497 tokens.
.claude/skills/book-note-writer/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.这不是书籍摘要,也不是简单的内容提炼,而是一次思想的重建与对话。 目标:生成一份「读者能讲给别人听」的读书笔记,有观点、有结构、有温度、图文并茂。
用户可能提供:
https://book.douban.com/subject/XXXXXXX/)如果输入不明确(只有书名无作者),暂停并确认:
「找到了多本同名书,请确认您指的是哪本:[列表],或者补充作者名」
确认书名和作者后再继续。
如果用户提供了豆瓣链接,使用 web_fetch 抓取:
web_fetch(url=豆瓣链接)围绕书籍进行多轮搜索,优先选择高质量来源:
优先级(从高到低):
搜索策略(使用 web_search,每类至少2条):
# 必做搜索
"{书名} {作者} 书评" → 找豆瓣/媒体书评
"{书名} {作者} 读后感" → 找读者笔记
"{作者} 访谈/演讲" → 作者本人怎么说
# 深度搜索(至少选1个)
"{书名} 批评/反思" → 找争议性评论
"{作者} 思想体系/核心观点" → 找学术分析
"{书名} 时代背景/历史意义" → 找背景资料
# 英文备选(上述搜索少于5条时触发)
"{BookTitle} {Author} review"
"{Author} interview/talk"搜索结果质量判断:
web_fetch注意:
web_fetch 获取重要长文的完整内容冷门书处理(搜索结果极少):
搜索无结果时的 fallback:
"{书名} {作者} review""{作者英文名} biography"搜索作者背景:
收集完素材后,展示已获取的关键信息:
已获取:
- 书名 / 作者 / 出版年
- 豆瓣评分(X.X,X人评价)
- 找到 X 篇高质量书评/评论
- 找到 X 条作者访谈/背景资料
确认继续还是补充?
- 直接继续 → 进入深度分析
- 补充某个方向 → 请说明(如:我更想了解XX视角)如果素材严重不足(高质量来源 < 2个):
「这本书记载较少,可参考素材有限,笔记质量可能受限。是否继续?」
对收集到的素材,逐一完成以下分析,每项输出留痕(哪怕只有一句话):
graph TD
A[前提/问题] --> B[关键论据1]
A --> C[关键论据2]
B --> D[推论]
C --> D
D --> E[核心结论]分析完成,准备进入写作阶段。
核心命题:X个
关键论据:X个(高可信度X个)
逻辑图:已绘制
前提假设:X个(X个今天仍成立)
确认进入写作还是调整分析方向?
- 继续 → 进入 Step 3
- 重新聚焦某个维度 → 请说明# 《书名》读书笔记
> **一句话**:[最能概括这本书的一句话]
> **适合谁读**:[目标读者画像]
> **阅读难度**:⭐⭐⭐☆☆(1-5星)
> **推荐指数**:⭐⭐⭐⭐☆
---
## 一、时代坐标:这本书从哪里来?
[200-400字]
- 写作时代背景(时间、社会、学术环境)
- 作者写这本书的动机
- 这本书要解决什么问题
[可选:用 SVG 或文字图展示时间轴]
---
## 二、核心命题:作者在说什么?
[300-500字,用小标题列出2-3个核心观点]
### 观点一:[标题]
...
### 观点二:[标题]
...
---
## 三、论证地图:作者怎么说服你的?
[Mermaid 思维导图或逻辑图]
[200-300字文字解析]
- 关键数据
- 代表性案例/故事
- 论证方式的评价
---
## 四、前提假设与边界:什么情况下这不成立?
[200-300字]
- 列出2-3个关键前提假设
- 分析每个假设是否依然成立
- 这本书的适用边界在哪里
---
## 五、思想谱系:这本书在哪个传统里?
[150-250字]
- 作者的思想来源
- 与同时代思想的对话
- 对后来者的影响
[可选:用简单的文字图展示影响脉络]
---
## 六、我学到了什么?
[300-400字,第一人称,真实思考]
- 最重要的3个收获(带个人理解,不只是复述)
- 改变了我哪些认知
---
## 七、举一反三:这个框架还能用在哪?
[200-300字]
- 核心方法论的迁移应用
- 2-3个具体场景举例
---
## 八、批判与反思
[200-300字]
- 哪里我不同意?
- 哪里时代已经变了?
- 这本书的局限性在哪里?
---
## 九、金句与记忆点
[列出5-8条值得记住的句子或概念,附简短解析]
---
## 十、延伸阅读
[3-5本相关书目,注明为什么推荐]
---
*笔记写于 [日期] | 基于公开资料与深度思考整理*Mermaid 图(用于逻辑关系、思维导图、流程):
mindmap
root((核心论点))
论据1
数据支撑
案例
论据2
...SVG 图(用于时间轴、关系图、强调视觉效果时):
ASCII/文字图(简单关系时):
[前提A] + [前提B]
↓
[中间推论]
↓
[核心结论]每篇笔记至少包含 2 个图示,推荐:
写完初稿后,先向用户展示结构摘要,不直接保存:
读书笔记初稿完成,结构如下:
## X、标题(字数)
## X、标题(字数)
...
金句 X 条
延伸阅读 X 本
确认后我再保存到 markdown/ 目录。
如需调整某个章节,请告诉我。# 确保目录存在
mkdir -p markdown/
# 文件命名:{书名拼音或英文缩写}_{年份}.md
# 示例:
markdown/sapiens_2024.md
markdown/poor_economics_2024.md
markdown/jingsi_lu_2024.md每个笔记文件顶部加上元信息(YAML frontmatter):
---
书名: 《原书名》
作者: 作者名
出版年份: YYYY
笔记日期: YYYY-MM-DD
豆瓣评分: X.X(X人评价)
标签: [标签1, 标签2, 标签3]
来源: [豆瓣链接,如无则填"网络搜索"]
---
> **核心一句话**:[最能概括这本书的一句话]
> **适合谁读**:[目标读者画像,1-2句话]
> **阅读难度**:⭐⭐⭐☆☆(1-5星)
> **推荐指数**:⭐⭐⭐⭐☆(1-5星)告知用户:
写完后自查:
这是最能体现"有温度"的章节,按以下结构写:
[2-3句个人真实感悟开头,建立共鸣]
3个核心收获:
① [概念/观点名称]:为什么重要?它怎么改变了我原有的认知?(X字)
② [概念/观点名称]:这个工具/框架怎么用?举一个我想到的例子(X字)
③ [概念/观点名称]:最难的部分是什么?我还有什么疑惑(X字)
[2-3句收尾,与开头呼应]注意:每个收获必须写"它怎么改变了我",不只复述概念本身。
核心方法论迁移应用的表达公式:
[方法论名称] + [某个新场景] = [具体洞察]示例(针对投资类书籍):
"第二层思维" + 判断房价走势 = 不要只看价格,要看参与者的预期差
"安全边际" + 职业选择 = 不选只有1家雇主能去的岗位,要选即使降薪也愿意干的公司每条格式:[方法论] + [场景] = [洞察],1句话,够具体。
表达不同意的公式:
"作者认为X,但我不这么认为,因为Y"示例:
"作者认为'穷人是自愿选择的贫困',但我不这么认为——系统性障碍(教育/医疗/住房)才是主要矛盾,个体意志在结构性压力面前作用有限。"每条 2-3 句话,必须有具体理由,不能只说"我不同意"。
© 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 2 other files (references) in skills/skills_for_claude_web/book-note-writer of digoal/blog.
Open the folder on GitHubat commit ad6fcb7
Book Note Writer 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 |
|---|---|---|---|---|---|---|
| Book Note Writer this skilldigoal/blog | 8.6k | — | ~1.5k | Automated safety check: Pass | GPL-2.0 | |
| Markdown Article FormatterJimLiu/baoyu-skills | 26k | 6 repos | ~3.5k | Automated safety check: Pass | MIT | |
| MarkitdownImCa0/just-laws | 782 | 14 repos | ~3.2k | Automated safety check: Notes | MIT | |
| Obsidian MarkdownAtmosphere/atmosphere | 3.8k | 20 repos | ~1.3k | Automated safety check: Pass | Apache-2.0 | |
| DOCXrvdbreemen/OTGW-firmware | 207 | 33 repos | ~4.3k | Automated safety check: Pass | Proprietary | |
| Gzh Designisjiamu/gzh-design-skill | 3.9k | 1 repos | ~2.2k | Automated safety check: Pass | AGPL-3.0 |
JimLiu/baoyu-skills
Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
Atmosphere/atmosphere
Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.
rvdbreemen/OTGW-firmware
A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).
isjiamu/gzh-design-skill
微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…
HKUDS/DeepTutor
Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.
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.
Categories
生成深度读书笔记的专用 Skill。输入书籍的豆瓣链接(或书名+作者),自动搜索书籍信息、高质量书评、学术评价等素材,结合 Claude 的深度思考,生成图文并茂、观点鲜明、适合分享的读书笔记,以 Markdown 格式保存到项目 markdown/…. Book Note Writer is an agent skill from digoal/blog.
Book Note Writer fits situations like: documents & Office work in your project.
Run `npx skills add digoal/blog --skill book-note-writer -a claude-code`. Or copy the skill folder (skills/skills_for_claude_web/book-note-writer in digoal/blog) into .claude/skills/book-note-writer in your project. Claude Code loads it when a task matches its description.
Run `npx skills add digoal/blog --skill book-note-writer -a codex`. Or copy the skill folder (skills/skills_for_claude_web/book-note-writer in digoal/blog) into .agents/skills/book-note-writer 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 book-note-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/book-note-writer, .gemini/skills/book-note-writer, .github/skills/book-note-writer and .opencode/skills/book-note-writer in your project.
SKILL.md names no scripts, command-line tools or credentials: Book Note Writer is instructions for the agent only.
SKILL.md names 1 domain. In commands or code: book.douban.com; the agent is likely to contact it when it follows the instructions. 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.
Book Note Writer 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.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 291 tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Book Note Writer: Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars), Markitdown (ImCa0/just-laws, 782 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and DOCX (rvdbreemen/OTGW-firmware, 207 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,586 GitHub stars. The repository holds 98 skills in this directory. The repository was last updated on October 9, 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.