CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

97

1.73x
Quality

97%

Does it follow best practices?

Impact

97%

1.73x

Average score across 3 eval scenarios

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.

The body is a dense, expert-level reference: every command is executable, both the edit and create paths have explicit validation and visual verification loops, and it consistently teaches only what Claude would not reliably know (footguns, schema ordering, rendering quirks). The only structural weakness is that the deep tracked-changes and comments XML detail lives inline in SKILL.md rather than in a one-level-deep reference file.

Suggestions

Move the tracked-changes XML mechanics (w:delText, deleted paragraph marks, rPr child ordering, the accept_changes.py/pandoc empty-bullet edge cases) into a references/tracked-changes.md file and keep a 2–3 line pointer plus the validate --author reminder in SKILL.md.

Compress the comments section to the comment.py invocations plus one sentence on what the script writes; the six-file architecture detail is already handled by the script and adds little value inline.

Consider a brief 'Common create pitfalls' checklist cross-link so the docx-js gotchas can be skimmed without loading the full list during simple edits.

DimensionReasoningScore

Conciseness

Lean and dense throughout: it explicitly delegates known knowledge ("The model knows the API; these are the footguns") and spends tokens only on non-obvious specifics ("1440 = 1″", "ShadingType.CLEAR, never SOLID", "the text element is <w:delText>, not <w:t>"). Not 4: there is no padded explanation of concepts Claude already knows; even the one-line "A .docx is a ZIP archive of XML files" is load-bearing for the edit-via-unzip workflow.

5 / 5

Actionability

Copy-paste-ready commands cover every common case: full bash blocks for editing (unzip → merge_runs.py → zip → validate.py), verification (soffice.py --convert-to pdf, pdftoppm -jpeg), and comments (comment.py in both directory and .docx modes), plus exact API values for each docx-js gotcha (e.g. "width: 12240, height: 15840", "PositionalTabAlignment.RIGHT"). Not 3/4: the guidance is executable as written, not pseudocode or high-level hints; the docx-js section's reliance on known API plus concrete footgun values leaves no material gap.

5 / 5

Workflow Clarity

The task-approach table routes by operation type; the edit pipeline is a numbered sequence of concrete commands with an explicit validation step (`validate.py out.docx --original doc.docx`), error recovery (`--auto-repair fixes common issues`), a redlining audit (`--author` reports untracked edits), and a separate visual verification loop for created files (render to PDF → images → Read). Not 4: validation checkpoints and feedback loops are explicit for both the destructive XML-manipulation path and the creation path, satisfying the rubric's XML-editing feedback-loop requirement.

5 / 5

Progressive Disclosure

Good structure: the task table is a genuine overview, sections are clearly headed, and every referenced script (scripts/merge_runs.py, scripts/office/soffice.py, scripts/office/validate.py, scripts/accept_changes.py, scripts/comment.py) exists in the bundle as a one-level-deep reference, with script complexity (six-file comments plumbing) properly pushed into comment.py. Not 5: the body is ~88 lines with the tracked-changes XML minutiae (w:delText, deleted paragraph marks, rPr child ordering) and the accept-changes edge-case discussion inlined in SKILL.md, where a skill of this breadth would benefit from splitting that deep detail into a references/ file with a short pointer.

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: it names the file formats and a comprehensive set of concrete operations, provides explicit trigger phrases users would naturally say (including synonyms and extensions), and closes with clear exclusions to prevent mis-triggering. Both the 'what' and 'when' questions are answered explicitly and concretely.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — "create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files)", "extracting or reorganizing content", "inserting or replacing images", "performing find-and-replace", "working with tracked changes or comments", "converting content into a polished Word document" — with comprehensive coverage across creation, editing, reading, and analysis. Not 4: there are no minor gaps in action coverage; every major Word-document task is explicitly named.

5 / 5

Completeness

Explicitly answers both questions: what ("create, read, edit, or manipulate Word documents... or Word templates") and when ("Use this skill whenever the user wants to...", "Triggers include: any mention of...", "If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill"), with concrete trigger phrases and explicit negative boundaries. Not 4: the 'when' clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

Comprehensive natural trigger terms including synonyms and file extensions: "'Word doc', 'word document', '.docx', '.dotx'", plus deliverable words users actually say ("'report', 'memo', 'letter', 'template'") and task phrases like "find-and-replace" and "tracked changes". Not 4: even colloquial variants ('Word doc') and extension forms are covered.

5 / 5

Distinctiveness Conflict Risk

Clear niche (Word .docx/.dotx documents) with distinct triggers and an explicit exclusion list — "Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation" — that minimizes overlap with adjacent document/spreadsheet skills. Not 4: conflict risk is actively reduced by the stated boundaries, not just mostly avoided.

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

referenced_paths_exist

Referenced path issues: 3 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

K-Dense-AI/claude-scientific-writer

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.