CtrlK
BlogDocsLog inGet started
Tessl Logo

docx

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

66

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Medium

Suggest reviewing before use

The canonical home for this skill is docx in anthropics/skills

SKILL.md
Quality
Evals
Security

Quality

Content

62%

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

The body is well-structured with mostly concrete, executable guidance and a clear redlining workflow that includes explicit final verification. Its main weaknesses are minor explanatory padding and, more seriously, references to bundle files (ooxml.md, docx-js.md, ooxml/scripts/unpack.py, pack.py) that do not exist while the actual scripts/document.py is never pointed to.

Suggestions

Fix broken references: replace the 'MANDATORY READ ooxml.md / docx-js.md' instructions and the `ooxml/scripts/unpack.py` & `pack.py` paths with the actual bundle — point to `scripts/document.py` (the Document library) and `scripts/utilities.py`, or add the missing reference files so navigation resolves.

Tighten explanatory padding: remove or trim 'A .docx file is essentially a ZIP archive...', 'Pandoc provides excellent support...', and the DOM-access explanation restated on both lines 66 and 74, since these restate concepts Claude already knows.

Add an explicit validate-before-pack checkpoint (e.g., a validation script or grep check) to the editing workflow, so batch/destructive XML edits get a true fix-and-retry feedback loop before packing rather than only verifying at the very end.

DimensionReasoningScore

Conciseness

Mostly efficient with concrete commands and code, but includes unnecessary explanation Claude already knows: "A .docx file is essentially a ZIP archive containing XML files...", "Pandoc provides excellent support for preserving document structure", and a DOM-access explanation restated at both line 66 and line 74. This fits 'mostly efficient but includes some unnecessary explanation' rather than the 'every token earns its place' level 3.

2 / 3

Actionability

Many commands are concrete and copy-paste ready (pandoc, soffice, pdftoppm, the redlining GOOD/BAD code), but the central editing/redlining workflows hinge on `ooxml/scripts/unpack.py`, `ooxml/scripts/pack.py`, and the 'MANDATORY READ' `ooxml.md`/`docx-js.md` files — none of which exist in the bundle (the real API lives in `scripts/document.py`, which is never referenced). These broken paths are 'missing key details' that keep it from being fully executable as written.

2 / 3

Workflow Clarity

The redlining workflow is a clear 6-step numbered sequence culminating in an explicit final verification step with concrete grep commands (grep "original phrase" should NOT find it; grep "replacement phrase" should find it) and a checklist to catch unintended changes. Validation is present (not missing), so the batch/destructive cap-at-2 rule does not apply; it is not a 2 because the verification checkpoint is explicit and concrete rather than implicit.

3 / 3

Progressive Disclosure

SKILL.md is well-organized as an overview with one-level signaled references, but scored against the actual bundle the references are broken: `ooxml.md`, `docx-js.md`, and `ooxml/scripts/*.py` do not exist, while the real bundle file `scripts/document.py` is never referenced. This matches 'references present but not clearly signaled / could be better organized' (broken navigation) rather than the 'easy navigation' level 3; it is not a 1 because the SKILL.md structure itself is clear with no deep nesting.

2 / 3

Total

9

/

12

Passed

Description

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.

The description is strong: it uses third-person voice, names concrete capabilities, provides explicit 'when to use' triggers, and stakes out a distinct .docx niche. Voice is third person throughout ('When Claude needs to work with...'), so no specificity penalty applies.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "document creation, editing, and analysis", "tracked changes, comments, formatting preservation, and text extraction", plus enumerated tasks (creating, modifying, working with tracked changes, adding comments) — matching the 'lists multiple specific concrete actions' anchor. It is not a 2 because the action set is comprehensive rather than naming only a domain and a few actions.

3 / 3

Completeness

Explicitly answers both what ("Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction") and when ("When Claude needs to work with professional documents (.docx files) for: (1)... (4)..."). The explicit 'When Claude needs to work with...' trigger clause is equivalent to a 'Use when' clause, so it is not capped at 2.

3 / 3

Trigger Term Quality

Includes natural terms users would say — "professional documents (.docx files)", "tracked changes", "comments", "creating new documents", "modifying content" — giving good coverage of common variations; structure mirrors the pptx good example. It is not a 2 because it covers the natural variations rather than only 'some relevant keywords'.

3 / 3

Distinctiveness Conflict Risk

The .docx niche with tracked changes/comments/formatting is a clear, distinct domain unlikely to conflict with PDF, pptx, or xlsx skills, matching the 'clear niche with distinct triggers' anchor. It is not a 2 because the scope is narrowly tied to .docx rather than broadly overlapping 'document files'.

3 / 3

Total

12

/

12

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 3 missing

Warning

Total

14

/

16

Passed

Repository
netease-youdao/LobsterAI
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.