CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

69

Quality

85%

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%

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-sequenced CLI skill with strong validation feedback loops and copy-paste-ready commands throughout. Its weaknesses are conciseness (length, repetition, inline version pins) and progressive disclosure (a large monolithic file with no reference-file split despite being far over the simple-skill line).

Suggestions

Move the Report-level recipes, Known Issues & Pitfalls, and Advanced/specialty topics into separate reference files (e.g. RECIPES.md, KNOWN-ISSUES.md) referenced one level deep from SKILL.md to cut the main file and improve progressive disclosure.

Deduplicate the repeated footer/field=page and TOC-pagenumbers prohibitions — state each rule once in Known Issues and link to it, rather than restating across three sections.

Consolidate version-sensitive notes ('1.0.60+', '1.0.61+') into a single version-compat note so inline version pins don't penalize conciseness over time.

DimensionReasoningScore

Conciseness

The body is dense with genuine CLI-specific gotchas rather than basics Claude already knows, but at ~657 lines it is long and repeats several rules multiple times (the footer/field=page and TOC pagenumbers prohibitions appear in 'Hard rules worth repeating', the Common pitfalls table, and Known Issues), and version-sensitive notes ('1.0.60+', '1.0.61+', 'officecli 1.0.60') sit inline in main content rather than a deprecated/old-patterns section. This matches 'mostly efficient but could be tightened'; it is not a 3 because not every token earns its place given the repetition and inline version pins, and not a 1 because it largely assumes Claude's competence rather than explaining elementary concepts.

2 / 3

Actionability

Nearly every section gives fully executable bash — the Quick Start is a complete create→close→validate sequence, the Delivery Gate is a copy-paste gate script, and report recipes include real loops with concrete props and paths. This matches 'fully executable code/commands; copy-paste ready'; it is not a 2 because there is no pseudocode or missing key details.

3 / 3

Workflow Clarity

The Common Workflow gives a 6-step sequenced build with explicit checkpoints ('After each structural op, get it back to confirm shape before stacking on top'), and the QA section adds a 7-step minimum cycle plus a Delivery Gate with a fix-and-rerun feedback loop ('One fix commonly creates another problem'). This matches the anchor for clear sequence with explicit validation, feedback loops, and checklists; it is not a 2 because validation checkpoints are explicit, not implicit.

3 / 3

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ absent) and the skill is a single ~657-line monolithic SKILL.md with everything inline; the 'Advanced / specialty topics (skip if writing a report)' header is a good skip signal but content that should be separate (report recipes, Known Issues, the full QA gate scripts) is not split into reference files. This matches 'some structure but content that should be separate is inline'; it is not a 3 because there are no one-level-deep reference files, and not a 1 because section headers organize the content reasonably well rather than leaving a poorly organized wall.

2 / 3

Total

10

/

12

Passed

Description

92%

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, specific, trigger-rich description that clearly states both capabilities and when to invoke the skill. Its only weakness is distinctiveness: generic trigger words like 'document' and 'report' overlap with sibling docx skills without an explicit boundary in the description itself.

Suggestions

Add a disambiguating clause naming when NOT to use this skill (e.g. 'For academic citations/numbered equations use the academic-paper skill; for fillable forms use the word-form skill') to reduce conflict with sibling skills.

Tighten the generic trigger terms ('document', 'report') by qualifying them toward Word/.docx contexts so the skill is less likely to fire for non-docx document tasks.

DimensionReasoningScore

Specificity

The description lists many 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' — matching the anchor for multiple specific concrete actions. It is not a 2 because the action list is comprehensive rather than partial; the 'Use this skill any time...' imperative mirrors the accepted 'Use when...' good-example pattern rather than an explicit 'you' pronoun, so no voice penalty applies.

3 / 3

Completeness

It explicitly answers both halves: what ('creating...reading, parsing, or extracting...editing, modifying...working with templates, tracked changes...') and when ('Use this skill any time a .docx file is involved' and 'Trigger whenever the user mentions...'). This matches the anchor for clearly answering both what AND when with explicit triggers; a 2 would lack the explicit 'Use when' trigger clause, which is present here.

3 / 3

Trigger Term Quality

It surfaces natural terms a user would actually say — "'Word doc', 'document', 'report', 'letter', 'memo'" plus '.docx filename' and 'Word documents' — giving good coverage of common variations. It is not a 2 because it goes beyond a single keyword to a spread of natural phrasings; it is not below 3 since these are user-spoken terms rather than technical jargon.

3 / 3

Distinctiveness Conflict Risk

The niche is .docx via OfficeCLI, but the trigger terms 'document' and 'report' are generic and the description does not disambiguate from sibling skills the body later reveals (officecli-academic-paper, officecli-word-form), so overlap risk remains. It is not a 3 because the generic triggers could fire for tasks those sibling skills own; it is not a 1 because it is anchored on .docx/Word rather than being wholly generic.

2 / 3

Total

11

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

Total

15

/

16

Passed

Repository
Team-Commonly/commonly
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.