|
1 | 1 | --- |
2 | 2 | name: documents |
3 | | -description: Create, edit, inspect, or convert Word documents and DOCX deliverables such as memos, reports, letters, templates, and forms. |
| 3 | +description: Compatibility alias for the docx skill. Prefer loading docx. |
| 4 | +aliases-for: docx |
4 | 5 | --- |
5 | 6 |
|
6 | | -# Documents |
| 7 | +# documents (alias) |
7 | 8 |
|
8 | | -Use this skill when the user wants a `.docx` or Word-style document, or when an |
9 | | -existing document needs edits, comments, extraction, or conversion. |
| 9 | +This skill is a compatibility alias for **docx**. |
10 | 10 |
|
11 | | -## Workflow |
12 | | - |
13 | | -1. Clarify the output path if needed. Prefer a `.docx` file in the workspace. |
14 | | -2. Preserve existing documents. Write edited copies instead of overwriting |
15 | | - originals unless the user asked for an in-place edit. |
16 | | -3. Use the best available local tool: |
17 | | - - `python-docx` for creation and structured edits |
18 | | - - `pandoc` for Markdown/HTML to DOCX conversion |
19 | | - - OOXML inspection with `unzip` only for targeted low-level fixes |
20 | | -4. For new documents, choose a simple professional structure: title, metadata |
21 | | - when useful, clear headings, readable body text, and tables only for real |
22 | | - row/column data. |
23 | | -5. For edits, make the smallest change that satisfies the request and keep the |
24 | | - original formatting where practical. |
25 | | -6. Verify by reopening the file with a parser such as `python-docx`, checking |
26 | | - paragraph/table counts, and extracting representative text. If LibreOffice |
27 | | - or another renderer is available, render or export a quick visual check. |
28 | | - |
29 | | -If required dependencies are missing, ask before installing packages. If the |
30 | | -user only needs content and a DOCX cannot be produced in the environment, offer |
31 | | -Markdown or HTML as a fallback and clearly state the limitation. |
| 11 | +Load and follow the `docx` skill body for the actual workflow. |
0 commit comments