document-format-skills

Name: document-format-skills
Author: KaguraNanaga

Verified

Professional Word document formatting toolkit for Chinese documents

165stars

15forks

Python

Installation

# Add to your Claude Code skills
git clone https://github.com/KaguraNanaga/document-format-skills

Getting Started

Guides for using documentation skills like document-format-skills.

How to Create a SKILL.md File
Author your own SKILL.md from scratch and submit it to the catalog.
Getting Started with AI Skills
First-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.

SKILL.md

Security ReportVerified

Last scanned: 5/30/2026

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

README.md

Frequently Asked Questions

What is document-format-skills?

document-format-skills is an open-source documentation skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by KaguraNanaga. Professional Word document formatting toolkit for Chinese documents. It has 165 GitHub stars.

Is document-format-skills safe to use?

Yes. document-format-skills 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 document-format-skills?

Clone the repository with "git clone https://github.com/KaguraNanaga/document-format-skills" and add it to your Claude Code skills directory (see the Installation section above). document-format-skills ships a SKILL.md manifest, so compatible agents can discover and load it automatically.

What programming language is document-format-skills written in?

document-format-skills is primarily written in Python. It is open-source under KaguraNanaga on GitHub, so you can review or fork the full source.

Are there alternatives to document-format-skills?

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

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

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

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

name: document-format-skills description: 文档格式处理工具。支持格式诊断、标点符号修复、格式统一。输入杂乱的文档，输出规范整洁的docx。

文档格式处理工具

处理文档格式问题：诊断格式错误、修复标点符号、统一文档样式。

功能概览

功能	说明	脚本
格式诊断	分析文档存在的格式问题	`analyzer.py`
标点修复	修复中英文标点混用	`punctuation.py`
格式统一	应用预设格式规范	`formatter.py`
表格自动调整	自动调整表格布局与对齐	`formatter.py`
页码规范	统一页码格式与位置	`formatter.py`

使用方法

格式诊断

分析文档存在的问题，输出诊断报告：

uv run --with python-docx python3 scripts/analyzer.py input.docx

输出示例：

=== 格式诊断报告 ===

【标点问题】共 5 处
  - 第2段: 英文括号 () 建议改为 （）
  - 第3段: 英文引号 "" 建议改为 ""

【序号问题】共 2 处
  - 序号格式不统一: 同时存在 "1、" 和 "1." 
  - 第5段: 层级跳跃，从 "一、" 直接到 "1."

【段落问题】共 3 处
  - 第2、4、7段: 缺少首行缩进
  - 行距不统一: 存在单倍、1.5倍混用

【字体问题】共 2 处
  - 正文字号不统一: 12pt、14pt 混用
  - 检测到 4 种字体混用

标点符号修复

# 智能模式（根据上下文判断）
uv run --with python-docx python3 scripts/punctuation.py input.docx output.docx

# 强制全部转中文标点
uv run --with python-docx python3 scripts/punctuation.py input.docx output.docx --mode chinese

# 强制全部转英文标点
uv run --with python-docx python3 scripts/punctuation.py input.docx output.docx --mode english

# 只修复特定类型
uv run --with python-docx python3 scripts/punctuation.py input.docx output.docx --fix brackets,quotes

格式统一

# 应用公文格式
uv run --with python-docx python3 scripts/formatter.py input.docx output.docx --preset official

# 应用学术论文格式
uv run --with python-docx python3 scripts/formatter.py input.docx output.docx --preset academic

# 应用法律文书格式
uv run --with python-docx python3 scripts/formatter.py input.docx output.docx --preset legal

组合使用

# 先诊断
uv run --with python-docx python3 scripts/analyzer.py messy.docx

# 修复标点 + 应用格式
uv run --with python-docx python3 scripts/punctuation.py messy.docx temp.docx
uv run --with python-docx python3 scripts/formatter.py temp.docx clean.docx --preset official

标点符号处理规则

修复范围

类型	错误	正确（中文）	正确（英文）
括号	中英混用	（）	()
引号	直引号 ""	""''	"" ''
冒号	中英混用	：	:
逗号	中英混用	，	,
句号	中英混用	。	.
分号	中英混用	；	;
问号	中英混用	？	?
叹号	中英混用	！	!
省略号	...	……	...
破折号	-- 或 —	——	--

智能判断逻辑

中文环境：前后都是中文字符 → 用中文标点
英文环境：前后都是英文/数字 → 用英文标点
混合环境：默认用中文标点（可配置）

特殊处理

数字与单位之间：100% 保持英文
英文缩写：e.g. i.e. 保持英文句点
网址邮箱：保持原样不处理
代码块：跳过不处理

格式预设

公文格式（GB/T 9704-2012）

页面：A4，上边距37mm，下边距35mm，左边距28mm，右边距26mm
标题：方正小标宋简体，二号（22pt），居中
一级标题：黑体，三号（16pt），顶格，"一、"
二级标题：楷体_GB2312，三号（16pt），顶格，"（一）"
三级标题：仿宋_GB2312，三号（16pt），首行缩进，"1."
正文：仿宋_GB2312，三号（16pt），首行缩进2字符，行距固定值28pt

学术论文格式

页面：A4，边距25mm
标题：黑体，小二（18pt），居中
一级标题：黑体，小三（15pt），"1"
二级标题：黑体，四号（14pt），"1.1"
正文：宋体/Times New Roman，小四（12pt），首行缩进2字符，行距1.5倍

法律文书格式

