docx

Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', 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 or .dotx 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.

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

100%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 high-quality, dense skill body: executable commands, non-obvious footguns, explicit validation/feedback checkpoints for risky document manipulation, and clean one-level-deep references to real bundle scripts. Assumes Claude's competence and adds only what it would not already know.

Dimension	Reasoning	Score
Conciseness	Lean and footgun-focused; explicitly states 'the model knows the API; these are the footguns' and limits itself to non-obvious specifics (DXA page sizes, ShadingType.CLEAR vs SOLID, PositionalTab leaders, schema-enforced child ordering). The single orienting clause 'A .docx is a ZIP archive of XML files' directly motivates the create-vs-edit routing rather than padding.	5 / 5
Actionability	Fully executable, copy-paste-ready commands throughout — 'pandoc -t markdown file.docx', 'python scripts/office/soffice.py --headless --convert-to pdf', 'unzip -q doc.docx -d unpacked/', 'zip -Xr ../out.docx .', 'python scripts/office/validate.py out.docx --original doc.docx', 'python scripts/accept_changes.py in.docx out.docx', 'python scripts/comment.py unpacked/ "..."' — plus concrete API field values for the docx-js gotchas.	5 / 5
Workflow Clarity	Clear sequenced workflows with explicit validation checkpoints and feedback loops for the destructive XML/document-manipulation operations: a render-and-look 'Verify the output' step, 'validate.py' with '--auto-repair', and '--author' redline tracking that 'reports any text you changed without a <w:ins>/<w:del> around it'.	5 / 5
Progressive Disclosure	SKILL.md is a well-organized overview (task-routing table → create gotchas → verify → edit → comments → dependencies) that references real bundle scripts by exact one-level-deep paths — scripts/merge_runs.py, scripts/office/validate.py, scripts/office/soffice.py, scripts/accept_changes.py, scripts/comment.py, scripts/templates/*.xml — all verified to exist, with the heavy machinery (XSD validation, comment-file generation) correctly pushed into the scripts layer.	5 / 5
	Total	20 / 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 model description: concrete capabilities, comprehensive natural trigger terms with file extensions and synonyms, explicit what-and-when guidance, and a clear negative boundary. Third-person/imperative voice throughout with no vague padding.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions — 'create, read, edit, or manipulate', 'extracting or reorganizing content', 'inserting or replacing images', 'find-and-replace', 'working with tracked changes or comments', 'converting content into a polished Word document' — giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both 'what' (the create/read/edit/extract/find-replace/tracked-changes/actions) and 'when' via concrete trigger clauses — 'Use this skill whenever', 'Triggers include', 'Also use when', 'If the user asks for a report, memo, letter...'.	5 / 5
Trigger Term Quality	Comprehensive natural-term coverage including synonyms and file extensions: 'Word doc', 'word document', '.docx', '.dotx', 'report', 'memo', 'letter', 'template', plus formatting cues like 'tables of contents, headings, page numbers, or letterheads' — terms a user would naturally say.	5 / 5
Distinctiveness Conflict Risk	Clear Word/.docx niche with distinct triggers and an explicit exclusion boundary — 'Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks' — minimizing conflict risk with adjacent skills.	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
referenced_paths_exist	Referenced path issues: 3 deeper-than-1-level	Warning

	Total	15 / 16 Passed

Repository: K-Dense-AI/scientific-agent-skills
Path: skills/docx/SKILL.md
Commit: b2a92ba

Reviewed: 3 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.