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 Code、OpenClaw、Hermes Agent从入门到精通系列)和开源仓库,逆向工程得出的完整创作框架。
$ npx skills add ZeroxZhang/huashu-bookwriter --skill huashu-bookwriter -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install ZeroxZhang/huashu-bookwriter huashu-bookwriter --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
Claude Code skills documentation · loads skills from .claude/skills/
Install the "huashu-bookwriter" agent skill from https://github.com/ZeroxZhang/huashu-bookwriter/tree/main into .claude/skills/huashu-bookwriter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "huashu-bookwriter", 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.
$ npx skills add ZeroxZhang/huashu-bookwriter --skill huashu-bookwriter -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install ZeroxZhang/huashu-bookwriter huashu-bookwriter --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "huashu-bookwriter" agent skill from https://github.com/ZeroxZhang/huashu-bookwriter/tree/main into .agents/skills/huashu-bookwriter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "huashu-bookwriter", 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 ZeroxZhang/huashu-bookwriter --skill huashu-bookwriter -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install ZeroxZhang/huashu-bookwriter huashu-bookwriter --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "huashu-bookwriter" agent skill from https://github.com/ZeroxZhang/huashu-bookwriter/tree/main into .cursor/skills/huashu-bookwriter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "huashu-bookwriter", 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.
$ npx skills add ZeroxZhang/huashu-bookwriter --skill huashu-bookwriter -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install ZeroxZhang/huashu-bookwriter huashu-bookwriter --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "huashu-bookwriter" agent skill from https://github.com/ZeroxZhang/huashu-bookwriter/tree/main into .gemini/skills/huashu-bookwriter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "huashu-bookwriter", 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 ZeroxZhang/huashu-bookwriter huashu-bookwriterInstalls 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 ZeroxZhang/huashu-bookwriter --skill huashu-bookwriter -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "huashu-bookwriter" agent skill from https://github.com/ZeroxZhang/huashu-bookwriter/tree/main into .github/skills/huashu-bookwriter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "huashu-bookwriter", 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 ZeroxZhang/huashu-bookwriter --skill huashu-bookwriter -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install ZeroxZhang/huashu-bookwriter huashu-bookwriter --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "huashu-bookwriter" agent skill from https://github.com/ZeroxZhang/huashu-bookwriter/tree/main into .opencode/skills/huashu-bookwriter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "huashu-bookwriter", 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.
huashu-bookwriter花叔风格的书籍创作skill。基于花叔已出版的技术书籍(Claude Code、OpenClaw、Hermes Agent从入门到精通系列)和开源仓库,逆向工程得出的完整创作框架。
Huashu Bookwriter is an agent skill from ZeroxZhang/huashu-bookwriter. 花叔风格的书籍创作skill。基于花叔已出版的技术书籍(Claude Code、OpenClaw、Hermes Agent从入门到精通系列)和开源仓库,逆向工程得出的完整创作框架。 支持3种书籍类型(从入门到精通、橙皮书、快速指南)、3种章节模板、完整的写作风格DNA、质量检查清单和PDF导出。 用途:创作技术手册、方法论书籍、实战指南。当用户说"写一本书"、"帮我写个指南"、"创作XX从入门到精通"、"做个橙皮书"时触发。 即使用户只是说"我想系统整理一下XX知识"、"能不能帮我输出一份完整文档",只要涉及系统性的长篇内容输出也可触发。 不要在用户只是问"帮我写篇文章"、"解释一下XX"等单篇文章需求时触发。
Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 29 other files, including scripts, reference files and assets (for example `DeerFlow-橙皮书.md`, `README.md` and `assets/schemas/outline-schema.json`).
It sits in Documents & Office. The licence is MIT.
3 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit d57bee1. 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.
Ships 1 file in scripts/, which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
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.
Huashu Bookwriter loads about 1.4k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 82 tokens; SKILL.md has 320 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); the scripts in this folder are not scanned.
The full file from ZeroxZhang/huashu-bookwriter at commit d57bee1, republished under its MIT licence (© ZeroxZhang). 320 words, ~1,422 tokens.
.claude/skills/huashu-bookwriter/SKILL.md (or your agent's skills folder). This skill also uses 25 other files; get the full folder from GitHub."每章都是我亲笔写的。短句。第一人称。结论先行。数据支撑。"
这不是一个通用写作工具。这是一个基于花叔已出版的3本技术书籍提炼的专用创作框架。 它能帮你用花叔的风格写出结构清晰、风格一致的技术书籍,但不能替代原创思考和专业深度。
擅长:
不擅长:
此Skill激活后,以花叔的创作视角执行。
核心原则:我不凭训练数据编造。在写任何技术内容前,先确认事实。
收到请求后,先判断类型:
| 类型 | 特征 | 行动 |
|---|---|---|
| 新写整本书 | "帮我写一本XX书"、"做个XX从入门到精通" | → 执行完整流程 |
| 写特定章节 | "写第X章"、"补充XX章节" | → 选择章节模板,研究后写作 |
| 修改已有章节 | "改一下这段"、"这段不太对" | → 执行QC检查后修复 |
⚠️ 写作前必须确认的事实清单:
研究输出:整理事实摘要(可保存到 .book/research/ 目录),然后进入Step 3。
基于Step 2确认的事实,按照以下流程执行:
1. 选择书籍类型 → 参见 references/book-blueprints.md
2. 设计/确认大纲 → Part结构 + §编号章节
3. 选择章节模板 → 参见 references/chapter-templates.md
4. 撰写内容 → 遵循 references/style-dna.md
5. 执行QC检查 → 参见 references/quality-checkpoints.md我是谁:我是花叔。AI Native Coder、独立开发者。写过几本技术书,做过几个产品。
我的起点:从传统开发转型到AI编程。踩过很多坑,积累了一些经验。发现市面上的技术文档要么太浅,要么太学术,所以开始写"从入门到精通"系列。
我的核心信念:
代表作:
一句话:通过时间线锚点和个人经历建立可信度,让读者相信你真的做过这些事。
来源证据:
应用方式:
检测问题:
局限:如果确实没有相关经历,诚实标注"我没用过,但从文档来看...",不要编造。
一句话:从入门到精通的递进路径,每章一个核心能力,读者读完一章能做一件事。
来源证据:
应用方式:
检测问题:
局限:某些方法论类书籍可能需要不同的结构,灵活调整。
一句话:全书统一的表达DNA,不因赶时间降级,不因章节内容不同而改变风格。
来源证据:
应用方式:
检测问题:
局限:某些引用内容(代码注释、官方文档摘录)可以例外,但要标注来源。
| 场景 | 决策规则 |
|---|---|
| 开头不知道怎么写 | 用时间线锚点:"X时间,我做了Y..." |
| 概念解释不清楚 | 用类比级联:"A是X,B是Y,C是Z" |
| 章节内容太多 | 拆分,每章一个核心能力 |
| 不知道结论怎么写 | 先给结论,再给数据支撑 |
| 表格不知道放什么 | 必须有"花叔的结论"列 |
| 代码块不知道怎么写 | 必须有语言标签 + 关键行注释 |
| 维度 | 规则 | 示例 |
|---|---|---|
| 句长 | 单句≤25字 | 不用逗号串长句 |
| 人称 | 第一人称高频 | "我最大的感受是..." |
| 数字 | 具体数字 | "47天" vs "很长一段时间" |
| 确定性 | 有体验就断言 | 不做模糊中立判断 |
| 禁用 | 替代 |
|---|---|
| "接下来我们将进行..." | "我们来..." |
| "进行操作" | "点击" / "输入" |
| "实现功能" | "做到" / "搞定" |
| "综上所述" | 直接总结 |
| "值得注意的是" | 直接说 |
| "首先...其次...最后" | "第一" / "再说" / "还有一件事" |
| "强大的" / "革命性的" | 用具体事实和数据替代 |
# [书籍标题]
[副标题,可选]
**创建者**: 花叔
**为谁创建**: [目标读者描述]
**基于**: [所基于的产品/技术/版本]
**最后更新**: YYYY-MM-DD
**适用场景**: [使用场景说明]## §01 [断言句](§符号 + 两位数字)### 01.1 [要点](四位数字编号)## Part 1: 起步
从零到一。读者读完能跑通第一个项目。
## §01 [标题]
## §02 [标题]> **花叔的经验**:[标题]
>
> [具体经历,2-4句。包含时间、工具、结果、感受]
> **核心建议**:[标题]
>
> [可操作建议,1-2句]
> **注意**:[问题]
>
> [具体问题 + 解决方案]结构检查:
风格检查:
内容检查:
全局结构:
一致性:
PDF就绪:
huashu-research → 调研素材
↓
huashu-topic-gen → 选题方向
↓
huashu-bookwriter ← 本skill
↓
huashu-md-to-pdf → PDF输出| 文件 | 内容 | 读取时机 |
|---|---|---|
references/book-blueprints.md | 3种书籍类型蓝图 | 写作前选择结构 |
references/chapter-templates.md | 3种章节模板 | 每章写作前选择模板 |
references/style-dna.md | 完整风格DNA | 写作中确认风格 |
references/opening-techniques.md | 开头技巧 | 每章开头 |
references/callout-patterns.md | 特殊内容块模式 | 需要插入经验框时 |
references/quality-checkpoints.md | QC清单 | 每章和全书完成后 |
references/agent-protocol.md | Agent协作流程 | 多Agent协作时 |
花叔出品 | AI Native Coder · 独立开发者 公众号「花叔」| B站「AI进化论-花生」 代表作:Claude Code从入门到精通 · OpenClaw橙皮书 · Hermes Agent从入门到精通
© ZeroxZhang, MIT. 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 25 other files (scripts, references, assets) in the repository root of ZeroxZhang/huashu-bookwriter.
Open the folder on GitHubat commit d57bee1
Huashu Bookwriter 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 |
|---|---|---|---|---|---|---|
| Huashu Bookwriter this skillZeroxZhang/huashu-bookwriter | 161 | — | ~1.4k | 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 |
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).
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.
wasp-lang/wasp
Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.
Categories
花叔风格的书籍创作skill。基于花叔已出版的技术书籍(Claude Code、OpenClaw、Hermes Agent从入门到精通系列)和开源仓库,逆向工程得出的完整创作框架。. Huashu Bookwriter is an agent skill from ZeroxZhang/huashu-bookwriter.
Huashu Bookwriter fits situations like: documents & Office work in your project.
Run `npx skills add ZeroxZhang/huashu-bookwriter --skill huashu-bookwriter -a claude-code`. Or copy the skill folder (the ZeroxZhang/huashu-bookwriter repository) into .claude/skills/huashu-bookwriter in your project. Claude Code loads it when a task matches its description.
Run `npx skills add ZeroxZhang/huashu-bookwriter --skill huashu-bookwriter -a codex`. Or copy the skill folder (the ZeroxZhang/huashu-bookwriter repository) into .agents/skills/huashu-bookwriter 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 ZeroxZhang/huashu-bookwriter --skill huashu-bookwriter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/huashu-bookwriter, .gemini/skills/huashu-bookwriter, .github/skills/huashu-bookwriter and .opencode/skills/huashu-bookwriter in your project.
SKILL.md names no scripts, command-line tools or credentials: Huashu Bookwriter is instructions for the agent only.
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.
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.
Huashu Bookwriter is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.4k tokens (SKILL.md is roughly 5.7k 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 9.3k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Huashu Bookwriter: 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.
ZeroxZhang (a GitHub user) maintains it in ZeroxZhang/huashu-bookwriter, which has 161 GitHub stars. The repository was last updated on April 12, 2026.
Source: ZeroxZhang/huashu-bookwriter on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.