页面：A4，上边距30mm，下边距25mm，左边距30mm，右边距25mm
标题：宋体加粗，二号（22pt），居中
条款标题：黑体，四号（14pt），"第一条"
正文：宋体，四号（14pt），首行缩进2字符，行距1.5倍

文件结构

document-format-skills/
├── SKILL.md
├── README.md
├── scripts/
│   ├── analyzer.py      # 格式诊断
│   ├── punctuation.py   # 标点修复
│   └── formatter.py     # 格式统一
└── presets/
    ├── official.yaml    # 公文格式
    ├── academic.yaml    # 学术论文
    └── legal.yaml       # 法律文书

依赖

python-docx

使用 uv run --with python-docx 自动安装。

注意事项

只支持 .docx：不支持旧版 .doc 格式
备份原文件：修改前建议备份
字体依赖：输出文件需要系统安装对应字体才能正确显示
表格内容：会自动处理表格内的文字

📄 document-format-skills

中文版本 README / Chinese Version

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

A Word document formatting toolkit for Chinese documents (docx). Diagnose formatting issues, fix punctuation, and apply standardized styles with one command. Available for Claude Code, Codex, OpenCode.

✨ Features

Module	Description	Script
Format Analyzer	Detect formatting issues in documents	`analyzer.py`
Punctuation Fixer	Fix mixed Chinese/English punctuation	`punctuation.py`
Style Formatter	Apply preset formatting standards	`formatter.py`

🚀 Quick Start

Prerequisites

Python 3.8+
uv (recommended) or pip

Installation

git clone https://github.com/yourusername/document-format-skills.git
cd document-format-skills

Usage

1. Diagnose formatting issues

uv run --with python-docx python scripts/analyzer.py input.docx

2. Fix punctuation

uv run --with python-docx python scripts/punctuation.py input.docx output.docx

3. Apply formatting preset

# Official document format (GB/T 9704-2012)
uv run --with python-docx python scripts/formatter.py input.docx output.docx --preset official

# Academic paper format
uv run --with python-docx python scripts/formatter.py input.docx output.docx --preset academic

# Legal document format
uv run --with python-docx python scripts/formatter.py input.docx output.docx --preset legal

📋 What It Fixes

Punctuation Issues

The toolkit intelligently converts punctuation based on context:

Type	Incorrect	Chinese	English
Parentheses	Mixed usage	（）	()
Quotes	Straight `"`	"" ''	"" ''
Colon	Mixed usage	：	:
Comma	Mixed usage	，	,
Period	Mixed usage	。	.
Semicolon	Mixed usage	；	;
Ellipsis	`...`	……	...
Dash	`--`	——	--

Format Issues

Paragraph indentation — Detects missing first-line indents
Line spacing — Identifies inconsistent spacing
Font usage — Flags mixed fonts and sizes
Numbering — Catches inconsistent numbering styles (e.g., mixing 1. with 1、)

📐 Formatting Presets

Official Document (GB/T 9704-2012)

Chinese government document standard:

Page: A4, margins: top 37mm, bottom 35mm, left 28mm, right 26mm
Title: FangZheng XiaoBiaoSong, 22pt, centered
Body: FangSong_GB2312, 16pt, 2-character indent, 28pt line spacing
Headings: Structured with 一、/ （一）/ 1. / （1）

Academic Paper

Standard academic formatting:

Page: A4, 25mm margins
Title: SimHei, 18pt, bold, centered
Body: SimSun/Times New Roman, 12pt, 1.5x line spacing

Legal Document

Legal document formatting:

Page: A4, margins: top 30mm, bottom 25mm, left 30mm, right 25mm
Title: SimSun bold, 22pt, centered
Body: SimSun, 14pt, 1.5x line spacing

📁 Project Structure

document-format-skills/
├── README.md           # English documentation
├── README_CN.md        # Chinese documentation
├── SKILL.md            # Skill definition file
└── scripts/
    ├── analyzer.py     # Format diagnostics
    ├── punctuation.py  # Punctuation fixer
    └── formatter.py    # Style formatter

🔧 Dependencies

python-docx

Automatically installed when using uv run --with python-docx.

⚠️ Notes

Only supports .docx — Legacy .doc format is not supported
Backup your files — Always keep a backup before processing
Font requirements — Output files require corresponding fonts installed on the system to display correctly
Table content — Text within tables is also processed

📄 License

MIT License

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

document-format-skills

Frequently Asked Questions

What is document-format-skills?

Is document-format-skills safe to use?

How do I install document-format-skills?

What programming language is document-format-skills written in?

Are there alternatives to document-format-skills?

Related Skills

Popular in Documentation

name: document-format-skills description: 文档格式处理工具。支持格式诊断、标点符号修复、格式统一。输入杂乱的文档，输出规范整洁的docx。

文档格式处理工具

功能概览

使用方法

格式诊断

标点符号修复

格式统一

组合使用

标点符号处理规则

修复范围

智能判断逻辑

特殊处理

格式预设

公文格式（GB/T 9704-2012）

学术论文格式

法律文书格式

文件结构

依赖

注意事项

📄 document-format-skills

✨ Features

🚀 Quick Start

Prerequisites

Installation

Usage

📋 What It Fixes

Punctuation Issues

Format Issues

📐 Formatting Presets

Official Document (GB/T 9704-2012)

Academic Paper

Legal Document

📁 Project Structure

🔧 Dependencies

⚠️ Notes

📄 License

🤝 Contributing