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.
基于现有文章、专栏、课程讲稿、逐字稿、访谈、课件、会议纪要、案例材料、PDF 文本、Word 文档和笔记等内容资产，判断它们最适合转化为书、小册子、课程、系列文章、实务手册或知识库，并输出精简策划意见；用户提到“把现有内容整理成书”“判断素材适合做书还是课程”“把文章/直播稿/课程稿/笔记重组成知识产品”等场景时，应使用本技能。
Install Article2book
$ npx skills add cat-xierluo/legal-skills --skill article2book -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install cat-xierluo/legal-skills article2book --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/cat-xierluo/legal-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/article2book .claude/skills/article2book && 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 "article2book" agent skill from https://github.com/cat-xierluo/legal-skills/tree/main/skills/article2book into .claude/skills/article2book/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "article2book", 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/cat-xierluo/legal-skills/tree/main/skills/article2bookType 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 cat-xierluo/legal-skills --skill article2book -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install cat-xierluo/legal-skills article2book --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cat-xierluo/legal-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/article2book .agents/skills/article2book && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "article2book" agent skill from https://github.com/cat-xierluo/legal-skills/tree/main/skills/article2book into .agents/skills/article2book/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "article2book", 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 cat-xierluo/legal-skills --skill article2book -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install cat-xierluo/legal-skills article2book --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cat-xierluo/legal-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/article2book .cursor/skills/article2book && 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 "article2book" agent skill from https://github.com/cat-xierluo/legal-skills/tree/main/skills/article2book into .cursor/skills/article2book/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "article2book", 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/cat-xierluo/legal-skills.git --path skills/article2book--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 cat-xierluo/legal-skills --skill article2book -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install cat-xierluo/legal-skills article2book --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cat-xierluo/legal-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/article2book .gemini/skills/article2book && 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 "article2book" agent skill from https://github.com/cat-xierluo/legal-skills/tree/main/skills/article2book into .gemini/skills/article2book/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "article2book", 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 cat-xierluo/legal-skills article2bookInstalls 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 cat-xierluo/legal-skills --skill article2book -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/cat-xierluo/legal-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/article2book .github/skills/article2book && 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 "article2book" agent skill from https://github.com/cat-xierluo/legal-skills/tree/main/skills/article2book into .github/skills/article2book/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "article2book", 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 cat-xierluo/legal-skills --skill article2book -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install cat-xierluo/legal-skills article2book --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cat-xierluo/legal-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/article2book .opencode/skills/article2book && 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 "article2book" agent skill from https://github.com/cat-xierluo/legal-skills/tree/main/skills/article2book into .opencode/skills/article2book/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "article2book", 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
article2book- GitHub stars
- 713
- Token cost
- ~2.1k tokens
- SKILL.md length
- 446 words
- Files
- 10 (incl. scripts, references)
- Skills in repo
- 62
- Repo updated
- First seen
- Licence
- MIT
At a glance
基于现有文章、专栏、课程讲稿、逐字稿、访谈、课件、会议纪要、案例材料、PDF 文本、Word 文档和笔记等内容资产，判断它们最适合转化为书、小册子、课程、系列文章、实务手册或知识库，并输出精简策划意见；用户提到“把现有内容整理成书”“判断素材适合做书还是课程”“把文章/直播稿/课程稿/笔记重组成知识产品”等场景时，应使用本技能。
- Works in 10 steps: ：确认源目录、文件类型、工作模式与输出位置 → ：先让 Agent 通读全部候选文本素材 → ：通读后先做“保留 / 降权 / 排除”筛选 → …
- Documents & Office work in your project
- SKILL.md covers 定位, 典型输入, 不适用场景 and 默认输出目录, plus 10 more sections
- Runs Python scripts from its folder; calls python3, brew and apt-get
What it does
Article2book is an agent skill from cat-xierluo/legal-skills. 基于现有文章、专栏、课程讲稿、逐字稿、访谈、课件、会议纪要、案例材料、PDF 文本、Word 文档和笔记等内容资产，判断它们最适合转化为书、小册子、课程、系列文章、实务手册或知识库，并输出精简策划意见；用户提到“把现有内容整理成书”“判断素材适合做书还是课程”“把文章/直播稿/课程稿/笔记重组成知识产品”等场景时，应使用本技能。
Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts and reference files (for example `CHANGELOG.md`, `references/agent-reading-protocol.md` and `references/book-viability-rubric.md`).
It sits in Documents & Office. The licence is MIT.
When your agent uses it
- Documents & Office work in your project
Example prompts
- “把现有内容整理成书”
- “判断素材适合做书还是课程”
- “把文章/直播稿/课程稿/笔记重组成知识产品”
- “/article2book”
Requirements
- Python 3
Workflow steps
10 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit c077fcc. 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/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python3brewapt-get
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
Article2book loads about 2.1k tokens when it runs, and up to ~7.8k if it reads all its reference files. Until then it costs about 45 tokens; SKILL.md has 446 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: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NoteRuns commands with sudoSKILL.md:382
: 系统自带或 `brew install python`<br>Linux: `sudo apt-get install python3` |
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 cat-xierluo/legal-skills at commit c077fcc, republished under its MIT licence (© cat-xierluo). 446 words, ~2,073 tokens.
Download SKILL.mdSave it as
.claude/skills/article2book/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.- name
- article2book
- description
- 基于现有文章、专栏、课程讲稿、逐字稿、访谈、课件、会议纪要、案例材料、PDF 文本、Word 文档和笔记等内容资产，判断它们最适合转化为书、小册子、课程、系列文章、实务手册或知识库，并输出精简策划意见；用户提到“把现有内容整理成书”“判断素材适合做书还是课程”“把文章/直播稿/课程稿/笔记重组成知识产品”等场景时，应使用本技能。
- homepage
- https://github.com/cat-xierluo/legal-skills
- author
- 杨卫薪律师（微信ywxlaw）
- version
- 1.0.0
- license
- MIT
现有内容资产再组织技能
最后更新：2026-05-17
定位
article2book 用于把一个目录下已经存在的内容资产，整理成可出版、可交付或可持续维护的结构化成果。
本技能仍以“成书策划”为默认主路径，但不把所有素材强行导向一本书。它会先判断这批素材最适合成为：
- 书稿
- 小册子
- 课程
- 系列文章
- 实务手册
- 知识库
- 暂不建议产品化的素材池
这里的“现有内容资产”包括但不限于：
- 已发布文章、专栏稿、公众号稿件
- 课程讲稿、分享提纲、直播稿、演讲稿
- 视频教程配套文稿、字幕稿、逐字稿
- 访谈稿、问答记录、会议纪要
- 课件、案例材料、实务清单
- PDF 文本、Word 文档、Obsidian 笔记
- 卡片、方法论草稿、系列随笔
它的出发点不是“从空白开始写一本书”，而是：
- 先盘点已有内容资产
- 再判断最合适的交付形态
- 然后筛掉低价值内容，收束母题、读者和结构
- 最后把已有素材重组为更适合出版或交付的内容产品
本技能的默认方法论是：
- Agent 通读优先
- 脚本索引辅助
- 先判断内容形态，再判断是否成书
- 先筛掉低价值内容，再做结构设计
- 默认单文件交付
- 确认后进入对应产物初稿
典型输入
- 一个目录下混合放置的 Markdown 文章、专栏稿、公众号稿、课程讲稿、字幕稿、逐字稿、Obsidian 笔记
- 一批直播稿、访谈稿、课程稿或会议纪要，用户不确定适合做书、课程还是知识库
- 已写成很多长文，但主题散、重复多、表达角度不统一
- 同一作者围绕某条方法论持续写作和输出，但还没有沉淀成稳定内容产品
- 一个混合目录里同时有文章、课件、案例、手册草稿和零散笔记
示例：
请读取 <素材目录>，判断这些文章能不能整理成一本书，并给出书稿结构方案。我有一批直播逐字稿和配套文章，帮我判断适合做书、课程还是小册子。这个混合目录能不能整理成一个知识产品？如果不适合成书，也请给出替代方案。你先只输出一份策划意见，我确认后你再直接生成对应初稿。
不适用场景
- 用户只是想汇总文件目录，不关心内容形态、读者定位或重组路径
- 用户已经有成熟目录，只需要续写某一章
- 用户希望完全从零构思一本书，而不是基于已有素材整理
- 文件夹里主要是图片、扫描件、录音、纯视频等材料，且尚未转为可读文本
- 用户要做的是排版、封面、营销文案或发行流程，而不是内容资产重组
默认输出目录
默认在源目录下创建 书稿策划输出/ 目录。即使最终建议不是成书，也继续使用该目录，避免为不同形态制造多套路径规则。
工作模式
根据用户请求和素材复杂度选择工作模式：
| 模式 | 适用场景 | 默认产物 |
|---|---|---|
| 快速盘点 | 用户只想先知道方向，或素材规模很大需要先判断值不值得深入 | 对话内给出简短判断，必要时生成 书稿策划意见.md 的简版 |
| 标准策划 | 默认模式；用户要求判断能否成书、适合什么形态、怎么重组 | 书稿策划意见.md |
| 深度重构 | 用户确认策划意见后，或明确要求直接生成完整初稿 | 全书初稿.md 或对应形态初稿 |
默认使用标准策划。只有在用户确认方向、明确要求生成初稿，或素材复杂到必须拆批处理时，才进入深度重构。
交付形态判断树
先判断最佳内容形态，再判断是否进入成书路径：
- 成书：素材有稳定母题、明确读者、足够厚度和可持续扩写空间。
- 小册子：主题集中但厚度不足，更适合短平快交付。
- 课程：素材以讲授顺序、操作演示、练习任务或学习路径为主。
- 系列文章：观点有价值但主题尚未形成完整体系。
- 实务手册：素材以流程、清单、标准、案例和操作口径为主。
- 知识库：素材多主题并存，适合持续维护和检索，而不适合线性阅读。
- 暂不建议产品化：素材过散、重复、过时或缺少足够原创判断。
各形态的判断标准见 references/content-productization-models.md。
默认交付
本技能默认采用两阶段交付，并尽量减少用户需要阅读的文件数量。
第一阶段：先出一份策划意见
默认只输出：
| 文件 | 用途 |
|---|---|
书稿策划意见.md | 唯一默认交付件。集中给出最佳内容形态、是否适合成书、主命题、目标读者、结构草案、删改动作、转化路径和下一步产物 |
只有在以下情况，才额外输出支撑文件：
- 素材规模很大，需要保留通读证据
- 用户明确要求看细表
- 主题分叉明显，需要展示筛选依据
- 输入格式复杂，需要记录预处理状态
可选支撑文件包括：
| 文件 | 用途 |
|---|---|
processed/agent_reading_notes.md | Agent 分批通读后的内部阅读笔记 |
processed/article_inventory.csv | 脚本建立的基础清单索引 |
processed/article_inventory.jsonl | 结构化索引 |
附录-排除与降权清单.md | 仅在需要解释筛选依据时输出 |
第二阶段：确认后生成对应形态初稿
如果用户确认第一阶段意见无误，则直接进入内容重构，不再先产出大批中间文件。
默认输出取决于第一阶段判断：
| 推荐形态 | 默认初稿 |
|---|---|
| 成书 | 全书初稿.md |
| 小册子 | 小册子初稿.md |
| 课程 | 课程大纲与讲稿初稿.md |
| 系列文章 | 系列文章规划与首批初稿.md |
| 实务手册 | 实务手册初稿.md |
| 知识库 | 知识库结构与核心条目.md |
仅当内容过长、需要分章并行起草或用户明确要求拆分时，才输出：
| 文件 | 用途 |
|---|---|
chapters/01-*.md ... | 分章或分单元初稿 |
全书结构说明.md / 内容结构说明.md | 记录章节边界、统一术语和合并规则 |
完整模板见 references/output-template.md。
工作流程
Step 1：确认源目录、文件类型、工作模式与输出位置
- 确认用户给的是单一主题目录，还是多个主题混放目录
- 默认优先处理已文本化的素材，如
.md、.markdown、.mdx、.txt、.srt、.vtt - 对
.docx、.pdf，先作为“需预处理素材”纳入清单；能直接提取文本时再进入通读 - 对课程视频、录音、播客等非文本素材，先转写为逐字稿再纳入判断
- 对图片、附件、配图目录先排除，避免把配图误识别成正文内容
- 明确采用快速盘点、标准策划还是深度重构
- 明确输出落在源目录
书稿策划输出/
不同来源的处理方式见 references/source-type-handling.md。
Step 2：先让 Agent 通读全部候选文本素材
这是本技能的主流程，不可跳过。
- 对能直接读取的文本素材，Agent 应尽量全部通读，而不是只看标题、预览或脚本统计结果
- 如果目录较大，可按批次通读，例如每批 10-20 份素材；每读完一批，立刻记录笔记
- 每份素材至少记录：
- 一句话摘要
- 它主要在回答什么问题
- 它更适合作为主章节、案例、附录、课程单元、手册条目还是应移出
- 是否存在强时效性、重复表达、深度不足、口语化过强或格式预处理问题
通读记录建议沉淀到：
processed/agent_reading_notes.md
但该文件默认视为内部工作底稿，不应自动作为用户第一阅读入口。
更细的通读方式见 references/agent-reading-protocol.md。
Step 3：通读后先做“保留 / 降权 / 排除”筛选
在开始主题聚类之前，先把低价值内容筛掉，不要把所有素材都硬塞进最终产物。
优先排除或降权以下内容：
- 老而浅：时间较早，且只停留在信息罗列、工具介绍、表层观点，没有形成今天仍有价值的判断框架
- 过时失效：高度依赖某次产品更新、某个版本功能、某个热点事件，且难以改写为常青表达
- 重复但更弱：与另一份素材表达的是同一判断，但论证、案例、结构和表达都明显更弱
- 只有热闹没有母题：看起来吸睛，但与主线关联很弱
- 内容密度过低：篇幅不短，但信息增量很少，难以支撑章节、单元或条目
筛选时要注意：
- 老内容不等于低质量
- 短内容不等于低质量
- 排除要说明理由
筛选标准见 references/content-screening-rubric.md。
Step 4：在筛选基础上建立素材清单，脚本只做辅助
如需补路径、查漏或生成基础索引，可运行：
python3 scripts/build_article_inventory.py "<源目录>" --output-dir "<输出目录>/processed"但要注意：
- 该脚本只用于补路径、查漏、做基础索引和标记需预处理素材
- 不得仅凭脚本输出就直接做主题判断
.docx、.pdf在脚本中只标记为需预处理，不直接解析正文- 如果 Agent 通读记录与脚本字段冲突，以通读理解为准，再人工校正
Step 5：抽取主题和内容形态，而不是只看标题
读取清单后，至少要覆盖：
- 高密度代表素材
- 看似相近但论点不同的素材
- 可能属于边缘主题的素材
- 标题像工具测评、但正文承载方法论的素材
- 口语化很强、但内里已经有章节、课程单元或手册条目雏形的逐字稿
- 看似零散但可沉淀为知识库条目的笔记或会议纪要
不要只根据标题聚类。正文中反复出现的“问题意识、判断口径、方法论词汇、操作步骤、案例结构、叙事张力”，通常比标题更能决定最终形态。
Step 6：识别“母题”与“最合适的内容产品”
先把素材按主题簇归类，再判断它们能否收束成稳定内容产品。
重点识别：
- 作者反复回答的是哪一个核心问题
- 作者与同类写作相比真正有区分度的视角是什么
- 素材更适合线性阅读、系统学习、快速查阅，还是持续维护
- 这些内容更像“同一本书的不同章节”，还是“多个内容产品的种子”
如果目录里同时存在两条以上都足够强的主线，不要硬拼成一本书。应明确提出：
- 方案 A：聚焦为一本书
- 方案 B：拆成两本书 / 一本书 + 一套课程 / 手册 + 知识库
- 方案 C：暂不成书，先做系列文章或素材库收束
Step 7：评估成书可行性，并给出替代形态建议
按 references/book-viability-rubric.md 逐项判断：
- 主题集中度
- 核心命题清晰度
- 目标读者清晰度
- 内容厚度与互补性
- 观点区分度
- 时效风险
- 可持续扩写空间
输出时必须同时明确：
- 最佳内容形态：成书 / 小册子 / 课程 / 系列文章 / 实务手册 / 知识库 / 暂不建议产品化
- 成书结论：可以直接进入书稿策划 / 可以成书但需收束重写 / 暂不建议成书
- 替代路径：如果不成书，最适合转向什么产物，以及为什么
Show full SKILL.md (177 more words)Show less
Step 8：收束成一份 书稿策划意见.md
默认不要把分析过程拆成很多用户可见文件。
应把以下内容集中写进一份 书稿策划意见.md：
- 最佳内容形态
- 是否值得成书
- 不建议走的形态
- 推荐主命题
- 目标读者与差异化
- 推荐结构草案
- 哪些内容保留、哪些压缩、哪些删除
- 保留 / 合并 / 排除的核心原则
- 转化路径与下一步产物
- 如果用户确认推进，第二阶段将如何直接生成对应初稿
只有当用户明确要求，或素材规模特别大、争议特别多时，才把筛选清单、总表和阅读笔记额外显性输出。
Step 9：如用户确认，直接进入第二阶段生成初稿
如果用户对 书稿策划意见.md 表示认可，则直接推进，不必再停留在更多策划文件上。
默认做法：
- 先按意见中的推荐结构建立章节、单元或条目骨架
- 以现有素材为底稿做合并、删改、重写与补写
- 默认输出与推荐形态对应的单文件初稿
当素材很多时，可以：
- 用 subagents 按批次通读素材
- 用 subagents 分章、分单元或分条目起草初稿
- 但主 Agent 必须负责：
- 统一主命题与读者对象
- 统一术语和表达口径
- 去除重复论证
- 做最后的结构收束与总稿合并
Step 10：只有在必要时才回退到细分文件
以下情况才建议回退到多文件包：
- 用户明确要求逐份核对素材去向
- 需要向第三方展示筛选依据
- 主题分叉严重，需要比较多个内容形态方案
- 第二阶段已经启动，需要保留更细的编辑台账
无论输出是一份还是多份，内部都仍应完成以下判断：
直接保留局部吸收合并重写拆分改写仅作案例/附录/练习/条目移出本产物
判断原则
- 内容形态优先于成书冲动：不是所有素材都该写成书，先判断最适合用户目标和素材状态的形态。
- 母题优先于素材数量：素材多不代表能成书，关键看是否围绕同一问题持续推进。
- 区分度优先于覆盖面：一本书或课程最重要的是独特的判断框架，不是把所有话题都讲一遍。
- 读者问题优先于作者时间线：结构应按读者理解顺序组织，而不是按素材产生顺序排列。
- 常青内容优先于时评热度：遇到强时效内容，要评估其能否改写成长期有效的案例或论证。
- 证据可回溯：主题判断、结构映射和删改建议都应尽量回指原文件路径。
- 允许得出“不适合成一本书”：如果内容天然分叉，不要强行整合。
- 全文阅读优先于脚本结论：最终判断必须建立在 Agent 已覆盖全部可读候选文本素材的前提上。
- 先减法，再结构化：通读后先剔除低价值内容，再做结构设计，避免成品被低质量旧内容拖垮。
- 默认减少用户阅读负担：能用一份主意见讲清楚的，不拆成 6-8 份用户文件。
输出质量要求
- 结论必须明确，不要只做模糊描述
- 必须同时说明“最佳内容形态”和“是否适合成书”
- 每个重大判断尽量附对应素材或主题簇依据
- 区分“内容已有”与“必须补写”
- 区分“适合出版成书”与“更适合课程、专栏、手册、知识库”
- 对缺失信息标注
未提及 / 待补充 / 需作者确认
协作工具
| 工具 | 用途 |
|---|---|
| Agent / 文件读取能力 | 主流程：分批通读全部可读素材，并形成阅读笔记 |
| Subagent / 并行 Agent | 素材量大时并行通读、分章/分单元起草，但最终判断与总稿统一必须回到主 Agent |
python3 | 可选辅助：运行 scripts/build_article_inventory.py 建立索引、补路径、查漏、标记需预处理素材 |
| Markdown 输出能力 | 第一阶段生成单文件 书稿策划意见.md，第二阶段生成对应形态初稿 |
参考文件
| 文件 | 说明 |
|---|---|
references/agent-reading-protocol.md | Agent 通读素材、分批记笔记和形成初步判断的建议流程 |
references/content-screening-rubric.md | 通读后判断“保留 / 降权 / 排除”的筛选标准 |
references/content-productization-models.md | 书、小册子、课程、专栏、手册、知识库等内容形态的判断标准 |
references/source-type-handling.md | 不同来源素材的处理方式和预处理规则 |
references/output-template.md | 默认输出模板 |
references/book-viability-rubric.md | 成书可行性评估维度与替代形态建议 |
scripts/build_article_inventory.py | 素材目录扫描与索引脚本（可选辅助） |
依赖
系统依赖
| 依赖 | 安装方式 |
|---|---|
python3 | macOS: 系统自带或 brew install python<br>Linux: sudo apt-get install python3 |
Python 包
| 包名 | 用途 | 安装命令 |
|---|---|---|
| 无额外第三方依赖 | 脚本仅使用 Python 标准库；脚本为可选辅助 | 无需安装 |
注意事项
- 如果目录中混有大量图片、配图目录或自动生成素材，先排除再分析。
- 如果文章横跨两个强主题，例如“法律 AI 方法论”和“通用 AI 哲学随笔”，应优先考虑拆书或拆成书 + 课程 / 知识库。
- 如果文章标题很像资讯或测评，但正文承载了稳定的方法论，应按方法论价值而不是标题风格判断去向。
- 如果用户已经有明确出版方向，本技能应服务于收束和整合；如果用户还没有方向，本技能应先做形态判断而不是急于起目录。
- 默认不要向用户交付太多中间文件。能用一份
书稿策划意见.md讲清楚的，就不要拆成 6-8 份结果。 - 第二阶段默认直接生成对应形态初稿，不再让用户先阅读大量过渡性文件。
© cat-xierluo, 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 9 other files (scripts, references) in skills/article2book of cat-xierluo/legal-skills.
- SKILL.md
- CHANGELOG.md
- LICENSE.txt
- references/agent-reading-protocol.md
- references/book-viability-rubric.md
- references/content-productization-models.md
- references/content-screening-rubric.md
- references/output-template.md
- references/source-type-handling.md
- scripts/build_article_inventory.py
Open the folder on GitHubat commit c077fcc
Compare with similar skills
Article2book 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 |
|---|---|---|---|---|---|---|
| Article2book this skillcat-xierluo/legal-skills | 713 | — | ~2.1k | Automated safety check: Notes | MIT | |
| Markdown Article FormatterJimLiu/baoyu-skills | 26k | 7 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 | |
| Gzh Designisjiamu/gzh-design-skill | 3.9k | 1 repos | ~2.2k | Automated safety check: Pass | AGPL-3.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).
Gzh Design
isjiamu/gzh-design-skill
微信公众号文章排版引擎，将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取，自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入（非 Markdown…
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.
More from cat-xierluo/legal-skills
All 62 skills in this repoElements-Style Complaint Generator
cat-xierluo/legal-skills
Converts a lawyer's ordinary complaint or a described case into the Supreme People's Court's elements-style Word template, with layout checks on the result.
Lecture Performance Review
cat-xierluo/legal-skills
Analyzes raw lecture transcripts for verbal tics, pacing, time use and promise follow-through, with optional slide-by-slide comparison and cross-session tracking.
De-AI Polish for Chinese Articles
cat-xierluo/legal-skills
Detects and rewrites machine-sounding patterns in the body text of Chinese articles while keeping the author's facts, headings and legal terms intact.
GitHub Star Manager
cat-xierluo/legal-skills
Finds GitHub projects mentioned in articles or screenshots and stars them, tracks updates to your starred repos, and builds an HTML dashboard to browse them.
Legal Harness Initializer
cat-xierluo/legal-skills
Sets up or incrementally updates AGENTS.md and CLAUDE.md for legal professionals, with a minimal safety baseline and a check that a new session loads and follows the rules.
Moot Court Simulation Builder
cat-xierluo/legal-skills
Chinese-language skill that organizes a case file into a multi-role mock trial with judge, parties and clerk, producing a transcript, issue review and a to-strengthen list.
Related
Categories
Questions about Article2book
What does Article2book do?
基于现有文章、专栏、课程讲稿、逐字稿、访谈、课件、会议纪要、案例材料、PDF 文本、Word 文档和笔记等内容资产，判断它们最适合转化为书、小册子、课程、系列文章、实务手册或知识库，并输出精简策划意见；用户提到“把现有内容整理成书”“判断素材适合做书还是课程”“把文章/直播稿/课程稿/笔记重组成知识产品”等场景时，应使用本技能。. Article2book is an agent skill from cat-xierluo/legal-skills.
When should I use Article2book?
Article2book fits situations like: documents & Office work in your project.
How do I install Article2book in Claude Code?
Run `npx skills add cat-xierluo/legal-skills --skill article2book -a claude-code`. Or copy the skill folder (skills/article2book in cat-xierluo/legal-skills) into .claude/skills/article2book in your project. Claude Code loads it when a task matches its description.
How do I install Article2book in Codex?
Run `npx skills add cat-xierluo/legal-skills --skill article2book -a codex`. Or copy the skill folder (skills/article2book in cat-xierluo/legal-skills) into .agents/skills/article2book in your project. Codex loads it when a task matches its description.
Can I use Article2book 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 cat-xierluo/legal-skills --skill article2book -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/article2book, .gemini/skills/article2book, .github/skills/article2book and .opencode/skills/article2book in your project.
What does Article2book need to run?
Going by SKILL.md and its folder, Article2book needs Python for the scripts in its folder and the command-line tools its instructions call (python3, brew and apt-get). Our summary lists: Python 3.
Does Article2book 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 Article2book safe to install?
Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. 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 Article2book use?
Article2book is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Article2book use?
About 2.1k tokens (SKILL.md is roughly 8.3k 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 5.8k tokens, read only when the agent opens those files.
What are the alternatives to Article2book?
Skills that share tags, products or a category with Article2book: Markdown Article Formatter (JimLiu/baoyu-skills, 26k 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 Article2book?
cat-xierluo (a GitHub user) maintains it in cat-xierluo/legal-skills, which has 713 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on October 7, 2026.
Source: cat-xierluo/legal-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.