CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

72

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-structured skill body: executable commands and snippets dominate, workflows are sequenced with validation and error-recovery loops, and all referenced bundle scripts are real. The main improvement areas are de-duplicating the table-width rules and splitting the XML Reference / docx-js catalog into one-level-deep reference files to trim SKILL.md.

Suggestions

Consolidate the table-width guidance (currently stated in the Tables code example, the 'Width rules' bullets, and the 'Critical Rules for docx-js' list) into a single location to remove repetition.

Write out the full relationship and picture URIs in the Images XML snippet instead of '.../image' and '.../picture' placeholders so the snippet is copy-paste executable, and add the missing fs require to the docx-js setup snippet.

Move the XML Reference (tracked changes, comments, image insertion patterns) into a separate reference file linked from the body, keeping SKILL.md as a leaner overview for tasks that don't need raw XML editing.

DimensionReasoningScore

Conciseness

The body is dense and code-heavy with essentially no explanation of concepts Claude already knows, but the table-width rules are stated three times (in the Tables code, the 'Width rules' bullets, and the 'Critical Rules for docx-js' list), so not every token earns its place. It fits 'Efficient; minor instances of over-explanation that could be trimmed' rather than the lean anchor 5, and is well above anchor 3's 'unnecessary explanation'.

4 / 5

Actionability

Nearly all guidance is copy-paste ready — complete bash commands (unpack/pack/validate/soffice) and complete JS snippets for lists, tables, hyperlinks, footnotes, and columns. Minor gaps keep it from anchor 5: the image XML snippet uses placeholder URIs (`Type=".../image"`, `uri=".../picture"`) that are not literally executable, and the setup snippet calls `fs.writeFileSync` without requiring `fs`. This fits 'Mostly executable guidance; concrete code or commands with minor gaps'.

4 / 5

Workflow Clarity

The editing workflow is explicitly sequenced ('Follow all 3 steps in order' with unpack → edit XML → pack, validation built into pack.py with a detailed auto-repair fixes/won't-fix list), and the creation workflow has an explicit feedback loop ('If validation fails, unpack, fix the XML, and repack') plus a consolidated critical-rules checklist. This matches 'Clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes'.

5 / 5

Progressive Disclosure

The Quick Reference table provides clear top-level navigation and every referenced script path (scripts/office/unpack.py, pack.py, validate.py, soffice.py, scripts/comment.py, scripts/accept_changes.py) exists in the bundle, one level deep. However, all instructional content (~585 lines, including the full XML Reference and complete docx-js feature catalog) is inlined in SKILL.md with no split into reference files, so it fits 'Good structure; most content is appropriately placed; minor organization gaps' rather than the anchor-5 'content appropriately split'.

4 / 5

Total

17

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: it states concrete capabilities in third person, enumerates natural trigger phrases including synonyms and file extensions, and closes with an explicit negative boundary that prevents mis-triggering on sibling formats. It is dense with trigger value rather than padded verbosity.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'create, read, edit, or manipulate Word documents', 'extracting or reorganizing content', 'inserting or replacing images', 'performing find-and-replace', 'working with tracked changes or comments' — with comprehensive coverage of the domain. It matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' and does not fit anchor 4, which requires minor gaps in coverage.

5 / 5

Completeness

It explicitly answers both what ('create, read, edit, or manipulate Word documents (.docx files)') and when ('Use this skill whenever the user wants to...', 'Triggers include:...', plus the negative boundary 'Do NOT use for PDFs, spreadsheets, Google Docs'). This clearly matches the anchor for explicit what AND when with concrete trigger phrases, not the weaker anchor 4.

5 / 5

Trigger Term Quality

Natural trigger terms include 'Word doc', 'word document', '.docx', 'tracked changes or comments', and deliverable words like 'report', 'memo', 'letter', 'template' — synonyms, file extensions, and phrasing users would actually say. This matches 'Comprehensive coverage of natural terms including synonyms and file extensions' rather than anchor 4 ('a few natural terms missing').

5 / 5

Distinctiveness Conflict Risk

The niche is tightly scoped to Word/.docx documents, and the explicit exclusions ('Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks') minimize conflicts with closely related document skills. It fits 'Clear niche with distinct triggers; minimal conflict risk' rather than anchor 4's 'minor overlap risk'.

5 / 5

Total

20

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

referenced_paths_exist

Referenced path issues: 7 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

eigent-ai/agent-skills

Path

skills/pdf-and-documents/docx/SKILL.md

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.