@panda-agent/panda-cli 0.1.54

package/bundled-preset-skills/docx/SKILL.md

@@ -0,0 +1,663 @@
+---
+name: docx
+version: 1.0.2
+description: "Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use for Chinese official documents (公文、快文、机关公文) including 决定、通知、通报、纪要、报告、请示、批复、函、意见 — apply §公司公文/快文 formatting (仿宋_GB2312 三号、结构层次序数等). Also use when extracting or reorganizing content from .docx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation."
+description_zh: "当用户需要创建、读取、编辑或操作 Word 文档（.docx 文件）时使用此技能。触发条件包括：任何提及 'Word 文档'、'.docx'、'公文'、'快文'、'机关公文' 的情况，或要求生成带有目录、标题、页码或信头等格式的专业文档；撰写或排版公司公文（决定、通知、通报、纪要、报告、请示、批复、函、意见）时须遵循下文 §公司公文/快文 的字体与结构层次要求。也适用于：从 .docx 文件中提取或重组内容、在文档中插入或替换图片、在 Word 文件中执行查找替换、处理修订标记或批注，或将内容转换为精美的 Word 文档。当用户要求以 Word 或 .docx 文件形式交付'报告'、'备忘录'、'信函'、'模板'或类似文档时使用此技能。不适用于 PDF、电子表格、Google Docs 或与文档生成无关的编程任务。"
+license: Proprietary. LICENSE.txt has complete terms
+---
+
+# Working with DOCX: Creation, Modification, and Inspection
+
+A `.docx` file is a ZIP container holding a tree of XML files conforming to the OOXML standard.
+
+## Task Decision Matrix
+
+| Goal | Approach |
+|------|----------|
+| Inspect / extract text | `pandoc` or unpack to browse raw XML |
+| Build a new document | `docx-js` (see §Generating Documents) |
+| Modify an existing file | Unpack → edit XML → repack (see §Patching Existing Documents) |
+| 公司公文 / 快文 | Follow §公司公文/快文 below (overrides default Arial styles) |
+
+---
+
+## 公司公文 / 快文
+
+当用户要求撰写、排版或修改**公文**、**快文**及同类机关/企业正式文书时，优先遵循本节；本节优先于下文 §Heading Styles 中的 Arial 默认样式。
+
+### 适用范围与原则
+
+1. **适用范围**：适用于公司各部门、中心的公文处理工作。
+2. **处理原则**：公文处理应当坚持**实事求是、准确规范、精简高效、安全保密**。
+
+### 公文种类
+
+公司通用公文种类主要有：**决定、通知、通报、纪要、报告、请示、批复、函、意见**。生成或修改文档时，文种标题、行文语气与结构须与所选文种相符。
+
+### 正文
+
+正文是公文的主体，用来表述公文的内容。
+
+**字体与段落（正文默认）**
+
+| 项目 | 要求 |
+|------|------|
+| 字体 | **仿宋**（`仿宋_GB2312` / `FangSong_GB2312`） |
+| 字号 | **三号**（16 磅；docx-js `size: 32`） |
+| 位置 | 编排于**主送单位名称**下一行起 |
+| 段首 | 每个自然段**左空二字**（首行缩进 2 个三号字宽，约 640 TWIP） |
+| 回行 | **顶格**（换行后不再额外缩进） |
+| 数字与年份 | **不得回行**（同一数字、年份须在同一行内，避免在中间断行） |
+
+**结构层次序数**（原则上**不超过四层**）：
+
+| 层次 | 序数形式 | 字体 |
+|------|----------|------|
+| 第一层 | `一、` `二、` … | **黑体**（`黑体` / `SimHei`） |
+| 第二层 | `（一）` `（二）` … | **楷体**（`楷体` / `楷体_GB2312` / `KaiTi`） |
+| 第三层 | `1.` `2.` … | **仿宋**（与正文同，仿宋_GB2312） |
+| 第四层 | `（1）` `（2）` … | **仿宋**（与正文同，仿宋_GB2312） |
+
+- 序数后的标点须与上表一致（如第一层用顿号 `、`，第二层用全角括号）。
+- 不得使用 Word 默认多级列表符号替代上述序数形式；须按层次分别设置对应字体。
+
+### docx-js 示例（公文正文）
+
+```javascript
+// 三号 = 16pt → size: 32 (half-points). 2-char indent ≈ 640 TWIP.
+const bodyFont = "仿宋_GB2312";
+const bodySize = 32;
+
+const bodyParagraph = (text) => new Paragraph({
+  indent: { firstLine: 640 },
+  children: [new TextRun({ text, font: bodyFont, size: bodySize })],
+});
+
+// 结构层次示例（同一段内可用多个 TextRun 区分字体）
+new Paragraph({
+  indent: { firstLine: 640 },
+  children: [
+    new TextRun({ text: "一、", font: "黑体", size: bodySize }),
+    new TextRun({ text: "总体要求", font: "黑体", size: bodySize }),
+  ],
+});
+new Paragraph({
+  indent: { firstLine: 640 },
+  children: [
+    new TextRun({ text: "（一）", font: "楷体", size: bodySize }),
+    new TextRun({ text: "加强组织领导。", font: bodyFont, size: bodySize }),
+  ],
+});
+```
+
+编辑已有公文时，在 `unpacked/word/document.xml` 中为各 `<w:r>` 设置对应的 `<w:rFonts w:eastAsia="…"/>` 与 `<w:sz w:val="32"/>`，并校验段落的 `<w:ind w:firstLine="640"/>`。
+
+---
+
+## Common Operations
+
+### Converting legacy .doc to .docx
+
+```bash
+python ${PANDA_SKILL_DIR}/scripts/office/soffice.py --headless --convert-to docx document.doc
+```
+
+### Extracting text
+
+```bash
+# Markdown output preserving tracked-change information
+pandoc --track-changes=all document.docx -o output.md
+
+# Direct XML access for fine-grained inspection
+python ${PANDA_SKILL_DIR}/scripts/office/unpack.py document.docx unpacked/
+```
+
+### Rendering pages as images
+
+```bash
+python ${PANDA_SKILL_DIR}/scripts/office/soffice.py --headless --convert-to pdf document.docx
+pdftoppm -jpeg -r 150 document.pdf page
+```
+
+### Accepting all tracked changes
+
+Produces a pristine copy with all revisions resolved (LibreOffice required):
+
+```bash
+python ${PANDA_SKILL_DIR}/scripts/accept_changes.py input.docx output.docx
+```
+
+---
+
+## Generating Documents from Scratch
+
+Produce `.docx` files via JavaScript. Install: `npm install -g docx`
+
+### Bootstrap
+
+```javascript
+const { Document, Packer, Paragraph, TextRun, Table, TableRow, TableCell, ImageRun,
+        Header, Footer, AlignmentType, PageOrientation, LevelFormat, ExternalHyperlink,
+        InternalHyperlink, Bookmark, FootnoteReferenceRun, PositionalTab,
+        PositionalTabAlignment, PositionalTabRelativeTo, PositionalTabLeader,
+        TabStopType, TabStopPosition, Column, SectionType,
+        TableOfContents, HeadingLevel, BorderStyle, WidthType, ShadingType,
+        VerticalAlign, PageNumber, PageBreak } = require('docx');
+
+const doc = new Document({ sections: [{ children: [/* content */] }] });
+Packer.toBuffer(doc).then(buf => fs.writeFileSync("doc.docx", buf));
+```
+
+### Validation
+
+```bash
+python ${PANDA_SKILL_DIR}/scripts/office/validate.py doc.docx
+```
+
+If the validator reports issues, unpack, repair the XML, and repackage.
+
+### Page Dimensions
+
+```javascript
+// docx-js defaults to A4; US Letter must be set explicitly.
+sections: [{
+  properties: {
+    page: {
+      size: { width: 12240, height: 15840 },         // 8.5 × 11 in (DXA)
+      margin: { top: 1440, right: 1440, bottom: 1440, left: 1440 }  // 1-inch
+    }
+  },
+  children: [/* body content */]
+}]
+```
+
+**Paper sizes (DXA; 1440 DXA = 1 inch):**
+
+| Format | Width | Height | Usable width (1 in margins) |
+|--------|-------|--------|-----------------------------|
+| US Letter | 12 240 | 15 840 | 9 360 |
+| A4 (default) | 11 906 | 16 838 | 9 026 |
+
+**Landscape:** Always supply portrait dimensions — docx-js internally transposes them:
+
+```javascript
+size: {
+  width: 12240,   // short edge
+  height: 15840,  // long edge
+  orientation: PageOrientation.LANDSCAPE
+},
+// Effective content width = 15840 − left − right (long edge becomes horizontal)
+```
+
+### Heading Styles
+
+Default to Arial for broad compatibility. Keep heading text black. **Exception:** for 公文 / 快文, use §公司公文/快文 instead of this section.
+
+```javascript
+const doc = new Document({
+  styles: {
+    default: { document: { run: { font: "Arial", size: 24 } } },  // 12 pt base
+    paragraphStyles: [
+      { id: "Heading1", name: "Heading 1", basedOn: "Normal", next: "Normal", quickFormat: true,
+        run: { size: 32, bold: true, font: "Arial" },
+        paragraph: { spacing: { before: 240, after: 240 }, outlineLevel: 0 } },
+      { id: "Heading2", name: "Heading 2", basedOn: "Normal", next: "Normal", quickFormat: true,
+        run: { size: 28, bold: true, font: "Arial" },
+        paragraph: { spacing: { before: 180, after: 180 }, outlineLevel: 1 } },
+    ]
+  },
+  sections: [{
+    children: [
+      new Paragraph({ heading: HeadingLevel.HEADING_1, children: [new TextRun("Title")] }),
+    ]
+  }]
+});
+```
+
+### Lists (NEVER use Unicode bullet characters)
+
+```javascript
+// ❌ WRONG — literal bullet glyphs produce broken output
+new Paragraph({ children: [new TextRun("• Item")] })   // BAD
+new Paragraph({ children: [new TextRun("\u2022 Item")] })  // BAD
+
+// ✅ CORRECT — use LevelFormat.BULLET via numbering configuration
+const doc = new Document({
+  numbering: {
+    config: [
+      { reference: "bullets",
+        levels: [{ level: 0, format: LevelFormat.BULLET, text: "•", alignment: AlignmentType.LEFT,
+          style: { paragraph: { indent: { left: 720, hanging: 360 } } } }] },
+      { reference: "numbers",
+        levels: [{ level: 0, format: LevelFormat.DECIMAL, text: "%1.", alignment: AlignmentType.LEFT,
+          style: { paragraph: { indent: { left: 720, hanging: 360 } } } }] },
+    ]
+  },
+  sections: [{
+    children: [
+      new Paragraph({ numbering: { reference: "bullets", level: 0 },
+        children: [new TextRun("Bullet item")] }),
+      new Paragraph({ numbering: { reference: "numbers", level: 0 },
+        children: [new TextRun("Numbered item")] }),
+    ]
+  }]
+});
+
+// ⚠️ Same reference → continuous (1,2,3…4,5,6); different references → restart (1,2,3…1,2,3)
+```
+
+### Tables
+
+**Both `columnWidths` on Table AND `width` on every TableCell are required.**
+
+```javascript
+const borderDef = { style: BorderStyle.SINGLE, size: 1, color: "CCCCCC" };
+const allBorders = { top: borderDef, bottom: borderDef, left: borderDef, right: borderDef };
+
+new Table({
+  width: { size: 9360, type: WidthType.DXA },  // always DXA, never PERCENTAGE
+  columnWidths: [4680, 4680],                   // must sum to table width
+  rows: [
+    new TableRow({
+      children: [
+        new TableCell({
+          borders: allBorders,
+          width: { size: 4680, type: WidthType.DXA },  // must match columnWidths entry
+          shading: { fill: "D5E8F0", type: ShadingType.CLEAR },  // CLEAR, never SOLID
+          margins: { top: 80, bottom: 80, left: 120, right: 120 },
+          children: [new Paragraph({ children: [new TextRun("Cell")] })]
+        })
+      ]
+    })
+  ]
+})
+```
+
+**Width computation:**
+
+```javascript
+// table width = Σ columnWidths = page width − both margins
+// US Letter + 1 in margins: 12240 − 2880 = 9360 DXA
+width: { size: 9360, type: WidthType.DXA },
+columnWidths: [7000, 2360]  // must sum to 9360
+```
+
+**Table rules:**
+- Always `WidthType.DXA` — `PERCENTAGE` breaks in Google Docs
+- Cell `width` must equal its corresponding `columnWidths` entry
+- Cell `margins` are inward padding (shrink content area, don't add to cell width)
+- Full-width: set width to page width minus both lateral margins
+
+### Images
+
+```javascript
+new Paragraph({
+  children: [new ImageRun({
+    type: "png",  // required; accepted: png, jpg, jpeg, gif, bmp, svg
+    data: fs.readFileSync("image.png"),
+    transformation: { width: 200, height: 150 },
+    altText: { title: "Title", description: "Desc", name: "Name" }  // all three required
+  })]
+})
+```
+
+### Page Breaks
+
+```javascript
+// PageBreak MUST live inside a Paragraph
+new Paragraph({ children: [new PageBreak()] })
+
+// Alternative: pageBreakBefore
+new Paragraph({ pageBreakBefore: true, children: [new TextRun("New page")] })
+```
+
+### Hyperlinks
+
+```javascript
+// External URL
+new Paragraph({
+  children: [new ExternalHyperlink({
+    children: [new TextRun({ text: "Click here", style: "Hyperlink" })],
+    link: "https://example.com",
+  })]
+})
+
+// In-document cross-reference
+// 1. Place bookmark at destination
+new Paragraph({ heading: HeadingLevel.HEADING_1, children: [
+  new Bookmark({ id: "chapter1", children: [new TextRun("Chapter 1")] }),
+]})
+// 2. Link to it
+new Paragraph({ children: [new InternalHyperlink({
+  children: [new TextRun({ text: "See Chapter 1", style: "Hyperlink" })],
+  anchor: "chapter1",
+})]})
+```
+
+### Footnotes
+
+```javascript
+const doc = new Document({
+  footnotes: {
+    1: { children: [new Paragraph("Source: Annual Report 2024")] },
+    2: { children: [new Paragraph("See appendix for methodology")] },
+  },
+  sections: [{
+    children: [new Paragraph({
+      children: [
+        new TextRun("Revenue grew 15%"),
+        new FootnoteReferenceRun(1),
+        new TextRun(" using adjusted metrics"),
+        new FootnoteReferenceRun(2),
+      ],
+    })]
+  }]
+});
+```
+
+### Tab Stops
+
+```javascript
+// Right-aligned text on the same line
+new Paragraph({
+  children: [new TextRun("Company Name"), new TextRun("\tJanuary 2025")],
+  tabStops: [{ type: TabStopType.RIGHT, position: TabStopPosition.MAX }],
+})
+
+// Dot-leader (TOC-style)
+new Paragraph({
+  children: [
+    new TextRun("Introduction"),
+    new TextRun({ children: [
+      new PositionalTab({
+        alignment: PositionalTabAlignment.RIGHT,
+        relativeTo: PositionalTabRelativeTo.MARGIN,
+        leader: PositionalTabLeader.DOT,
+      }),
+      "3",
+    ]}),
+  ],
+})
+```
+
+### Multi-column Layouts
+
+```javascript
+// Evenly spaced columns
+sections: [{
+  properties: {
+    column: { count: 2, space: 720, equalWidth: true, separate: true },
+  },
+  children: [/* text flows across columns automatically */]
+}]
+
+// Custom widths
+sections: [{
+  properties: {
+    column: {
+      equalWidth: false,
+      children: [new Column({ width: 5400, space: 720 }), new Column({ width: 3240 })],
+    },
+  },
+  children: [/* content */]
+}]
+```
+
+Explicit column break: add a new section with `type: SectionType.NEXT_COLUMN`.
+
+### Table of Contents
+
+```javascript
+// Headings MUST use HeadingLevel — custom paragraph styles are invisible to the TOC.
+new TableOfContents("Table of Contents", { hyperlink: true, headingStyleRange: "1-3" })
+```
+
+### Headers and Footers
+
+```javascript
+sections: [{
+  properties: {
+    page: { margin: { top: 1440, right: 1440, bottom: 1440, left: 1440 } }
+  },
+  headers: {
+    default: new Header({ children: [new Paragraph({ children: [new TextRun("Header")] })] })
+  },
+  footers: {
+    default: new Footer({ children: [new Paragraph({
+      children: [new TextRun("Page "), new TextRun({ children: [PageNumber.CURRENT] })]
+    })] })
+  },
+  children: [/* body */]
+}]
+```
+
+### Essential docx-js Rules
+
+- **Page size:** defaults to A4; US Letter = 12 240 × 15 840 DXA
+- **Landscape:** supply portrait dimensions + `PageOrientation.LANDSCAPE`
+- **No `\n`:** create separate Paragraph objects
+- **No Unicode bullets:** use `LevelFormat.BULLET` via numbering API
+- **PageBreak inside Paragraph only**
+- **ImageRun requires `type`**
+- **Table `width` must use DXA** — `PERCENTAGE` breaks in Google Docs
+- **Dual-width rule:** set `columnWidths` on table AND `width` on every cell
+- **Table width = Σ columnWidths**
+- **Cell margins:** `{ top: 80, bottom: 80, left: 120, right: 120 }` for readable padding
+- **Use `ShadingType.CLEAR`** — never SOLID for cell fills
+- **Avoid tables as dividers:** use border on Paragraph instead; for side-by-side footer content use tab stops
+- **TOC only with HeadingLevel**
+- **Override styles by ID:** "Heading1", "Heading2", etc.
+- **Provide `outlineLevel`** for TOC (0 = H1, 1 = H2 …)
+
+---
+
+## Patching Existing Documents
+
+Execute all three stages in order.
+
+### Stage 1 — Unpack
+
+```bash
+python ${PANDA_SKILL_DIR}/scripts/office/unpack.py document.docx unpacked/
+```
+
+Inflates the archive, pretty-prints XML, coalesces adjacent runs, and encodes typographic quotes as XML entities (`&#x201C;` etc.). Pass `--merge-runs false` to skip run coalescing.
+
+### Stage 2 — Edit the XML
+
+Work inside `unpacked/word/`. Refer to §XML Patterns below.
+
+**Use "Claude" as the author** for tracked changes and comments, unless the user specifies otherwise.
+
+**Use the Edit tool for string replacements — do not write Python scripts.** The Edit tool makes every replacement visible and auditable.
+
+**Use typographic (smart) quotes for new text:**
+
+```xml
+<w:t>Here&#x2019;s a quote: &#x201C;Hello&#x201D;</w:t>
+```
+
+| Entity | Character |
+|--------|-----------|
+| `&#x2018;` | ' (left single) |
+| `&#x2019;` | ' (right single / apostrophe) |
+| `&#x201C;` | " (left double) |
+| `&#x201D;` | " (right double) |
+
+**Inserting comments** — `comment.py` handles the multi-file boilerplate (text must be XML-escaped):
+
+```bash
+python ${PANDA_SKILL_DIR}/scripts/comment.py unpacked/ 0 "Comment text with &amp; and &#x2019;"
+python ${PANDA_SKILL_DIR}/scripts/comment.py unpacked/ 1 "Reply text" --parent 0
+python ${PANDA_SKILL_DIR}/scripts/comment.py unpacked/ 0 "Text" --author "Custom Author"
+```
+
+Then wire markers into document.xml (see §Comments below).
+
+### Stage 3 — Repack
+
+```bash
+python ${PANDA_SKILL_DIR}/scripts/office/pack.py unpacked/ output.docx --original document.docx
+```
+
+Validates with automatic repair, condenses XML, produces the final DOCX. Pass `--validate false` to bypass.
+
+**Auto-repair corrects:**
+- `durableId` values ≥ 0x7FFFFFFF (replaced with fresh IDs)
+- Missing `xml:space="preserve"` on `<w:t>` with leading/trailing whitespace
+
+**Does NOT fix:** malformed XML, illegal nesting, broken relationships, schema violations.
+
+### Gotchas
+
+- **Swap whole `<w:r>` blocks:** when introducing tracked changes, replace the entire run — never splice change-tracking tags inside an existing run.
+- **Carry forward `<w:rPr>`:** copy original formatting properties into new tracked-change runs.
+
+---
+
+## XML Patterns
+
+### Schema Ordering
+
+- **`<w:pPr>` child order:** `<w:pStyle>` → `<w:numPr>` → `<w:spacing>` → `<w:ind>` → `<w:jc>` → `<w:rPr>` last
+- **Whitespace:** attach `xml:space="preserve"` to any `<w:t>` with leading/trailing spaces
+- **RSIDs:** 8-character hexadecimal (e.g. `00AB1234`)
+
+### Tracked Changes
+
+**Insertion:**
+
+```xml
+<w:ins w:id="1" w:author="Claude" w:date="2025-01-01T00:00:00Z">
+  <w:r><w:t>inserted text</w:t></w:r>
+</w:ins>
+```
+
+**Deletion:**
+
+```xml
+<w:del w:id="2" w:author="Claude" w:date="2025-01-01T00:00:00Z">
+  <w:r><w:delText>deleted text</w:delText></w:r>
+</w:del>
+```
+
+Inside `<w:del>`: use `<w:delText>` instead of `<w:t>`, `<w:delInstrText>` instead of `<w:instrText>`.
+
+**Minimal-footprint edit (change "30 days" to "60 days"):**
+
+```xml
+<w:r><w:t>The term is </w:t></w:r>
+<w:del w:id="1" w:author="Claude" w:date="...">
+  <w:r><w:delText>30</w:delText></w:r>
+</w:del>
+<w:ins w:id="2" w:author="Claude" w:date="...">
+  <w:r><w:t>60</w:t></w:r>
+</w:ins>
+<w:r><w:t> days.</w:t></w:r>
+```
+
+**Deleting a complete paragraph** — flag the paragraph mark so the empty shell merges with the next paragraph:
+
+```xml
+<w:p>
+  <w:pPr>
+    <w:numPr>...</w:numPr>
+    <w:rPr>
+      <w:del w:id="1" w:author="Claude" w:date="2025-01-01T00:00:00Z"/>
+    </w:rPr>
+  </w:pPr>
+  <w:del w:id="2" w:author="Claude" w:date="2025-01-01T00:00:00Z">
+    <w:r><w:delText>Entire paragraph content being deleted...</w:delText></w:r>
+  </w:del>
+</w:p>
+```
+
+Without the `<w:del/>` in `<w:pPr><w:rPr>`, accepting leaves a blank paragraph.
+
+**Rejecting another author's insertion:**
+
+```xml
+<w:ins w:author="Jane" w:id="5">
+  <w:del w:author="Claude" w:id="10">
+    <w:r><w:delText>their inserted text</w:delText></w:r>
+  </w:del>
+</w:ins>
+```
+
+**Restoring another author's deletion:**
+
+```xml
+<w:del w:author="Jane" w:id="5">
+  <w:r><w:delText>deleted text</w:delText></w:r>
+</w:del>
+<w:ins w:author="Claude" w:id="10">
+  <w:r><w:t>deleted text</w:t></w:r>
+</w:ins>
+```
+
+### Comments
+
+After calling `comment.py`, add range markers in document.xml. For replies, use `--parent` and nest child markers inside the parent's range.
+
+**Rule: `<w:commentRangeStart>` and `<w:commentRangeEnd>` are siblings of `<w:r>` — never inside a run.**
+
+```xml
+<!-- Standalone comment -->
+<w:commentRangeStart w:id="0"/>
+<w:del w:id="1" w:author="Claude" w:date="2025-01-01T00:00:00Z">
+  <w:r><w:delText>deleted</w:delText></w:r>
+</w:del>
+<w:r><w:t> more text</w:t></w:r>
+<w:commentRangeEnd w:id="0"/>
+<w:r><w:rPr><w:rStyle w:val="CommentReference"/></w:rPr><w:commentReference w:id="0"/></w:r>
+
+<!-- Comment 0 with nested reply 1 -->
+<w:commentRangeStart w:id="0"/>
+  <w:commentRangeStart w:id="1"/>
+  <w:r><w:t>text</w:t></w:r>
+  <w:commentRangeEnd w:id="1"/>
+<w:commentRangeEnd w:id="0"/>
+<w:r><w:rPr><w:rStyle w:val="CommentReference"/></w:rPr><w:commentReference w:id="0"/></w:r>
+<w:r><w:rPr><w:rStyle w:val="CommentReference"/></w:rPr><w:commentReference w:id="1"/></w:r>
+```
+
+### Images
+
+1. Drop file into `word/media/`
+2. Register relationship in `word/_rels/document.xml.rels`:
+
+```xml
+<Relationship Id="rId5" Type=".../image" Target="media/image1.png"/>
+```
+
+3. Declare content type in `[Content_Types].xml`:
+
+```xml
+<Default Extension="png" ContentType="image/png"/>
+```
+
+4. Reference from document.xml:
+
+```xml
+<w:drawing>
+  <wp:inline>
+    <wp:extent cx="914400" cy="914400"/>  <!-- EMUs: 914 400 = 1 inch -->
+    <a:graphic>
+      <a:graphicData uri=".../picture">
+        <pic:pic>
+          <pic:blipFill><a:blip r:embed="rId5"/></pic:blipFill>
+        </pic:pic>
+      </a:graphicData>
+    </a:graphic>
+  </wp:inline>
+</w:drawing>
+```
+
+---
+
+## External Dependencies
+
+- **pandoc** — text extraction and format conversion
+- **docx** — `npm install -g docx` (new-document generation)
+- **LibreOffice** — PDF conversion (auto-configured via `${PANDA_SKILL_DIR}/scripts/office/soffice.py`)
+- **Poppler** — `pdftoppm` for rasterising PDF pages

package/bundled-preset-skills/docx/scripts/__init__.py

@@ -0,0 +1 @@
+# Package marker — no public API exposed at this level.