Agent skill

Word Format

by yeap531 in yeap531/word-format-skill

把一份参考 Word (.docx) 的排版样式(字体/字号/缩进/行距/对齐/页面设置/样式表/主题)复刻到新内容上。当用户要求「按某个 .docx 模板排版」「在已有文档基础上续写」「修复后半部分排版混乱」「统一字体字号缩进」等场景时使用。仅在 macOS 工作(依赖 Microsoft Word + 浏览器 + System Events 的 UI 自动化)。

Custom licenceAuto-check passedDocuments & Office

Install Word Format

skills CLI
$ npx skills add yeap531/word-format-skill --skill word-format -a claude-code

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

GitHub CLI
$ gh skill install yeap531/word-format-skill word-format --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/yeap531/word-format-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/word-format .claude/skills/word-format && rm -rf skills-src

Use ~/.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/

Facts

Skill name
word-format
GitHub stars
204
Token cost
~1.5k tokens
SKILL.md length
463 words
Files
4 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
Custom licence

At a glance

把一份参考 Word (.docx) 的排版样式(字体/字号/缩进/行距/对齐/页面设置/样式表/主题)复刻到新内容上。当用户要求「按某个 .docx 模板排版」「在已有文档基础上续写」「修复后半部分排版混乱」「统一字体字号缩进」等场景时使用。仅在 macOS 工作(依赖 Microsoft Word + 浏览器 + System Events 的 UI 自动化)。

  • Works in 8 steps: 把 reference.docx 复制为 ~/Desktop/最终输出.docx → 浏览器加载 append.html,等 2.5s 字体加载完 → 在浏览器里 Cmd+A / Cmd+C → …
  • Tasks that involve Word documents
  • SKILL.md covers 工作原理:HTML Bridge, 为什么不直接让 Word 打开生成的 HTML 再另存为…, 环境要求 and ⚠️ 给 Claude 的硬约束 prompt(编辑…, plus 3 more sections
  • Runs Shell and Python scripts from its folder; calls bash and python3

What it does

Word Format is an agent skill from yeap531/word-format-skill. 把一份参考 Word (.docx) 的排版样式(字体/字号/缩进/行距/对齐/页面设置/样式表/主题)复刻到新内容上。当用户要求「按某个 .docx 模板排版」「在已有文档基础上续写」「修复后半部分排版混乱」「统一字体字号缩进」等场景时使用。仅在 macOS 工作(依赖 Microsoft Word + 浏览器 + System Events 的 UI 自动化)。

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `scripts/docx_to_html.py`, `scripts/render_and_paste.sh` and `scripts/verify_env.sh`).

It sits in Documents & Office, covering Word documents. It works with Microsoft Word and macOS. The repository describes itself as: 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 /…

When your agent uses it

  • Tasks that involve Word documents

Example prompts

  • “/word-format”

Requirements

  • Python 3
  • A Bash shell

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. 把 reference.docx 复制为 ~/Desktop/最终输出.docx
  2. 浏览器加载 append.html,等 2.5s 字体加载完
  3. 在浏览器里 Cmd+A / Cmd+C
  4. Word 打开 ~/Desktop/最终输出.docx(即副本,原模板设置全在)
  5. 等 Word 成为前台进程
  6. Cmd+A → 右方向键(光标塌缩到文档末尾)→ Cmd+V(粘到末尾)
  7. save active document(不是 save as,副本已命名)
  8. 把焦点还给运行前的前台应用

What it can do on your machine

Read from SKILL.md and the folder at commit b4515a2. 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 3 files in scripts/ (Shell and Python), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • python3

    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

Word Format loads about 1.5k tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 463 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 463 words (~1,476 tokens).

“把参考 Word 文档的排版视觉一致地复刻到新内容上。 工作方式:直接在原件 HTML 上增删改文字,再让浏览器渲染并把富文本送进 Word。”

— opening of SKILL.md by yeap531, Custom licence
name
word-format

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (scripts) in skills/word-format of yeap531/word-format-skill.

  • SKILL.md
  • scripts/docx_to_html.py
  • scripts/render_and_paste.sh
  • scripts/verify_env.sh

Open the folder on GitHubat commit b4515a2

Compare with similar skills

Word Format 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.

