CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

docx-generation

Use when creating a Word DOCX report from Markdown, converting Markdown tables and lists to DOCX, or choosing a workflow for editing an existing DOCX while preserving its structure and styles. Use this workflow before running Markdown-to-DOCX shell commands. Includes report typography, table layout, a reusable reference document, and a Python converter.

Quality

85%

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

75%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 delivers a concrete, well-sequenced conversion workflow with executable commands, real error-recovery paths, and correct references to actual bundle files. It stays consistently one notch below excellent because of the dense inline typography specs, the guidance-only editing section, and the absence of an explicit validation step for document edits.

Suggestions

Add an explicit validation step to the "Editing existing DOCX files" workflow (e.g., unpack → edit → validate → repack with a concrete command), since document/XML manipulation benefits from a validate-and-retry loop.

Move the detailed typography and table-layout specifications (A4, margins, point sizes, padding) into a short reference file or table, keeping only a one-line summary in SKILL.md.

Give one concrete command or library example in the editing section so both workflows match the executable standard set by the conversion section.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (no concept re-teaching), but the long inline typography paragraph and pinned version numbers ("Pandoc 3.12.1", "Python 3.9 or newer", not in a deprecated section) are minor over-explanations that could be trimmed, matching anchor 4 rather than the every-token-earns-its-place profile of anchor 5.

4 / 5

Actionability

The main workflow is executable end-to-end (a copy-paste JSON helper snippet, a concrete python invocation with quoted arguments, and exact optional flags), but the "Editing existing DOCX files" section remains at the guidance level ("Modify the existing package with an appropriate document library or narrowly scoped OOXML edits") without a concrete command or example, matching anchor 4's minor gaps.

4 / 5

Workflow Clarity

The conversion sequence is clear (prepare helper → run returned script_path → choose options) with checkpoints including the JSON receipt, the new-output-filename guard that leaves existing files intact, and explicit failure paths for missing helper or Pandoc; however, the document-editing workflow has no explicit validate step, so it is not anchor 5, while the non-destructive main flow's present checkpoints keep it above anchor 3.

4 / 5

Progressive Disclosure

Scored against the actual bundle: the body correctly names scripts/convert.py as the standalone CLI (a real file) and the bundled reference document, and sections (## Markdown to a new DOCX, ## Editing existing DOCX files, ## Artifact delivery) are well organized; but the detailed typography/layout specifications are inlined rather than split out, and bundle navigation is implicit (only convert.py is named), matching anchor 4's minor organization gaps rather than anchor 5.

4 / 5

Total

16

/

20

Passed

Description

88%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 explicitly states both capabilities and trigger conditions in third person, uses concrete domain language, and avoids padding. Trigger coverage is broad with only minor synonym gaps, and the editing trigger slightly overlaps adjacent document skills.

DimensionReasoningScore

Specificity

"creating a Word DOCX report from Markdown, converting Markdown tables and lists to DOCX, or choosing a workflow for editing an existing DOCX while preserving its structure and styles" lists multiple concrete actions that comprehensively cover the skill's create/convert/edit scope, matching the anchor-5 example's breadth rather than having minor gaps.

5 / 5

Completeness

Both parts are explicit: the what ("creating a Word DOCX report from Markdown, converting Markdown tables and lists to DOCX... editing an existing DOCX while preserving its structure and styles") and the when ("Use when creating..." and "Use this workflow before running Markdown-to-DOCX shell commands") with concrete trigger phrases, matching anchor 5; it is not 4 because the when-clauses are specific rather than merely present.

5 / 5

Trigger Term Quality

Natural phrases like "Word DOCX report", "Markdown tables and lists", "editing an existing DOCX", and "Markdown-to-DOCX shell commands" give good keyword coverage with Word/DOCX/Markdown synonyms, but common variations such as "Word document" or ".md" are absent, falling just short of the comprehensive synonym-plus-extension coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The Markdown-to-DOCX conversion niche has distinct, domain-specific triggers, but "editing an existing DOCX while preserving its structure and styles" carries minor overlap risk with a general DOCX-editing skill, matching anchor 4 rather than the minimal-conflict profile of anchor 5.

4 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

aipoch/open-science

Path

resources/skills/docx-generation/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.