CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

officecli-docx

Use this skill any time a .docx file is involved -- as input, output, or both. This includes: creating Word documents, reports, letters, memos, or proposals; reading, parsing, or extracting text from any .docx file; editing, modifying, or updating existing documents; working with templates, tracked changes, comments, headers/footers, or tables of contents. Trigger whenever the user mentions 'Word doc', 'document', 'report', 'letter', 'memo', or references a .docx filename.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Critical

Do not install without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

77%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.

An exceptionally actionable and well-sequenced body with validation and feedback loops throughout — the strongest possible guidance for this tool. Its weaknesses are verbosity (repeated caveats and one section re-teaching a known concept) and a monolithic single-file layout that inlines material (XML appendix, specialty recipes) better suited to separate reference files.

Suggestions

Split the raw-set XML appendix, the advanced/specialty topics, and the report-level recipes into references/ files (e.g., references/raw-set-xml.md, references/recipes.md) and link them one level deep, shrinking SKILL.md to the overview, workflow, and QA gates.

Deduplicate recurring caveats: state the unsupported `differentFirstPage` prop and the `updateFields=true` guidance once each (in Common Pitfalls and TOC respectively) and reference them elsewhere instead of re-explaining them in 3-4 sections.

Trim the 'Mental Model' section to only what is novel (the semantic-path API over the ZIP) and drop the re-explanation that a .docx is a ZIP of XML parts, which Claude already knows.

DimensionReasoningScore

Conciseness

Mostly tool-specific knowledge Claude would not already know, but with tightening opportunities: the unsupported `differentFirstPage` warning is repeated in three sections, `updateFields=true` is re-explained in 4+ places, and the 'Mental Model' section explains that a .docx is a ZIP of XML parts — a concept Claude already knows. This fits the anchor 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is not a 4 because the repetition is more than minor.

3 / 5

Actionability

Every section ships executable, copy-paste bash — concrete `add`/`set`/`query` commands with real prop values, a fully scripted Delivery Gate with reject/exit logic, and recipes flagged as executed and `validate`-passed. This matches the anchor for fully executable, copy-paste-ready commands covering the common cases.

5 / 5

Workflow Clarity

A six-step Common Workflow with explicit sequencing, incremental execution with exit-code checks, a QA minimum cycle, a Delivery Gate with pass/REJECT branches, and a fix-then-rerun-full-cycle feedback loop — exactly the anchor's 'clear sequence with explicit validation steps; feedback loops for error recovery' for batch/XML manipulation. Not a 4 because validation checkpoints and recovery loops are pervasive rather than mostly present.

5 / 5

Progressive Disclosure

The skill is a single ~560-line file with no references/, scripts/, or assets/ bundle at all; content that clearly belongs in separate files (the raw-set XML appendix, the advanced specialty topics, the report-level recipes) is inlined. Section signposting is good ('skip if you are writing a report', delegating full schemas to `officecli help`), which lifts it above a 2, but there are no one-level-deep reference files, so it cannot reach the 4 anchor's 'most content appropriately placed' across files.

3 / 5

Total

16

/

20

Passed

Description

96%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 strong description: it clearly and explicitly states both what the skill does and when to trigger it, using natural user vocabulary and the .docx extension. The only weakness is that generic trigger words like 'document' and 'report' create minor overlap risk with non-Word document skills.

DimensionReasoningScore

Specificity

The description enumerates a comprehensive inventory of concrete actions — 'creating Word documents, reports, letters, memos, or proposals; reading, parsing, or extracting text...; editing, modifying, or updating existing documents; working with templates, tracked changes, comments, headers/footers, or tables of contents' — with no vague filler. It matches the anchor for multiple specific concrete actions with comprehensive coverage; a 4 would require minor gaps, which are not present.

5 / 5

Completeness

It explicitly answers both 'what' (the full create/read/edit/templates/tracked-changes action list) and 'when' with two explicit trigger clauses: 'Use this skill any time a .docx file is involved -- as input, output, or both' and 'Trigger whenever the user mentions...'. This matches the anchor for clearly answering both with concrete trigger phrases; a 4 would require the 'when' to be less explicit.

5 / 5

Trigger Term Quality

It includes natural user phrasing ('Word doc', 'document', 'report', 'letter', 'memo') plus the file extension trigger ('references a .docx filename'), covering synonyms and extensions as the top anchor requires. It is not a 4 because the only omitted terms (e.g., 'proposal', 'paper') are peripheral variations already implied by the listed categories.

5 / 5

Distinctiveness Conflict Risk

The .docx/Word niche is clear and anchored by the file extension, but the bare generic terms 'document' and 'report' in the trigger list overlap with PDF and other document skills, matching the anchor for 'mostly distinct; minor overlap risk'. It is not a 5 because those generic tokens could pull the skill in for non-docx documents; not a 3 because the extension and Word-specific framing keep it largely distinct.

4 / 5

Total

19

/

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

skill_md_line_count

SKILL.md is long (563 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

iOfficeAI/OfficeCLI

Path

skills/officecli-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.