Word Format compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Word Format this skillyeap531/word-format-skill204—~1.5kAutomated safety check: PassCustom licence
DOCXguyi-a/pi-ling106—~1.1kAutomated safety check: PassMIT
Compdf Conversion CLILeoYeAI/openclaw-master-skills2.2k—~5.9kAutomated safety check: PassProprietary
Tdoc DOCXLeoYeAI/openclaw-master-skills2.2k—~3.6kAutomated safety check: NotesMIT
Murmurxiaopengde/murmur109—~2.9kAutomated safety check: NotesMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT

Similar skills

  • DOCX

    guyi-a/pi-ling

    Word 文档(.docx)的日常处理:md → docx(生成简历/报告)、docx → PDF/图片(分享预览)、.doc → .docx(老格式升级)。触发场景:用户说"生成 Word 版" / "做份 Word 简历" / "把这份报告转 Word" / "这份 .doc 打不开" / "docx 转 PDF" 等。读 docx 内容走 agent 已有的…

    106 GitHub stars~1.1k tokensUpdated 21 days ago
    Documents & OfficeAuto-check passed
  • Compdf Conversion CLI

    LeoYeAI/openclaw-master-skills

    MUST use for ANY PDF or image format conversion task — converting PDF and images (JPG/JPEG/PNG/BMP/TIFF/TIF/WEBP/JPEG2000) to 10 formats (Word, Excel, PPT, HTML, Image, TXT, JSON, Markdown, RTF…

    2.2k GitHub stars~5.9k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Tdoc DOCX

    LeoYeAI/openclaw-master-skills

    Word 文档全能处理技能 | Complete Word Document Processing Skill. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~3.6k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check: notes
  • Murmur

    xiaopengde/murmur

    把一段中文(或任意 Whisper 支持语言)的会议/面试录音用本地 Whisper large-v3 转成文本,再清洗成带说话人标签、修过 ASR 错字、分好章节的 markdown 文档(可选再转成 docx)。跨平台(macOS Apple Silicon 用 mlx-whisper,Windows/Linux/Intel Mac 用…

    109 GitHub stars~2.9k tokensUpdated 4 mo ago
    AI & LLM EngineeringAuto-check: notes
  • 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
  • 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

Questions about Word Format

What does Word Format do?

把一份参考 Word (.docx) 的排版样式(字体/字号/缩进/行距/对齐/页面设置/样式表/主题)复刻到新内容上。当用户要求「按某个 .docx 模板排版」「在已有文档基础上续写」「修复后半部分排版混乱」「统一字体字号缩进」等场景时使用。仅在 macOS 工作(依赖 Microsoft Word + 浏览器 + System Events 的 UI 自动化)。. Word Format is an agent skill from yeap531/word-format-skill.

When should I use Word Format?

Word Format fits situations like: tasks that involve Word documents.

How do I install Word Format in Claude Code?

Run `npx skills add yeap531/word-format-skill --skill word-format -a claude-code`. Or copy the skill folder (skills/word-format in yeap531/word-format-skill) into .claude/skills/word-format in your project. Claude Code loads it when a task matches its description.

How do I install Word Format in Codex?

Run `npx skills add yeap531/word-format-skill --skill word-format -a codex`. Or copy the skill folder (skills/word-format in yeap531/word-format-skill) into .agents/skills/word-format in your project. Codex loads it when a task matches its description.

Can I use Word Format 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 yeap531/word-format-skill --skill word-format -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/word-format, .gemini/skills/word-format, .github/skills/word-format and .opencode/skills/word-format in your project.

What does Word Format need to run?

Going by SKILL.md and its folder, Word Format needs a shell and Python for the scripts in its folder and the command-line tools its instructions call (bash and python3). Our summary lists: Python 3; A Bash shell.

Does Word Format 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 Word Format 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 Word Format use?

Word Format has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Word Format use?

About 1.5k tokens (SKILL.md is roughly 5.9k 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 Word Format?

Skills that share tags, products or a category with Word Format: DOCX (guyi-a/pi-ling, 106 stars), Compdf Conversion CLI (LeoYeAI/openclaw-master-skills, 2.2k stars), Tdoc DOCX (LeoYeAI/openclaw-master-skills, 2.2k stars) and Murmur (xiaopengde/murmur, 109 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Word Format?

yeap531 (a GitHub user) maintains it in yeap531/word-format-skill, which has 204 GitHub stars. The repository was last updated on April 27, 2026.

Source: yeap531/word-format-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.