CtrlK
BlogDocsLog inGet started
Tessl Logo

docx

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.

90

Quality

88%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

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 is borderline but reads more as instructional guidance to Claude rather than addressing the user directly, so it doesn't significantly detract.

DimensionReasoningScore

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-cases 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 highly actionable and well-structured skill for DOCX manipulation, with excellent executable examples covering both creation (docx-js) and editing (XML manipulation) workflows. The workflow clarity is strong with explicit validation steps and error recovery guidance. The main weaknesses are its length (could be more concise in places) and the monolithic structure that packs extensive reference material into a single file rather than using progressive disclosure with supporting files.

Suggestions

Remove the opening sentence 'A .docx file is a ZIP archive containing XML files' — Claude already knows this.

Consider splitting the XML Reference section and the detailed docx-js API examples (tables, images, hyperlinks, etc.) into separate referenced files to reduce the main skill's token footprint and improve progressive disclosure.

Consolidate the 'Critical Rules for docx-js' section by removing items already demonstrated in code examples above (e.g., dual widths for tables is explained twice).

DimensionReasoningScore

Conciseness

The skill is generally efficient and avoids explaining basic concepts Claude would know, but it's quite long (~400+ lines) with some sections that could be more compact. The opening 'A .docx file is a ZIP archive containing XML files' is unnecessary. Some code examples include redundant inline comments, and the critical rules section repeats information already shown in examples above.

2 / 3

Actionability

Excellent actionability throughout — every section provides executable code, specific commands, and copy-paste ready examples. The JavaScript examples for docx-js are complete with proper imports, the bash commands are specific, and the XML reference includes concrete patterns for tracked changes, comments, and images. Anti-patterns are clearly shown with ❌/✅ markers.

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 limits are clearly documented, providing good 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 benefit from being split into separate referenced files. No bundle files are provided, so there's no external structure to leverage, but the monolithic nature of the content (especially the detailed XML patterns) suggests it would benefit from separation.

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (594 lines); consider splitting into references/ and linking

Warning

Total

10

/

11

Passed

Repository
douglasvought/wiggle-skills
Reviewed

Table of Contents

Is this your skill?

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.