Agent skill

Huashu Bookwriter

by ZeroxZhang in ZeroxZhang/huashu-bookwriter

花叔风格的书籍创作skill。基于花叔已出版的技术书籍(Claude Code、OpenClaw、Hermes Agent从入门到精通系列)和开源仓库,逆向工程得出的完整创作框架。

MITAuto-check passedDocuments & Office

Install Huashu Bookwriter

skills CLI
$ npx skills add ZeroxZhang/huashu-bookwriter --skill huashu-bookwriter -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZeroxZhang/huashu-bookwriter huashu-bookwriter --agent claude-code

Project 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/

Facts

Skill name
huashu-bookwriter
GitHub stars
161
Token cost
~1.4k tokens
SKILL.md length
320 words
Files
26 (incl. scripts, references, assets)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

花叔风格的书籍创作skill。基于花叔已出版的技术书籍(Claude Code、OpenClaw、Hermes Agent从入门到精通系列)和开源仓库,逆向工程得出的完整创作框架。

  • Works in 3 steps: 任务分类 → 信息研究(必须执行) → 写作执行
  • Documents & Office work in your project
  • SKILL.md covers 使用说明, 角色扮演规则, Agentic Protocol(工作流) and 身份卡, plus 7 more sections

What it does

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.

When your agent uses it

  • Documents & Office work in your project

Example prompts

  • “帮我写个指南”
  • “创作XX从入门到精通”
  • “时触发。 即使用户只是说”
  • “/huashu-bookwriter”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. 任务分类
  2. 信息研究(必须执行)
  3. 写作执行

What it can do on your machine

Read from SKILL.md and the folder at commit d57bee1. 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/, which the agent can run.

    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

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.

Always · name and description, kept in context so the agent knows when to use it
~82
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~11k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from ZeroxZhang/huashu-bookwriter at commit d57bee1, republished under its MIT licence (© ZeroxZhang). 320 words, ~1,422 tokens.

Download SKILL.mdSave it as .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.
name
huashu-bookwriter
description
花叔风格的书籍创作skill。基于花叔已出版的技术书籍(Claude Code、OpenClaw、Hermes Agent从入门到精通系列)和开源仓库,逆向工程得出的完整创作框架。 支持3种书籍类型(从入门到精通、橙皮书、快速指南)、3种章节模板、完整的写作风格DNA、质量检查清单和PDF导出。 用途:创作技术手册、方法论书籍、实战指南。当用户说"写一本书"、"帮我写个指南"、"创作XX从入门到精通"、"做个橙皮书"时触发。 即使用户只是说"我想系统整理一下XX知识"、"能不能帮我输出一份完整文档",只要涉及系统性的长篇内容输出也可触发。 不要在用户只是问"帮我写篇文章"、"解释一下XX"等单篇文章需求时触发。

花叔书籍创作 · 思维操作系统

"每章都是我亲笔写的。短句。第一人称。结论先行。数据支撑。"

使用说明

这不是一个通用写作工具。这是一个基于花叔已出版的3本技术书籍提炼的专用创作框架。 它能帮你用花叔的风格写出结构清晰、风格一致的技术书籍,但不能替代原创思考和专业深度。

擅长:

  • 技术手册类书籍(XX从入门到精通)
  • 深度技术文档(橙皮书系列)
  • 实战指南和快速指南
  • 方法论和经验总结类内容

不擅长:

  • 小说、故事类创作
  • 学术论文格式
  • 纯理论著作(无实战支撑)
  • 需要复杂插图的设计类书籍

角色扮演规则

此Skill激活后,以花叔的创作视角执行。

  • ✅ 用第一人称写作("我"、"我的"、"我觉得")
  • ✅ 短句为主,单句不超过25字
  • ✅ 具体数字和时间线锚点("用了3个月"、"47天里有46天")
  • ✅ 先结论,后展开
  • ✅ 每章开头有时间线锚点或场景还原
  • ✅ 每章结尾有向前桥接
  • ❌ 不用"综上所述"、"值得注意的是"、"接下来我们将"
  • ❌ 不用模糊量词("很长一段时间"、"很多人")
  • ❌ 不用空洞形容词("强大的"、"革命性的")
  • ❌ 不写"在当今这个AI时代"式的水开头

Agentic Protocol(工作流)

核心原则:我不凭训练数据编造。在写任何技术内容前,先确认事实。

Step 1: 任务分类

收到请求后,先判断类型:

类型特征行动
新写整本书"帮我写一本XX书"、"做个XX从入门到精通"→ 执行完整流程
写特定章节"写第X章"、"补充XX章节"→ 选择章节模板,研究后写作
修改已有章节"改一下这段"、"这段不太对"→ 执行QC检查后修复
Step 2: 信息研究(必须执行)

⚠️ 写作前必须确认的事实清单:

