CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

1.28x
Quality

80%

Does it follow best practices?

Impact

100%

1.28x

Average score across 5 eval scenarios

SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./skills/docx/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

The body is well-structured with a decision tree, concrete executable commands, and a verification step in the redlining workflow, but it is undermined by repeated batching/mandatory-read instructions, a missing error-recovery loop, and references to files that are not present in the bundle. It reads as a skill written for a larger bundle than the one shipped here.

Suggestions

Consolidate the batching guidance, which currently appears three times ('Batching Strategy', step 2 'Batch organization', and step 4 'Suggested batch groupings'), into a single section, and state the 'MANDATORY - READ ENTIRE FILE' instruction once instead of repeating it verbatim in each workflow.

Add an explicit feedback loop after final verification (e.g., 'if grep still finds the original phrase, return to that batch, re-grep word/document.xml, fix, and re-run') and specify how to test each batch (e.g., re-run pandoc and grep the batch's changed phrases before proceeding).

Fix the reference paths to match the actual bundle: docx-js.md, ooxml.md, and ooxml/scripts/unpack.py / pack.py do not exist — either ship those files or update the paths to the real structure (scripts/document.py, scripts/utilities.py, scripts/templates/).

DimensionReasoningScore

Conciseness

Most of the body is efficient, concrete commands, but there is real duplication: batching guidance appears three times ("Batching Strategy", step 2 "Batch organization", and step 4 "Suggested batch groupings"), and "MANDATORY - READ ENTIRE FILE ... NEVER set any range limits" is repeated verbatim three times. This fits anchor 3 ("mostly efficient but includes some unnecessary explanation or could be tightened") better than anchor 4, since the repetition is avoidable padding rather than minor over-explanation.

3 / 5

Actionability

Concrete, copy-paste-ready guidance throughout: pandoc commands, unpack/pack invocations, pdftoppm flags, a BAD/GOOD tracked-changes XML example, grep verification commands, and exact dependency install commands. It stops short of anchor 5 because the central workflows depend on files not present in the bundle (docx-js.md, ooxml.md, ooxml/scripts/unpack.py and pack.py — scripts/ contains document.py and utilities.py instead), so the commands cannot be executed as-is from this skill.

4 / 5

Workflow Clarity

The decision tree routes tasks to clearly numbered workflows, and the redlining workflow ends with an explicit verification step ("grep 'original phrase' verification.md # Should NOT find it"). Anchor 5 is not met because there is no explicit error-recovery feedback loop (what to do when verification fails is unstated) and "Test each batch before moving to the next" never specifies how a batch is tested; anchor 3 would require validation to be missing, which it is not.

4 / 5

Progressive Disclosure

References are clearly signaled with line counts ("Read [ooxml.md](ooxml.md) (~600 lines)"), but scored against the actual bundle structure, the referenced paths do not resolve: docx-js.md, ooxml.md, and ooxml/scripts/unpack.py / pack.py are absent (scripts/ holds document.py, utilities.py, and templates/). Per the rubric's guidance to score against the actual bundle, this is anchor 3 — references present and well signaled, but navigation is broken because the referenced files do not exist.

3 / 5

Total

14

/

20

Passed

Description

88%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.

A strong description: it explicitly states what the skill does with concrete capabilities and gives a clear enumerated 'when to use' trigger tied to the .docx file extension. Its only weaknesses are missing natural synonyms ("Word", "Word documents", bare "docx") and a slightly generic leading phrase that creates minor overlap risk with other document skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — "creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction" — giving comprehensive coverage of the domain's actions. It matches the anchor-5 pattern of multiple specific concrete actions; it is not anchor 4 because no meaningful capability of the skill is left uncovered.

5 / 5

Completeness

It explicitly answers both questions: the "what" via the concrete capability list, and the "when" via "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". This matches the anchor-5 example structure exactly; anchor 4 would require a weaker or less explicit 'when' clause.

5 / 5

Trigger Term Quality

Natural trigger terms are present: "document", "tracked changes", "comments", ".docx files" — good coverage, but the common synonyms "Word" / "Word documents" and the bare "docx" are missing. This sits at anchor 4 ("a few natural terms missing") rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

".docx files" and "tracked changes" are Word-specific triggers that keep it mostly distinct, but the lead phrase "Comprehensive document creation, editing, and analysis" uses the generic word "document" without a "Word" qualifier, leaving minor overlap risk with PDF/presentation document skills. Anchor 4 ("mostly distinct; minor overlap risk") fits better than anchor 5's clear niche.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 missing

Warning

Total

15

/

16

Passed

Repository

KennethJefferson/cc_sdk_knowledge_extractor

Path

skills/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.