⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

document-format-skills

@kagurananaga⭐ 233 stars

Chinese Word document formatting toolkit for .docx/.doc/.wps workflows. Use when Codex needs to diagnose document formatting, fix mixed Chinese/English punctuation and spacing, apply official/academic/legal/custom presets, normalize tables and page numbers, preserve or output Word revision marks, convert plain text or Markdown into formatted DOCX, or batch/script document cleanup for Chinese official documents.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

Adopt or update this skill from https://proskills.md/skills/other/kagurananaga-document-format-skills. First identify the installation path supported by this platform, detect whether it is already installed, compare the installed version with the latest stable release, show me what will change, and only then install or update it. If no native installer is available, use the complete package or source fallback described on the page.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars

⭐⭐⭐ 233 on GitHubGitHub ↗

Popular

🟢ProSkills Score

—

📍

Not yet listed on ClawHub or SkillsMP

// README

📄 document-format-skills 公文格式助手

中文版本 README / Chinese Version

看不懂英文也没关系，请点击上面的链接查看中文版说明。

💡 想要无需联网、一键运行修复格式的桌面应用版本？

现已推出 Document Format GUI 公文格式助手 —— 无需联网、一键修复公文格式的桌面应用，小白也能轻松上手！

🌐 不想安装，也不需要 Agent？

直接打开 公文格式处理工具网页版，选择 .docx 文档即可开始处理。无需登录，文档只在当前浏览器中处理，不会上传到服务器。

A Word document formatting toolkit for Chinese official documents for the government, CCP (China Communist Party), and the state-owned enterprises. Diagnose formatting issues, fix punctuation, and apply standardized styles with one command. Available for Claude Code, Codex, and OpenCode.

公文格式助手是一个面向中文公文排版的 Skill 工具包，用于诊断 Word 文档格式问题、修复中英文标点和空格混用、统一公文/论文/法律文书格式、处理页码和表格，并支持从纯文本或 Markdown 生成规范 DOCX。

Features

中文用户如果不熟悉命令行，可以优先使用 Document Format GUI 公文格式助手：无需联网、一键修复公文格式。
Smart one-shot processing: punctuation/spacing cleanup plus formatting.
Format diagnosis for punctuation, numbering, paragraph, and font issues.
Official, academic, legal, and custom presets.
GB/T 9704-2012 style page margins, fonts, line spacing, headings, signatures, dates, and page numbers.
Safer page-number handling with styles, positions, offsets, replacement control, and non-page footer protection.
Table normalization with optional smart alignment.
Custom settings compatible with the desktop app schema v2 and exported preset JSON.
Word revision marks for supported formatting changes.
macOS font fallback for common Chinese official-document fonts.
.doc / .wps conversion on Windows when WPS Office or Microsoft Word is installed.
Plain text or Markdown to formatted DOCX.

Requirements

Python 3.8+
python-docx
pywin32 only for .doc/.wps conversion on Windows

Use uv for ad-hoc runs:

uv run --with python-docx python scripts/process.py --help

For Windows .doc/.wps conversion:

uv run --with python-docx --with pywin32 python scripts/process.py --help

Quick Start

Smart cleanup:

uv run --with python-docx python scripts/process.py smart input.docx output.docx --preset official

Analyze only:

uv run --with python-docx python scripts/process.py analyze input.docx
uv run --with python-docx python scripts/process.py analyze input.docx --json

Punctuation and spacing only:

uv run --with python-docx python scripts/process.py punctuation input.docx output.docx --space-mode keep_en_boundary

Formatting only:

uv run --with python-docx python scripts/process.py format input.docx output.docx --preset official

Create a formatted DOCX from Markdown or text:

uv run --with python-docx python scripts/from_text.py input.md output.docx --title "Work Plan"

Useful Options

--preset official|academic|legal|custom
--custom-settings path.json
--revision
--deep-clean
--smart-table-align
--no-page-number
--page-number-style dash|plain|page_text|page_total
--page-number-position outside|left|center|right
--space-mode remove_all|keep_en_boundary|keep_all

--custom-settings accepts desktop schema v2 config files, exported preset files like {"preset": {...}}, or plain preset/override JSON.

Scripts

Script	Purpose
`scripts/process.py`	Main CLI pipeline: `smart`, `analyze`, `punctuation`, `format`.
`scripts/formatter.py`	Formatting engine and preset handling.
`scripts/punctuation.py`	Punctuation and spacing fixer.
`scripts/from_text.py`	Text/Markdown to DOCX generator.
`scripts/analyzer.py`	Diagnostic helpers.
`scripts/converter.py`	Windows `.doc/.wps` conversion helpers.

Notes

.docx is the most reliable format.
.doc/.wps requires Windows plus WPS Office or Microsoft Word.
Keep a backup of important documents before running automated formatting.

License

MIT

// HOW IT'S BUILT

KEY FILES

SKILL.mdREADME.md

// REPO STATS

233 stars

// SHARE

Share on X Share on LinkedIn