CtrlK
BlogDocsLog inGet started
Tessl Logo

docx

Read, create, or edit Microsoft Word .docx files — extract/summarize text and tables, generate reports/letters/memos with headings, tables, images, TOC and page numbers, do find-and-replace, or apply tracked changes (redlines) and comments. Use whenever the user has a .docx or wants a Word deliverable. Not for PDF, .xlsx, .pptx, or Google Docs.

77

Quality

98%

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

96%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 dense, high-signal body: executable code for every common flow, docx-specific traps instead of concept explanations, and explicit validation gates including a dedicated verify-before-returning section. The only structural note is that the advanced raw-OOXML material is inlined rather than externalized, keeping progressive disclosure one notch below perfect.

Suggestions

Move the raw-OOXML advanced tier (tracked-changes XML splicing, comments.xml anchoring, and the w:id/paraId uniqueness constraints) into a references/ file such as references/ooxml.md, keeping SKILL.md as a lean two-tier overview with a clearly signaled one-level-deep link.

If keeping everything inline, add a brief table of contents or per-section one-line summaries at the top so the ~100 lines of advanced XML detail can be skipped on first read without scanning.

DimensionReasoningScore

Conciseness

Nearly every token is docx-specific knowledge Claude does not already have: the two-tier split ("Default — python-docx ... Advanced — raw OOXML"), traps like "Never type bullet/number characters", "No \n inside a run", "xml:space=\"preserve\" on any <w:t> with leading/trailing whitespace", and the run-splitting gotcha in find-and-replace. Not a 4: there is no over-explanation to trim — even the one-line format intro ("A .docx is a ZIP of XML parts") is load-bearing for the raw-OOXML tier, and the LibreOffice scaffold is abbreviated precisely because the tool is optional.

5 / 5

Actionability

Every main flow ships complete, runnable code: reading (doc.paragraphs/tables loop), creation (headings, runs, real list styles, table with header row, picture, page break, then reopen-and-assert validation), find-and-replace with the runs[0]-collapse fallback, the raw-OOXML re-zip loop, and a full add_page_number field-XML function. Not a 4: the only non-executable block is the soffice scaffold, and its flexibility is explicitly justified ("optional and often absent" with a shutil.which check and degrade path), which the rubric guidelines exempt.

5 / 5

Workflow Clarity

Sequences are explicit with validation checkpoints and feedback loops where it matters: create code ends with "Validate immediately" (reopen + assert paragraphs + ZIP test), the raw-OOXML tier states its workflow ("read the XML part → edit it as text → re-zip every original member"), a dedicated "Verify before returning" section requires reopening, testzip, and lxml well-formedness checks in the same exec call, and the LibreOffice path degrades with "If it is absent, degrade with a clear note". Not a 4: the feedback loop (validate → fix → re-verify) that anchor 4 leaves implicit is spelled out as a hard gate before returning.

5 / 5

Progressive Disclosure

Structure is good: a clear two-tier overview ("Default — python-docx / Advanced — raw OOXML") with a signaled internal anchor ([Raw OOXML](#raw-ooxml-advanced)), and no bundle files exist so nothing is mis-filed. Not a 5: ~100 lines of advanced material (tracked-change XML splicing rules, comments.xml anchoring, w:id/paraId constraints) are inlined in the single SKILL.md rather than split into one-level-deep reference files, which the anchor-5 pattern reserves for a lean overview plus pointed references; not a 3 because the tiering and headers make the inline content easy to navigate and it is arguably within an acceptable single-file budget.

4 / 5

Total

19

/

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: comprehensive concrete capabilities, natural trigger phrasing with extensions and synonyms, an explicit use-when clause, and explicit boundary guidance against adjacent formats. Third-person voice throughout with no padding.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "extract/summarize text and tables", "generate reports/letters/memos with headings, tables, images, TOC and page numbers", "do find-and-replace", "apply tracked changes (redlines) and comments" — with concrete output artifacts, matching the comprehensive-coverage anchor. It is not below 4 because there are no meaningful gaps across the skill's read/create/edit surface; it is not above 5 because 5 is the scale maximum.

5 / 5

Completeness

Both questions are explicitly answered: the "what" is the enumerated action list, and the "when" is the explicit trigger clause "Use whenever the user has a .docx or wants a Word deliverable". Not a 4: the trigger is not merely present but concrete and user-conditioned, exactly matching the anchor-5 example structure, and the negative scope ("Not for PDF, .xlsx, .pptx, or Google Docs") further sharpens it.

5 / 5

Trigger Term Quality

Natural user phrasing is comprehensively covered with synonyms and file extensions: ".docx", "Microsoft Word", "Word deliverable", "reports/letters/memos", "tracked changes (redlines)", "find-and-replace", plus adjacent-format extensions (.xlsx, .pptx). Not a 4: the anchor-5 example's synonym-plus-extension pattern ("PDF files, PDFs, forms, .pdf") is fully paralleled here, including the colloquial "redlines" synonym.

5 / 5

Distinctiveness Conflict Risk

The skill owns a clear niche (.docx / Word documents) with format-specific triggers and an explicit exclusion of the adjacent formats most likely to collide (PDF, .xlsx, .pptx, Google Docs). Not a 4: the anchor-4 example ("Works with PDF and Word document files") still carries overlap risk, whereas this description both narrows to one format and explicitly fences off its nearest neighbors.

5 / 5

Total

20

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
HKUDS/DeepTutor
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.