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). 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.

72

Quality

90%

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

78%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 strong, highly actionable body with executable commands, complete code examples, and a clearly sequenced editing workflow with validation. Weaknesses are mild redundancy in the table-width guidance and a fully monolithic structure: ~480 lines with no progressive disclosure into reference files despite large XML/API reference sections that would naturally split out.

Suggestions

Split the 'XML Reference' section (tracked changes, comments, images) and possibly the docx-js recipe sections into references/*.md files (e.g. references/xml-patterns.md) linked with clear one-level-deep pointers from the body, keeping SKILL.md as a lean overview.

Deduplicate the table-width guidance: state the dual-width/DXA rules once in the Tables section and remove the repeated warnings from the width-calculation block, 'Width rules' list, and 'Critical Rules' list.

Add an explicit recovery step to the editing workflow: after Step 3, state that if pack validation fails on items auto-repair cannot fix (malformed XML, missing relationships), fix the XML and re-run pack.

DimensionReasoningScore

Conciseness

The body is code-first and mostly lean — no concept explanations Claude already knows — but repeats the same guidance multiple times: dual table widths appears in the Tables section, the width-calculation block, the 'Width rules' list, and the 'Critical Rules' list, and the DXA-vs-PERCENTAGE warning appears three times. Fits 'efficient; minor instances of over-explanation that could be trimmed'; not 5 due to this repetition, not 3 since the padding is duplication of genuinely critical rules rather than verbosity.

4 / 5

Actionability

Everything is executable: copy-paste bash commands (`pandoc --track-changes=all ...`, `python scripts/office/unpack.py ...`), complete docx-js code blocks, a DXA units table, exact XML entity codes, and concrete pitfalls (ShadingType.CLEAR, PageBreak-in-Paragraph). All referenced scripts (accept_changes.py, comment.py, office/unpack.py, office/pack.py, office/validate.py, office/soffice.py) exist in the bundle. Fully matches 'fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The editing workflow is explicitly sequenced ('Follow all 3 steps in order': unpack → edit XML → pack) and the creation path has an explicit feedback loop ('If validation fails, unpack, fix the XML, and repack'), with pack listing what auto-repair does and does not fix. Falls just short of anchor 5 because the editing path never states the retry step when pack validation fails on the 'won't fix' items (malformed XML, missing relationships) — recovery is implied rather than an explicit validate→fix→re-validate checkpoint.

4 / 5

Progressive Disclosure

The body is well-sectioned (Quick Reference, Creating, Editing, XML Reference) but is a single ~480-line file with no reference documents at all — the XML pattern reference (tracked changes, comments, images) and the docx-js API recipes are exactly the content that belongs in one-level-deep references/*.md files. Matches 'some structure... content that should be separate is inline'; not 4 because there are no clearly signaled reference files to navigate to, not 2 because the inline file itself is well-organized and navigable via its section headers.

3 / 5

Total

16

/

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 list, explicit trigger guidance with natural user phrasings and the .docx extension, and a clear negative boundary against PDFs, spreadsheets, and Google Docs. Both 'what' and 'when' are answered explicitly with no vagueness or over-claiming.

DimensionReasoningScore

Specificity

Lists many concrete actions — "create, read, edit, or manipulate Word documents", "inserting or replacing images", "performing find-and-replace", "working with tracked changes or comments", "converting content into a polished Word document" — with comprehensive coverage and no significant gaps. Matches the anchor 'lists multiple specific concrete actions; comprehensive coverage' exactly; anchor 4 would require minor coverage gaps that are absent.

5 / 5

Completeness

Explicitly answers both what ("create, read, edit, or manipulate Word documents (.docx files)") and when ("Use this skill whenever...", "Triggers include:...", "If the user asks for a 'report'... use this skill") with concrete trigger phrases. Fully matches the anchor 5 example pattern; not 4 because the 'when' is maximally explicit rather than merely adequate.

5 / 5

Trigger Term Quality

Covers natural user phrasings ("Word doc", "word document", "report", "memo", "letter", "template", "tracked changes", "comments") plus the file extension ".docx". This hits the anchor 'comprehensive coverage of natural terms including synonyms and file extensions'; anchor 4 would require missing natural terms, and none are missing.

5 / 5

Distinctiveness Conflict Risk

Occupies a clear .docx niche with distinct triggers and explicitly excludes adjacent domains ("Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks"), removing even minor overlap risk. Not 4: the explicit negative boundary leaves no residual conflict with closely related skills.

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

metadata_version

'metadata.version' is missing

Warning

referenced_paths_exist

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

Warning

Total

14

/

16

Passed

Repository

agentscope-ai/QwenPaw

Path

src/qwenpaw/agents/skills/docx-en/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.