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.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

85%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-validated skill body with excellent code coverage and a clear verification feedback loop, but the advanced OOXML/tracked-changes/comments material is inlined in SKILL.md with no bundle files to offload it, weakening progressive disclosure.

Suggestions

Move the lengthy 'Raw OOXML (advanced)' tracked-changes, comments, and traps detail into a reference file (e.g. references/ooxml-advanced.md) and link to it from a short summary, reducing SKILL.md token load.

Keep only a one-paragraph orientation plus a single small code example in the advanced section, pointing to the reference for the full XML patterns and ID rules.

Consider splitting the LibreOffice conversion block into a small scripts/ helper or reference note so the main body stays focused on the primary python-docx workflow.

Dimension	Reasoning	Score
Conciseness	The body is dense and mostly lean — code is presented without explaining what python-docx or OOXML are — but the advanced tracked-changes/comments section is long and carries detail (e.g. full pPr ordering, paraId bounds) that is borderline over-explanation for a top-level SKILL.md, keeping it just below score 5.	4 / 5
Actionability	Fully executable, copy-paste-ready code blocks for read, create, page setup, find-and-replace, conversion, and raw OOXML, plus specific traps and verify commands, covering the common and advanced cases.	5 / 5
Workflow Clarity	Destructive/batch XML operations get an explicit validation feedback loop: the raw-OOXML workflow is sequenced (read part → edit → re-zip) and the 'Verify before returning' section mandates reopening, testzip, and lxml parse with implied fix-and-retry, matching the score-5 anchor with explicit checkpoints.	5 / 5
Progressive Disclosure	There are no bundle files (references/, scripts/, assets/ all absent) and the body is a single ~150-line monolith with the advanced tracked-changes/comments material inlined rather than split into a separate reference file; structure via headers exists but content that belongs in a separate file is inline, matching the score-3 anchor.	3 / 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.

A highly specific, well-triggered description with comprehensive action coverage, explicit 'use when' guidance, and a clear negative boundary that distinguishes it from sibling office skills. It uses appropriate third person voice and avoids padding.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions (extract/summarize text and tables, generate reports/letters/memos with headings/tables/images/TOC/page numbers, find-and-replace, tracked changes, comments) with comprehensive coverage, matching the score-5 anchor.	5 / 5
Completeness	Explicitly answers both 'what' (concrete actions listed) and 'when' via 'Use whenever the user has a .docx or wants a Word deliverable', with concrete trigger phrases, matching the score-5 anchor.	5 / 5
Trigger Term Quality	Covers natural terms plus synonyms and file extension (.docx, Word, Word deliverable) and user-language phrases ('find-and-replace', 'tracked changes', 'redlines'), matching the comprehensive coverage anchor.	5 / 5
Distinctiveness Conflict Risk	Clear niche (Word .docx only) with explicit negative boundary ('Not for PDF, .xlsx, .pptx, or Google Docs'), giving minimal conflict risk and matching the score-5 anchor.	5 / 5
	Total	20 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: HKUDS/DeepTutor
Path: deeptutor/skills/builtin/docx/SKILL.md
Commit: 3e82f13

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.