document-polisher

Files (13)

• SKILL.md
• apple.md · brands/
• deloitte.md · brands/
• economist.md · brands/
• figma.md · brands/
• ibm.md · brands/
• kpmg.md · brands/
• linear.md · brands/
• mckinsey.md · brands/
• notion.md · brands/
• stripe.md · brands/
• apply_brand.py · scripts/
• brand-mapping.json · templates/

SKILL.md (first lines)

> **Windows 环境**：技能目录为 C:\Users\Willian\.agents\skills\document-polisher，脚本请用绝对路径或先 cd 进技能目录；产物写到当前工作目录。本机没有 LibreOffice（soffice），依赖它做渲染、缩略图、接受修订、公式重算的步骤会失败，其余 Python 操作正常。
# Document Polisher

Transform any document into a polished, professionally-styled masterpiece using world-class brand aesthetics.

## Overview

This skill applies premium brand styling from 10 carefully curated brands to DOCX documents. Each brand has been analyzed for its typography, color palette, and design principles to create authentic-looking documents.

## Brand Selection Menu

When a user wants to polish a document, ALWAYS present this selection menu:

```
╔══════════════════════════════════════════════════════════════════════════╗
║                        DOCUMENT POLISHER                                 ║
║                    Select Your Brand Style                               ║
╠══════════════════════════════════════════════════════════════════════════╣
║                                                                          ║
║  EDITORIAL                                                               ║
║  ─────────                                                               ║
║  1. The Economist    │ Deep navy + serif typography                      ║
║                      │ Best for: Reports, analysis, thought leadership   ║
║                                                                          ║
║  CONSULTING                                                              ║
║  ──────────                                                              ║
║  2. McKinsey         │ Sharp corners + bold blue accents                 ║
║                      │ Best for: Strategy decks, executive summaries     ║
║                                                                          ║
║  3. Deloitte         │ Teal-blue + pill-shaped elements                  ║
║                      │ Best for: Audits, assessments, formal reports     ║
║                                                                          ║
║  4. KPMG             │ Two-tone blue + condensed headings                ║
║                      │ Best for: Financial reports, compliance docs      ║
║                                                                          ║
║  TECH                                                                    ║
║  ────                                                                    ║
║  5. Stripe           │ Dark blue + purple gradients                      ║
║                      │ Best for: API docs, developer guides, specs       ║
║                                                                          ║
║  6. Apple            │ Minimalist + generous whitespace                  ║
║                      │ Best for: Product docs, user guides               ║
║                                                                          ║
║  7. IBM              │ Plex typography + Carbon design                   ║
║                      │ Best for: Technical docs, enterprise reports      ║
║                                                                          ║
║  8. Linear           │ Modern purple + precise typography                ║
║                      │ Best for: Product specs, changelogs, dev docs     ║
║                                                                          ║
║  PRODUCTIVITY                                                            ║
║  ────────────                                                            ║
║  9. Notion           │ Clean blue + subtle accents                       ║
║                      │ Best for: Wikis, project plans, documentation     ║
║                                                                          ║
║  DESIGN                                                                  ║
║  ──────────                                                              ║
║  10. Figma           │ Vibrant multi-color palette                       ║
║                      │ Best for: Creative briefs, design docs, brands    ║
║                                                                          ║
╚══════════════════════════════════════════════════════════════════════════╝
```

## Workflow

### Step 1: Ask the User

When a user wants to polish a document:
1. Display the brand selection menu above
2. Ask: "Which brand style would you like to apply? You can also tell me the purpose of your document and I'll recommend a style."

### Step 2: Apply the Styling

**IMPORTANT: Always use the Python script with python-docx. Never use direct XML/OOXML manipulation as it can corrupt documents.**

#### Primary Method: Python Script (REQUIRED)

The script uses python-docx to safely recreate documents with brand styling. It:
- Reads the source document
- Creates a new document with brand styles applied
- Copies all content with proper formatting
- Preserves bold, italic, lists, and structure

```bash
# Ensure python-docx is installed in the environment
pip install python-docx

# Apply brand styling
python scripts/apply_brand.py <input.docx> <brand_name> <output.docx>

# Examples:
python scripts/apply_brand.py report.docx economist polished_report.docx
python scripts/apply_brand.py proposal.docx mckinsey styled_proposal.docx
python scripts/apply_brand.py guide.docx stripe tech_guide.docx
```

#### Available Brand Names:
- `economist` - The Economist (editorial, serif)
- `mckinsey` - McKinsey & Company (consulting, sharp)
- `deloitte` - Deloitte (consulting, teal)
- `kpmg` - KPMG (consulting, bold blue)
- `stripe` - Stripe (tech, dark blue/purple)
- `apple` - Apple (tech, minimalist)
- `ibm` - IBM (tech, enterprise)
- `notion` - Notion (productivity, clean)
- `linear` - Linear (tech, modern purple)
- `figma` - Figma (design, colorful)

### What the Script Does

1. **Loads brand configuration** from `templates/brand-mapping.json`
2. **Creates a fresh document** (avoids corruption from XML editing)
3. **Applies document-level styles:**
   - Normal text style (font, size, color)
   - Heading 1, 2, 3 styles (font, size, color, spacing)
   - Title style
   - Page margins
4. **Copies content with formatting:**
   - Preserves headings at correct levels

From Willian8021743/windows-ai-toolkit, MIT.

More from Willian8021743/windows-ai-toolkit