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 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.
92
88%
Does it follow best practices?
Impact
93%
1.52xAverage score across 8 eval scenarios
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that covers specific capabilities, includes abundant natural trigger terms, explicitly states both when to use and when not to use the skill, and clearly distinguishes itself from related skills. The only minor note is the use of second person ('Use this skill whenever the user wants...') which borders on instructional voice, but it primarily uses third-person framing for actions. The explicit exclusion list is a strong differentiator.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: create, read, edit, manipulate Word documents, extract/reorganize content, insert/replace images, find-and-replace, work with tracked changes/comments, convert content into polished Word documents, and formatting elements like tables of contents, headings, page numbers, letterheads. | 3 / 3 |
Completeness | Clearly answers both 'what' (create, read, edit, manipulate .docx files with specific sub-tasks listed) and 'when' (explicit trigger terms and use-case scenarios provided, plus negative boundaries stating when NOT to use). The description opens with an explicit 'Use this skill whenever...' clause. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'Word doc', 'word document', '.docx', 'report', 'memo', 'letter', 'template', plus formatting-related terms like 'tables of contents', 'headings', 'page numbers', 'letterheads'. These are highly natural user phrases. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear niche around Word/.docx files. Explicitly excludes PDFs, spreadsheets, Google Docs, and general coding tasks, which directly reduces conflict risk with adjacent skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, highly actionable skill with excellent concrete examples and clear workflows. Its main weakness is length — at ~400 lines with all content inline, it could benefit from splitting detailed reference material (XML patterns, docx-js API examples) into separate files. Some redundancy in table width rules and minor unnecessary context could be trimmed for better token efficiency.
Suggestions
Split the XML Reference section and detailed docx-js API examples into separate referenced files (e.g., XML_REFERENCE.md, DOCX_JS_API.md) to improve progressive disclosure and reduce the main file's token footprint.
Consolidate the table width rules — they appear in code comments, a dedicated 'Width rules' section, and the 'Critical Rules' summary; keep one authoritative location and reference it from others.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient with concrete code examples and useful tables, but it's quite long (~400 lines) with some redundancy. For example, table width rules are explained multiple times (in the code comments, in the 'Width rules' section, and again in 'Critical Rules'). The overview line 'A .docx file is a ZIP archive containing XML files' is unnecessary context for Claude. However, most content earns its place with specific, non-obvious details like DXA units, landscape orientation quirks, and ShadingType.CLEAR gotchas. | 2 / 3 |
Actionability | Excellent actionability throughout. Every section provides executable code examples with specific commands, exact parameter values, and copy-paste ready snippets. The skill includes concrete bash commands for scripts, complete JavaScript examples for docx-js, and precise XML patterns for editing. Anti-patterns are clearly marked with ❌/✅ examples (e.g., unicode bullets). | 3 / 3 |
Workflow Clarity | The editing workflow is clearly sequenced as 3 explicit steps (Unpack → Edit XML → Pack) with validation built into the pack step. The creation workflow includes a validation step after file generation. Auto-repair capabilities and their limitations are clearly documented, providing implicit error recovery guidance. Common pitfalls are called out explicitly. | 3 / 3 |
Progressive Disclosure | The skill has good internal structure with a quick reference table at the top and clear section headers, but all content is inline in a single large file. The XML Reference section and the extensive docx-js API examples could be split into separate reference files. No bundle files are provided to offload detailed content, and no external references are made to supplementary documentation files. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (591 lines); consider splitting into references/ and linking | Warning |
Total | 10 / 11 Passed | |
690f15c
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.