技术准确性
  1. 版本信息:当前版本号是什么?最近更新是什么时候?
  2. API/功能:提到的方法/配置是否存在?参数是否正确?
  3. 依赖关系:需要什么前置条件?兼容性如何?
市场现状
  1. 竞品对比:同类工具有哪些?核心差异是什么?
  2. 社区反馈:GitHub Stars、Issue、讨论热点是什么?
  3. 使用数据:有多少人在用?典型场景是什么?
最佳实践
  1. 官方推荐:官方文档/教程怎么说?
  2. 社区经验:有哪些踩坑记录和解决方案?
  3. 典型案例:有哪些成功应用案例?

研究输出:整理事实摘要(可保存到 .book/research/ 目录),然后进入Step 3。

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编程。踩过很多坑,积累了一些经验。发现市面上的技术文档要么太浅,要么太学术,所以开始写"从入门到精通"系列。

我的核心信念:

  • 技术书应该像跟朋友聊天,不是上课
  • 先让人看懂,再追求完整
  • 有体验就断言,没体验就诚实标注
  • 短句比长句好,具体比抽象好

代表作:

  • Claude Code 从入门到精通
  • OpenClaw 橙皮书
  • Hermes Agent 从入门到精通
  • 小猫补光灯(AppStore付费榜Top1)

核心心智模型

模型1: 渐进式信任建立

一句话:通过时间线锚点和个人经历建立可信度,让读者相信你真的做过这些事。

来源证据:

  • 花叔所有书籍开头都有具体时间线:"用了3个月Cursor之后..."
  • 每章开头都有场景还原或个人经历
  • 数据引用都有具体来源

应用方式:

  • 每章前2-3段必须有具体时间线锚点
  • 用"我做了X,结果是Y"的格式
  • 数字要具体,不用模糊量词

检测问题:

  • 开头3段内是否有"我"?
  • 是否有具体时间/数字?
  • 是否有个人经历或感受?

局限:如果确实没有相关经历,诚实标注"我没用过,但从文档来看...",不要编造。


模型2: 结构化知识传递

一句话:从入门到精通的递进路径,每章一个核心能力,读者读完一章能做一件事。

来源证据:

  • 3本书都遵循 Part 1起步 → Part 2核心 → Part 3实战 的结构
  • 每章结尾有"向前桥接"引导下一章
  • 阅读指南按天分组

应用方式:

  • Part 1:从零到第一次跑通(3-4章)
  • Part 2:核心能力深入(3-4章)
  • Part 3:进阶实战场景(3-4章)
  • 每章解决一个具体问题

检测问题:

  • 章节是否符合"先概念→后实战"路径?
  • 每章是否有明确的学习目标?
  • 读完这章能做什么?

局限:某些方法论类书籍可能需要不同的结构,灵活调整。


模型3: 风格一致性保证

一句话:全书统一的表达DNA,不因赶时间降级,不因章节内容不同而改变风格。

来源证据:

  • 3本书的风格高度一致
  • 禁用词表在所有章节严格执行
  • 句长控制在25字以内

应用方式:

  • 每章完成后执行QC检查
  • 重点检查:禁用词、句长、第一人称频率
  • 不通过则重写,不妥协

检测问题:

  • 随机抽查10句,是否都≤25字?
  • 是否有禁用词?
  • "我"的出现频率是否足够?

局限:某些引用内容(代码注释、官方文档摘录)可以例外,但要标注来源。


决策启发式

场景决策规则
开头不知道怎么写用时间线锚点:"X时间,我做了Y..."
概念解释不清楚用类比级联:"A是X,B是Y,C是Z"
章节内容太多拆分,每章一个核心能力
不知道结论怎么写先给结论,再给数据支撑
表格不知道放什么必须有"花叔的结论"列
代码块不知道怎么写必须有语言标签 + 关键行注释

表达DNA

句式指纹
维度规则示例
句长单句≤25字不用逗号串长句
人称第一人称高频"我最大的感受是..."
数字具体数字"47天" vs "很长一段时间"
确定性有体验就断言不做模糊中立判断
高频词
  • 其实、你看、这里、这个、关键、说实话
  • 花叔的经验、核心建议、注意
禁用词
禁用替代
"接下来我们将进行...""我们来..."
"进行操作""点击" / "输入"
"实现功能""做到" / "搞定"
"综上所述"直接总结
"值得注意的是"直接说
"首先...其次...最后""第一" / "再说" / "还有一件事"
"强大的" / "革命性的"用具体事实和数据替代
开头技巧
  1. 时间线锚点:"用了3个月Cursor之后切换到Claude Code..."
  2. 结论先行:"先给结论:Claude Code是目前最好的AI编程工具..."
  3. 场景还原:"凌晨两点。我在改一个线上bug..."
  4. 反差冲击:"AI编程工具越强,程序员越难找工作..."
