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.
把一本书拆解成 Claude Code 可执行的 Skill。当用户说"拆书"、"把这本书变成 Skill"、"book to skill"、"extract skill from book" 时触发。
Install Book To Skill
$ npx skills add apple-ouyang/book-to-skill --skill book-to-skill -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install apple-ouyang/book-to-skill book-to-skill --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/apple-ouyang/book-to-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/book-to-skill .claude/skills/book-to-skill && 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-to-skill" agent skill from https://github.com/apple-ouyang/book-to-skill/tree/main/skills/book-to-skill into .claude/skills/book-to-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-to-skill", 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/apple-ouyang/book-to-skill/tree/main/skills/book-to-skillType 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 apple-ouyang/book-to-skill --skill book-to-skill -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install apple-ouyang/book-to-skill book-to-skill --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/apple-ouyang/book-to-skill.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/book-to-skill .agents/skills/book-to-skill && 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-to-skill" agent skill from https://github.com/apple-ouyang/book-to-skill/tree/main/skills/book-to-skill into .agents/skills/book-to-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-to-skill", 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 apple-ouyang/book-to-skill --skill book-to-skill -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install apple-ouyang/book-to-skill book-to-skill --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/apple-ouyang/book-to-skill.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/book-to-skill .cursor/skills/book-to-skill && 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-to-skill" agent skill from https://github.com/apple-ouyang/book-to-skill/tree/main/skills/book-to-skill into .cursor/skills/book-to-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-to-skill", 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/apple-ouyang/book-to-skill.git --path skills/book-to-skill--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 apple-ouyang/book-to-skill --skill book-to-skill -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install apple-ouyang/book-to-skill book-to-skill --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/apple-ouyang/book-to-skill.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/book-to-skill .gemini/skills/book-to-skill && 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-to-skill" agent skill from https://github.com/apple-ouyang/book-to-skill/tree/main/skills/book-to-skill into .gemini/skills/book-to-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-to-skill", 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 apple-ouyang/book-to-skill book-to-skillInstalls 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 apple-ouyang/book-to-skill --skill book-to-skill -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/apple-ouyang/book-to-skill.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/book-to-skill .github/skills/book-to-skill && 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-to-skill" agent skill from https://github.com/apple-ouyang/book-to-skill/tree/main/skills/book-to-skill into .github/skills/book-to-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-to-skill", 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 apple-ouyang/book-to-skill --skill book-to-skill -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install apple-ouyang/book-to-skill book-to-skill --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/apple-ouyang/book-to-skill.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/book-to-skill .opencode/skills/book-to-skill && 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-to-skill" agent skill from https://github.com/apple-ouyang/book-to-skill/tree/main/skills/book-to-skill into .opencode/skills/book-to-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-to-skill", 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.
Facts
- Skill name
book-to-skill- GitHub stars
- 161
- Token cost
- ~789 tokens
- SKILL.md length
- 231 words
- Files
- 1
- Skills in repo
- 6
- Repo updated
- First seen
- Licence
- MIT
At a glance
把一本书拆解成 Claude Code 可执行的 Skill。当用户说"拆书"、"把这本书变成 Skill"、"book to skill"、"extract skill from book" 时触发。
- Works in 4 steps: 这本书解决什么核心问题？ → 作者提出的主框架是什么？（如 WRAP、OODA、第一性原理） → 框架有几个核心步骤/模块？ → …
- Documents & Office work in your project
- SKILL.md covers 任务目标, 前置依赖, 第一步：评估书籍规模，决定单 Agent 还是多 Agent and 第二步：通读目录，识别框架骨架, plus 6 more sections
- Calls npx
What it does
Book To Skill is an agent skill from apple-ouyang/book-to-skill. 把一本书拆解成 Claude Code 可执行的 Skill。当用户说"拆书"、"把这本书变成 Skill"、"book to skill"、"extract skill from book" 时触发。
Its SKILL.md is about 790 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Documents & Office. The repository describes itself as: 把书拆成 AI Agent 可执行的 Skill，让书中的智慧变成你的决策副驾驶 | Turn books into executable AI Agent Skills. The licence is MIT.
When your agent uses it
- Documents & Office work in your project
Example prompts
- “把这本书变成 Skill”
- “book to skill”
- “extract skill from book”
- “/book-to-skill”
Requirements
- Node.js
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- 这本书解决什么核心问题？
- 作者提出的主框架是什么？（如 WRAP、OODA、第一性原理）
- 框架有几个核心步骤/模块？
- 每个步骤对应哪些章节？
What it can do on your machine
Read from SKILL.md and the folder at commit a24960a. 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
Shell commands in SKILL.md call:
npx
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npx, 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
Book To Skill loads about 789 tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 231 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.
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 apple-ouyang/book-to-skill at commit a24960a, republished under its MIT licence (© apple-ouyang). 231 words, ~789 tokens.
Download SKILL.mdSave it as
.claude/skills/book-to-skill/SKILL.md (or your agent's skills folder).- name
- book-to-skill
- description
- 把一本书拆解成 Claude Code 可执行的 Skill。当用户说"拆书"、"把这本书变成 Skill"、"book to skill"、"extract skill from book" 时触发。
拆书：从书籍到可执行 Skill
任务目标
把一本书中的核心框架、操作方法和真实案例，拆解成结构化的 Claude Code Skill，让 AI Agent 能在用户需要时自动调用书中的智慧。
前置依赖
- PDF Skill：用于读取 PDF 格式书籍（
npx @anthropic-ai/claude-code-skills install pdf） - Swarm Skill：用于多 Agent 并行处理不同章节（当书籍超出单 Agent 上下文窗口时必须使用）
第一步：评估书籍规模，决定单 Agent 还是多 Agent
这是最关键的一步。 在开始拆书之前，必须先估算书籍内容是否能装进单个 Agent 的上下文窗口。
上下文窗口容量（按 100k token 估算）
| 语言 | 100k token ≈ | 扣除格式开销后 |
|---|---|---|
| 英文 | ~75,000 单词 / ~270 页 | ~200 页 |
| 中文 | ~50,000-65,000 字 / ~110 页 | ~80 页 |
注：上下文窗口不只装书的内容，还要装 Skill 指令、Agent 提示词、输出缓冲等。所以实际可用于书籍内容的空间约为窗口的 70-80%。
操作：估算 PDF 页数
# 用 PDF Skill 读取页数
# 或者直接问用户：这本书大概多少页？决策树
书籍页数？
├── 英文 ≤ 200 页 / 中文 ≤ 80 页
│ → 单 Agent 模式（直接读取全书，一个 Agent 完成所有提取）
│
├── 英文 200-500 页 / 中文 80-200 页
│ → Swarm 模式：2-3 个 Agent，每个负责一部分章节
│
└── 英文 > 500 页 / 中文 > 200 页
→ Swarm 模式：4-6 个 Agent，按主题/部分拆分Agent 数量计算公式
所需 Agent 数 = ceil(书籍页数 / 单 Agent 可处理页数)
单 Agent 可处理页数：
- 英文：~200 页
- 中文：~80 页示例：《行为设计学》中文版约 250 页 → ceil(250 / 80) = 4 个 Agent，实际拆成了 4 个 Skill（making-decisions + 3 个子 Skill），每个 Agent 负责 2-3 章。
第二步：通读目录，识别框架骨架
读取书籍目录和前言（这一步不需要读全书，单 Agent 即可），回答：
- 这本书解决什么核心问题？
- 作者提出的主框架是什么？（如 WRAP、OODA、第一性原理）
- 框架有几个核心步骤/模块？
- 每个步骤对应哪些章节？
输出：框架骨架表
| 框架步骤 | 对应章节 | 预计拆成的 Skill | 分配给 Agent |
|---------|---------|----------------|-------------|
| 步骤 1 | 第 1-3 章 | skill-name-1 | Agent 1 |
| 步骤 2 | 第 4-6 章 | skill-name-2 | Agent 2 |第三步：确定 Skill 结构
根据框架复杂度决定：
- 单 Skill：框架简单，3-5 个步骤，一个 SKILL.md 搞定
- 主 Skill + 子 Skill：框架复杂，每个步骤本身就是一套方法论
- 主 Skill 负责路由（判断用户场景 → 调度子 Skill）
- 子 Skill 负责具体操作
判断标准：如果一个步骤的操作说明超过 100 行，就应该拆成独立子 Skill。
第四步：逐章提取
单 Agent 模式
直接读取全书 PDF，按章节顺序提取。
Swarm 多 Agent 模式
用 /swarm 启动团队，按第二步的分配表分配章节。
Agent 提示词模板：
角色：章节提取员
职责：阅读第 X-Y 章（PDF 第 M-N 页），按以下格式提取内容
提取内容：
1. 核心概念（一句话总结）
2. 操作步骤（具体可执行，不是"思考一下"，而是"问自己：___"）
3. 案例（格式：人物/组织 → 情境 → 做法 → 结果 → 启示）
4. 警惕信号（什么情况下应该触发这个方法）
5. 注意事项（边界情况、常见误用）
输出要求：Markdown 格式，每章一个二级标题
完成标准：每章至少 2 个案例，操作步骤必须具体到 Agent 可以直接执行
文件范围：只读取 PDF 第 M-N 页，不要读其他部分关键规则：
- 每个 Agent 只读自己负责的页码范围，避免重复读取浪费 token
- 领导 Agent 负责汇总和组装，不直接提取内容
- 提取完成后，每个 Agent 把结果写入独立的 Markdown 文件
第五步：组装 Skill
将提取的内容组装成 SKILL.md：
- 写 frontmatter（name + description，description 要写清触发场景）
- 写任务目标（一段话）
- 按逻辑顺序排列操作步骤
- 在步骤中嵌入关键案例（1-2 个最有说服力的）
- 其余案例放入
references/cases.md - 写注意事项和使用示例
- 如果是主 Skill，写清路由逻辑（什么场景调度哪个子 Skill）
第六步：自测
用 3 个真实场景测试 Skill：
- 调用 Skill，看 Agent 的引导是否清晰
- 检查是否有步骤模糊到 Agent 不知道该问什么
- 检查案例是否帮助用户理解概念
不通过就回第五步修改。
第七步：提交
按 CONTRIBUTING.md 规范提交：
- 分支名：
book/书名英文 - PR 说明：拆了哪本书、包含哪些 Skill、每个 Skill 的触发场景
质量标准
| 维度 | 合格 | 不合格 |
|---|---|---|
| 操作步骤 | "问用户：如果当前选项都不可行，你会怎么办？" | "引导用户拓宽思路" |
| 案例 | 有人物、情境、做法、结果、启示 | "比如某公司做过类似的事" |
| 触发场景 | "当用户说'要不要做 X'时" | "当用户需要帮助时" |
| Skill 粒度 | 一个 Skill 解决一个问题 | 一个 Skill 覆盖整本书 |
| Agent 分配 | 基于页数估算，每个 Agent 不超过上下文窗口 | 不管多长都塞给一个 Agent |
© apple-ouyang, 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/book-to-skill of apple-ouyang/book-to-skill.
Open the folder on GitHubat commit a24960a
Compare with similar skills
Book To Skill 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 To Skill this skillapple-ouyang/book-to-skill | 161 | — | ~789 | Automated safety check: Pass | MIT | |
| Markdown Article FormatterJimLiu/baoyu-skills | 27k | 6 repos | ~3.5k | Automated safety check: Pass | MIT | |
| MarkitdownImCa0/just-laws | 781 | 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 | |
| Word Document Reader and WriterHKUDS/DeepTutor | 41k | — | ~2.5k | Automated safety check: Pass | Apache-2.0 |
Similar skills
Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
Obsidian Markdown
Atmosphere/atmosphere
Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.
DOCX
rvdbreemen/OTGW-firmware
A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).
Word Document Reader and Writer
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.
Crossposting
wasp-lang/wasp
Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.
More from apple-ouyang/book-to-skill
Making Decisions
apple-ouyang/book-to-skill
A skill your agent uses when facing a significant decision, evaluating options, or feeling stuck between choices.
Seeking Disconfirming Evidence
apple-ouyang/book-to-skill
A skill your agent uses when a decision feels obvious or everyone agrees, when evaluating omeone's proposal or pitch, when in a team debate that's going nowhere, or when you suspect confirmation…
Swarm
apple-ouyang/book-to-skill
This skill should be used when the user asks to "create a team", "create agent team", "蜂群", "swarm", "团队协作", "parallel agents", "spawn teammates", "多 agent 协作", "组建团队", or executes "/swarm".
Decision Tripwires
apple-ouyang/book-to-skill
A skill your agent uses when committing resources to a project, investment, or relationship.
Reality Testing Decisions
apple-ouyang/book-to-skill
A skill your agent uses when tempted to predict, analyze, or debate whether something will work instead of testing it.
Related
Categories
Questions about Book To Skill
What does Book To Skill do?
把一本书拆解成 Claude Code 可执行的 Skill。当用户说"拆书"、"把这本书变成 Skill"、"book to skill"、"extract skill from book" 时触发。. Book To Skill is an agent skill from apple-ouyang/book-to-skill.
When should I use Book To Skill?
Book To Skill fits situations like: documents & Office work in your project.
How do I install Book To Skill in Claude Code?
Run `npx skills add apple-ouyang/book-to-skill --skill book-to-skill -a claude-code`. Or copy the skill folder (skills/book-to-skill in apple-ouyang/book-to-skill) into .claude/skills/book-to-skill in your project. Claude Code loads it when a task matches its description.
How do I install Book To Skill in Codex?
Run `npx skills add apple-ouyang/book-to-skill --skill book-to-skill -a codex`. Or copy the skill folder (skills/book-to-skill in apple-ouyang/book-to-skill) into .agents/skills/book-to-skill in your project. Codex loads it when a task matches its description.
Can I use Book To Skill 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 apple-ouyang/book-to-skill --skill book-to-skill -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-to-skill, .gemini/skills/book-to-skill, .github/skills/book-to-skill and .opencode/skills/book-to-skill in your project.
What does Book To Skill need to run?
Going by SKILL.md and its folder, Book To Skill needs the command-line tools its instructions call (npx). Our summary lists: Node.js.
Does Book To Skill access the network?
SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Book To Skill 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 Book To Skill use?
Book To Skill 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 Book To Skill use?
About 789 tokens (SKILL.md is roughly 3.2k 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 Book To Skill?
Skills that share tags, products or a category with Book To Skill: Markdown Article Formatter (JimLiu/baoyu-skills, 27k stars), Markitdown (ImCa0/just-laws, 781 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.
Who maintains Book To Skill?
apple-ouyang (a GitHub user) maintains it in apple-ouyang/book-to-skill, which has 161 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on February 25, 2026.
Source: apple-ouyang/book-to-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.