CtrlK
BlogDocsLog inGet started
Tessl Logo

docx-official

Use this skill whenever a Microsoft Word (.docx) file is being produced, opened, transformed, or read. That includes: drafting reports, letters, contracts, RFPs, technical documents, or any long-form written deliverable; extracting text or structure from an existing Word file; filling a Word template with values; converting Word to PDF or plain text; splitting or merging documents; inspecting styles, headings, sections, tables, images, comments, or tracked changes. Trigger on mentions of 'Word doc', 'DOCX', 'Office document', a filename ending in .docx, or requests like 'turn this into a Word report'.

74

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

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.

The body is an effective overview: highly actionable commands, explicit sequencing, and a validation-driven QA loop make it strong on actionability and workflow clarity. Its one significant defect is that the three workflow documents it routes nearly everything through (create.md, edit.md, read.md) are absent from the bundle, so progressive disclosure is structurally sound but functionally broken.

Suggestions

Ship the referenced workflow files create.md, edit.md, and read.md (or inline their essential steps into SKILL.md) — the decision matrix and 'Where each detail lives' section currently point readers at documents that do not exist.

Trim editorial framing that adds no actionable signal, e.g. 'not a design tool trying to reinvent typography' and the licensing/standards provenance paragraph in the intro, which could be collapsed to one line.

scripts/transcode.py exists in the bundle but is never mentioned; either document it in the commands section or remove it so the file listing matches the skill's stated surface.

DimensionReasoningScore

Conciseness

The body is dense and token-efficient — decision matrix, command block, typography and page-setup tables, all concrete with almost no explanation of concepts Claude already knows. It sits between the level-4 anchor ('efficient; minor instances of over-explanation that could be trimmed') and level 5: a few phrases are editorial padding, e.g. 'Users expect it to look like something a human wrote in Word — not a design tool trying to reinvent typography' and the licensing/ECMA-376 provenance paragraph in the intro, so it is noticeably above the midpoint but not quite 'every token earns its place'.

4 / 5

Actionability

Nearly everything is copy-paste executable: 'uv run scripts/extract_text.py input.docx', a seven-command block, a QA section with runnable checks (python-docx open test, grep for placeholder residue, render_pdf.py, a fake-heading inspection snippet), and concrete one-liners like 'soffice --headless --convert-to docx old.doc'. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases' and exceeds level 4, which tolerates gaps.

5 / 5

Workflow Clarity

The decision matrix routes each situation to a concrete path, the mixing rule 'read → plan → edit/create → validate' gives an explicit global sequence, and the QA checklist provides validation checkpoints with a feedback loop: four explicit verify commands followed by 'If any of these fail, fix and re-run — don't paper over'. This matches the anchor with explicit validation steps and error-recovery loops, which is exactly what XML/document manipulation skills require.

5 / 5

Progressive Disclosure

The structure is well designed — a decision matrix and a 'Where each detail lives' section signaling one-level-deep references to create.md, edit.md, and read.md — but scored against the actual bundle, none of those three referenced files exist (the directory contains only SKILL.md and scripts/), so the main navigation chain is broken and roughly all detailed guidance is missing. This falls below level 4 ('minor organization gaps' — dangling primary references are more than minor) and fits level 3: some structure, references clearly signaled, but the split is not actually realized, while scripts/ references are real and correctly linked.

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.

This is a strong, exemplar-quality description: it answers what the skill does with a comprehensive enumerated task list, and when to use it with an explicit 'Use this skill whenever...' clause plus concrete trigger terms including the .docx extension and natural user phrasings. It is dense but not padded — every clause adds trigger or capability signal.

DimensionReasoningScore

Specificity

The description lists many concrete, comprehensive actions: 'drafting reports, letters, contracts, RFPs', 'extracting text or structure', 'filling a Word template with values', 'converting Word to PDF or plain text', 'splitting or merging documents', 'inspecting styles, headings, sections, tables, images, comments, or tracked changes'. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' and is clearly above the level-4 anchor, which allows minor coverage gaps — none are evident here.

5 / 5

Completeness

Both 'what' (produce, open, transform, or read .docx files, with an enumerated task list) and 'when' are explicitly answered with concrete trigger phrases: 'Use this skill whenever a Microsoft Word (.docx) file is being produced, opened, transformed, or read' plus 'Trigger on mentions of...'. This matches the anchor 'Clearly and explicitly answers both what AND when with concrete trigger phrases'; a level-4 score would require a weaker or less explicit 'when' clause.

5 / 5

Trigger Term Quality

It covers natural terms and synonyms users would actually say — 'Microsoft Word (.docx)', 'Word doc', 'DOCX', 'Office document', 'a filename ending in .docx', and a natural request phrase 'turn this into a Word report' — matching the anchor for comprehensive coverage including synonyms and file extensions. It sits above level 4, which expects 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (Microsoft Word .docx authoring/editing/reading) with distinct triggers ('Word doc', '.docx', 'Word template'), so minimal conflict risk with other format skills. 'Converting Word to PDF' only slightly brushes a PDF skill's territory but is anchored on Word as the source format, keeping it at the 'clear niche' anchor rather than the level-4 'minor overlap risk' anchor.

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

relative_links

Relative link issues: 7 missing

Warning

Total

15

/

16

Passed

Repository
XiaomiMiMo/MiMo-Code
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.