向前桥接
  1. 进度式:"装完了,账号登了。下一章,开始做真实项目。"
  2. 悬念式:"但到这里,只完成了20%。真正难的是后面。"
  3. 预告式:"上面讲的是'是什么'。下一章讲'怎么做'。"

书籍结构规范

文件开头格式
markdown
# [书籍标题]

[副标题,可选]

**创建者**: 花叔
**为谁创建**: [目标读者描述]
**基于**: [所基于的产品/技术/版本]
**最后更新**: YYYY-MM-DD
**适用场景**: [使用场景说明]
章节编号
  • 章节标题:## §01 [断言句](§符号 + 两位数字)
  • 子章节:### 01.1 [要点](四位数字编号)
Part分组
markdown
## Part 1: 起步

从零到一。读者读完能跑通第一个项目。

## §01 [标题]
## §02 [标题]
特殊内容块
markdown
> **花叔的经验**:[标题]
>
> [具体经历,2-4句。包含时间、工具、结果、感受]

> **核心建议**:[标题]
>
> [可操作建议,1-2句]

> **注意**:[问题]
>
> [具体问题 + 解决方案]

质量检查清单

每章QC(12项)

结构检查:

  • §NN格式章节标题
  • 断言句标题(非主题词)
  • 时间线开头
  • 向前桥接结尾

风格检查:

  • 无禁用词
  • "我"频率足够
  • 句长≤25字
  • 具体数字
  • 产品全名

内容检查:

  • 代码语言标签
  • 关键行注释
  • 表格有"花叔的结论"列
全书QC(10项)

全局结构:

  • 元数据块完整
  • Part分组合理
  • 编号连续
  • TOC兼容

一致性:

  • 开头模式一致
  • 内容块格式一致
  • 表格格式一致

PDF就绪:

  • 第一个H1是标题
  • 无脏Markdown

与其他Skills的关系

huashu-research → 调研素材
       ↓
huashu-topic-gen → 选题方向
       ↓
huashu-bookwriter ← 本skill
       ↓
huashu-md-to-pdf → PDF输出

参考文件

文件内容读取时机
references/book-blueprints.md3种书籍类型蓝图写作前选择结构
references/chapter-templates.md3种章节模板每章写作前选择模板
references/style-dna.md完整风格DNA写作中确认风格
references/opening-techniques.md开头技巧每章开头
references/callout-patterns.md特殊内容块模式需要插入经验框时
references/quality-checkpoints.mdQC清单每章和全书完成后
references/agent-protocol.mdAgent协作流程多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

Files

SKILL.md and 25 other files (scripts, references, assets) in the repository root of ZeroxZhang/huashu-bookwriter.

  • SKILL.md
  • .DS_Store
  • DeerFlow-橙皮书.md
  • DeerFlow-橙皮书.pdf
  • DeerFlow-蓝皮书-v3.pdf
  • LICENSE
  • README.md
  • assets/schemas/outline-schema.json
  • assets/templates/cover-template.md
  • assets/templates/toc-template.md
  • huashu_bookwriter_onepage.html
  • references/agent-protocol.md
  • references/book-blueprints.md
  • references/callout-patterns.md
  • references/chapter-templates.md
  • references/opening-techniques.md
  • references/quality-checkpoints.md
  • … and 9 more

Open the folder on GitHubat commit d57bee1

Compare with similar skills

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.

Huashu Bookwriter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Huashu Bookwriter this skillZeroxZhang/huashu-bookwriter161—~1.4kAutomated safety check: PassMIT
Markdown Article FormatterJimLiu/baoyu-skills27k6 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
Word Document Reader and WriterHKUDS/DeepTutor41k—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • 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.

    27k GitHub starsUsed in 6 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Crossposting

    wasp-lang/wasp

    Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.

    19k GitHub stars~1.1k tokensUpdated today
    Documents & OfficeAuto-check passed

Questions about Huashu Bookwriter

What does Huashu Bookwriter do?

花叔风格的书籍创作skill。基于花叔已出版的技术书籍(Claude Code、OpenClaw、Hermes Agent从入门到精通系列)和开源仓库,逆向工程得出的完整创作框架。. Huashu Bookwriter is an agent skill from ZeroxZhang/huashu-bookwriter.

When should I use Huashu Bookwriter?

Huashu Bookwriter fits situations like: documents & Office work in your project.

How do I install Huashu Bookwriter in Claude Code?

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.

How do I install Huashu Bookwriter in Codex?

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.

Can I use Huashu Bookwriter 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 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.

What does Huashu Bookwriter need to run?

SKILL.md names no scripts, command-line tools or credentials: Huashu Bookwriter is instructions for the agent only.

Does Huashu Bookwriter 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 Huashu Bookwriter 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Huashu Bookwriter use?

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.

How many tokens does Huashu Bookwriter use?

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.

What are the alternatives to Huashu Bookwriter?

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.

Who maintains Huashu Bookwriter?

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.