CtrlK
BlogDocsLog inGet started
Tessl Logo

docx

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

73

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

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.

A highly actionable, well-sequenced body with validation and recovery loops in both creation and editing workflows. Its weaknesses are repetition (table-width rules stated three ways) and monolithic structure — detailed API and XML reference material that belongs in separate reference files is inlined, so the whole 585-line body is always in context.

Suggestions

Move the docx-js API cookbook and the XML Reference into separate reference files (e.g. references/docx-js.md and references/ooxml.md), keeping only the Quick Reference table, the 3-step edit workflow, and the Critical Rules in SKILL.md with clearly signaled one-level-deep links.

State the table width rules once (in the Tables section) and remove the duplicate restatements in 'Table width calculation' and 'Critical Rules for docx-js'; reserve 'CRITICAL' for the handful of rules that truly break output.

Reference scripts/templates/ (the comment XML templates used by comment.py) from the Comments section so the full bundle structure is discoverable from the body.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — no padded prose, just rules and code — but table-width guidance is stated three times (Tables section, 'Width rules', and 'Critical Rules for docx-js'), the Critical Rules list largely restates per-section CRITICAL callouts, and 'CRITICAL' appears ~15 times, diluting its signal. Not 5: the duplicated table-width and rules-summary material could be trimmed; not 3: the over-explanation is minor and localized, not pervasive.

4 / 5

Actionability

Fully executable throughout: copy-paste docx-js snippets for every feature (lists, tables, images, hyperlinks, footnotes, TOC, columns), exact commands with paths ('python scripts/office/unpack.py document.docx unpacked/'), and concrete XML patterns for tracked changes and comments. Not 4: even edge cases like deleting whole paragraph marks and rejecting another author's insertion get complete worked XML.

5 / 5

Workflow Clarity

The edit workflow is explicitly sequenced ('Follow all 3 steps in order': unpack → edit XML → pack with validation and auto-repair), and the creation workflow has an explicit feedback loop ('If validation fails, unpack, fix the XML, and repack'), plus documentation of what auto-repair will and won't fix. Not 4: validation checkpoints and error-recovery loops are explicit rather than merely present with minor gaps.

5 / 5

Progressive Disclosure

Section headers, a Quick Reference table, and clear script references give real structure, but the entire docx-js API cookbook (~250 lines) and full XML Reference (~130 lines) are inlined in SKILL.md with no reference files to defer detail — everything loads into context upfront despite the bundle having no references/ directory. Not 4: the 4 anchor expects bulk detail in a separate file with only key examples inline; not 2: navigation is easy and nothing is an unstructured wall of text.

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.

An exemplary description: concrete capability enumeration, explicit trigger guidance with natural synonyms and file extensions, and a clear negative-scope clause. It is dense rather than padded — every clause adds trigger surface.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'create, read, edit, or manipulate Word documents', 'extracting or reorganizing content', 'inserting or replacing images', 'performing find-and-replace', 'working with tracked changes or comments' — with comprehensive coverage matching the top anchor. Not 4: coverage extends well past 'several specific actions' into the full task space of the skill.

5 / 5

Completeness

Explicitly answers both what ('create, read, edit, or manipulate Word documents (.docx files)') and when ('Use this skill whenever...', 'Triggers include:...') with concrete trigger phrases, plus an explicit exclusion clause ('Do NOT use for PDFs, spreadsheets, Google Docs...'). Not 4: the 'when' is not merely present but enumerated with specific trigger phrases.

5 / 5

Trigger Term Quality

Covers natural synonyms users actually say — 'Word doc', 'word document', '.docx' — plus deliverable words like 'report', 'memo', 'letter', 'template', and feature terms like 'tracked changes', 'comments', 'tables of contents', matching the comprehensive-with-synonyms-and-extensions anchor. Not 4: no commonly used natural term is missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche (.docx/Word) with distinct triggers and an explicit negative scope that rules out the nearest competing skills (PDFs, spreadsheets, Google Docs). Not 4: the exclusion clause removes even the minor overlap risk the 4 anchor describes.

5 / 5

Total

20

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

referenced_paths_exist

Referenced path issues: 4 missing, 4 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository
nextlevelbuilder/goclaw
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.