Agent Skills
› NeverSight/learn-skills.dev
› docx
docx
GitHub提供Word文档(.docx)的程序化创建、编辑和自动化能力。支持使用python-docx或docx.js生成文档、填充模板、修改现有文件及批量处理，涵盖样式管理与内容提取。
Trigger Scenarios
需要程序化生成Word文档
使用数据填充Word模板
修改现有的.docx文件
从Word文档中提取内容
自动化文档工作流
Install
npx skills add NeverSight/learn-skills.dev --skill docx -g -y
SKILL.md
Frontmatter
{
"name": "docx",
"description": "Expert in creating, editing, and automating Word documents (.docx) using python-docx and docx.js. Use when generating Word documents, modifying existing docx files, or automating document workflows."
}
DOCX Skill
Purpose
Provides expertise in programmatic Word document creation and manipulation. Handles document generation, template filling, style management, and batch document processing using python-docx and JavaScript libraries.
When to Use
- Generating Word documents programmatically
- Filling document templates with data
- Modifying existing .docx files
- Extracting content from Word documents
- Applying styles and formatting
- Creating mail merge workflows
- Converting data to formatted documents
Quick Start
Invoke this skill when:
- Generating Word documents programmatically
- Filling document templates with data
- Modifying existing .docx files
- Extracting content from Word documents
- Automating document workflows
Do NOT invoke when:
- Writing document content (use document-writer)
- Creating PDFs (use pdf-skill)
- Creating spreadsheets (use xlsx-skill)
- Creating presentations (use pptx-skill)
Decision Framework
Library Selection:
├── Python backend → python-docx
├── Node.js backend → docx (npm)
├── Browser-based → docx.js
├── Complex templates → docxtemplater
└── Simple text extraction → mammoth
Task Type:
├── Generate from scratch → Build document programmatically
├── Fill template → Use placeholder replacement
├── Modify existing → Load, edit, save
└── Batch processing → Loop with template
Core Workflows
1. Document Generation (python-docx)
- Create Document object
- Add heading with level
- Add paragraphs with text
- Apply styles (built-in or custom)
- Add tables if needed
- Insert images
- Save document
2. Template Processing
- Load template document
- Find placeholders ({{variable}})
- Replace with actual values
- Handle conditional sections
- Process repeating sections
- Save as new document
3. Batch Document Generation
- Load template once
- Iterate over data records
- Clone template for each
- Fill placeholders
- Generate unique filenames
- Save each document
Best Practices
- Use paragraph styles, not direct formatting
- Create templates with placeholders for reuse
- Handle missing placeholder values gracefully
- Preserve original template, save to new file
- Test with complex content (tables, images)
- Validate output opens correctly
Anti-Patterns
| Anti-Pattern | Problem | Correct Approach |
|---|---|---|
| Direct formatting | Hard to maintain | Use styles |
| Modifying template | Corrupts original | Save to new file |
| No error handling | Fails on bad input | Validate data first |
| Hardcoded paths | Not portable | Use relative paths |
| Ignoring encoding | Character issues | Use UTF-8 strings |
Version History
- e0220ca Current 2026-07-05 21:13
