word-format-skill

Name: word-format-skill
Author: yeap531

Verified

Claude Code skill: replicate a reference Word (.docx) typography onto new content via HTML bridge — browser render → clipboard → Word paste. Append-mode preserves page setup / styles / theme / headers 100%. macOS only.

221stars

9forks

Shell

Installation

# Add to your Claude Code skills
git clone https://github.com/yeap531/word-format-skill

Getting Started

Guides for using cli tools skills like word-format-skill.

Getting Started with AI Skills
First-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
SkillsLLM Features Guide
Voting, bookmarks, comments, comparison pages, and security scanning explained.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.

Security ReportVerified

Last scanned: 5/30/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-30T15:32:30.013Z",
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is word-format-skill?

word-format-skill is an open-source cli tools skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by yeap531. Claude Code skill: replicate a reference Word (.docx) typography onto new content via HTML bridge — browser render → clipboard → Word paste. Append-mode preserves page setup / styles / theme / headers 100%. macOS only. It has 221 GitHub stars.

Is word-format-skill safe to use?

Yes. word-format-skill passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install word-format-skill?

Clone the repository with "git clone https://github.com/yeap531/word-format-skill" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is word-format-skill written in?

word-format-skill is primarily written in Shell. It is open-source under yeap531 on GitHub, so you can review or fork the full source.

Are there alternatives to word-format-skill?

Yes. SkillsLLM lists many other CLI Tools skills you can browse and compare side by side. Open the CLI Tools category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh word-format-skill against similar tools.

LLM Engineer for Beginners

Ship LLM features to production - prompts, RAG, structured outputs, evaluation

39 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

217,910

Popular in CLI Tools

Top skills in this category by stars

claude-code-templates

by davila7

CLI tool for configuring and monitoring Claude Code

28,164

claude-code-zed claudetop

word-format-skill

一个 Claude Code skill：把一份参考 Word (.docx) 的排版样式（字体 / 字号 / 缩进 / 行距 / 对齐 / 页面设置 / 样式表 / 主题 / 页眉页脚）视觉一致地复刻到新内容上。

仅在 macOS 工作（依赖 Microsoft Word + 浏览器 + System Events 的 UI 自动化）。

它解决什么问题

让 AI 写一份 Word 文档时，最痛苦的不是写内容，而是排版——把 AI 输出的 Markdown / 纯文本粘进 Word，字体、字号、缩进总会乱。

这个 skill 不让 AI 凭空生成 HTML / OOXML，而是：让 Word 自己导出一份 inline-CSS 的 Filtered HTML，AI 在这份"原件"上只改文字内容，所有样式标签原样保留。 然后浏览器把它渲染成富文本，进系统剪贴板，粘进 Word。

参考 .docx
   │ ① docx_to_html.py（驱动 Word 自己另存为筛选过的网页）
   ▼
Word Filtered HTML（所有样式以 inline CSS 写入每个标签）
   │ ② Claude 在原件上增删改文字（保留所有 inline style）
   ▼
edited.html / append.html
   │ ③ render_and_paste.sh
   │   浏览器渲染 → 系统剪贴板（HTML+RTF）→ Word 粘贴 → 保存
   ▼
最终 .docx

不走「AI 生成 HTML 代码」这条路，AI 始终编辑的是 Word 自己产出的"标准模板"——这是当前所知 AI → Word 损失最小的链路。

两种工作模式

模式	命令	能保留
B. 续写（推荐）	`--append-to <reference.docx>`	100% 模板：页面设置、样式表、主题、页眉页脚、字体表 + 字符级排版
A. 新建	（不带 `--append-to`）	仅字符 / 段落级排版（字体 / 字号 / 缩进 / 行距 / 对齐）

想 100% 保留模板格式 → 必须用模式 B。诀窍是把原 .docx 副本作为承载文档，新内容只追加到末尾，原文档的页面设置 / 样式表 / 主题原封不动地继承下来——浏览器粘贴管线本身只能传字符级直接属性，不传 @page / 样式表 / theme1.xml。

环境要求

OS：macOS
Microsoft Word for Mac（/Applications/Microsoft Word.app）
浏览器：Google Chrome（首选）或 Safari
Python 3：系统自带，无第三方依赖

首次运行须开启系统授权：

系统设置 → 隐私与安全性 → 自动化：勾选允许「终端宿主进程（Terminal / iTerm / Ghostty / Claude Code）」控制 Microsoft Word、Chrome（或 Safari）、System Events
系统设置 → 隐私与安全性 → 辅助功能：启用同一个宿主进程

环境检查：

bash skills/word-format/scripts/verify_env.sh

安装

通过 Claude Code 插件商店

/plugin marketplace add yeap531/word-format-skill
/plugin install word-format@word-format-skill

或手动 clone

git clone https://github.com/yeap531/word-format-skill.git

快速开始

# 1. 把参考 docx 导出为 inline-CSS HTML
python3 skills/word-format/scripts/docx_to_html.py "/path/to/reference.docx"
# → 产物：~/Library/Caches/word-format-skill/<basename>.html

# 2. （Claude 这一步）从原件挑一段同类型段落作模板，复制完整 inline style，
#    在 ~/Library/Caches/word-format-skill/append.html 写要追加的新内容
#    所有 inline style 原样保留，只换文字。

# 3. 续写模式：复制原 docx 副本 → 末尾粘贴 → 保存
bash skills/word-format/scripts/render_and_paste.sh \
    --append-to "/path/to/reference.docx" \
    ~/Library/Caches/word-format-skill/append.html \
    ~/Desktop/最终输出.docx

第 2 步 Claude 必须遵守的 8 条硬约束（inline CSS / pt 单位 / 表格 align="center" / <body> 无 padding margin / 字体白名单等）见 skills/word-format/SKILL.md。

⚠️ 第 3 步运行期间（约 5~7 秒）不要动鼠标键盘，UI 自动化在跑。脚本结束会把焦点还给运行前的前台应用。

文件结构

word-format-skill/
├── .claude-plugin/
│   └── marketplace.json            # Claude Code 插件商店配置
├── skills/
│   └── word-format/
│       ├── SKILL.md                # Skill 核心指令（8 条契约 + 完整流程 + 故障排查）
│       └── scripts/
│           ├── docx_to_html.py     # 步骤 ①：参考 docx → Filtered HTML
│           ├── render_and_paste.sh # 步骤 ③：渲染 + 粘贴 + 保存（支持续写模式）
│           └── verify_env.sh       # 环境检查
├── README.md
└── LICENSE                         # Apache 2.0

致谢

核心思路源自 linux.do 社区的这篇帖子：

AI 快速排版 Word 文章的一个通用思路

作者提出「让 AI 生成带 inline CSS 的 HTML → 浏览器中转 → 粘贴进 Word」的排版方案，以及一套 8 条 prompt 硬约束（inline CSS / pt 单位 / 表格 align="center" 等）。

本 skill 在此基础上做了两点关键调整：

不让 AI 凭空写 HTML——而是用 Word 自己导出的 Filtered HTML 作为样式模板，AI 只改文字内容、保留所有 inline style 标签。这样能避免 AI 生成 HTML 时的字体名误用、单位混用等隐性问题。
支持"续写"模式——把原 .docx 副本作为承载文档，新内容粘到末尾，从而 100% 继承原文档的页面设置 / 样式表 / 主题 / 页眉页脚（这些信息浏览器粘贴管线传不过去）。

License

Apache 2.0 — 详见 LICENSE