CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

minimax-docx

Professional DOCX document creation and editing using OpenXML SDK. Useful for branded reports, polished proposals, and template-based authoring.

48

Quality

61%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/minimax-docx/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

43%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 is a lean catalogue stub rather than an operational skill: it duplicates the description, points to an external repository with a non-executable command, and provides no concrete DOCX workflow. Once loaded, it gives the agent essentially nothing actionable for the advertised task.

Suggestions

Replace the 'open https://github.com/MiniMax-AI/skills' snippet with an executable command (e.g. git clone and a copy/install step into the agent's skills directory, or a package-manager install) so the setup can actually be run.

Bundle or inline the core upstream workflow (unpack, edit word/document.xml, validate, repack) so the skill is usable without leaving SKILL.md, and remove the verbatim duplication of the description in 'What it does'.

Add explicit validation checkpoints to the workflow (e.g. 'validate the XML and only repack when validation passes') since DOCX/XML manipulation is exactly the fragile, batch-style operation that requires feedback loops.

DimensionReasoningScore

Conciseness

The body is short and doesn't explain concepts Claude already knows, but it restates the frontmatter description verbatim in 'What it does' and repeats the upstream attribution twice ('Curated from the MiniMax AI team' plus the Source section). Fits anchor 4 (efficient, minor instances that could be trimmed); not 5 because of the duplicated tokens.

4 / 5

Actionability

'install the upstream bundle into your active agent's skills directory' is a high-level hint with no install command, and the only code block ('open https://github.com/MiniMax-AI/skills') is a non-executable pointer ('open' is not a Linux command) rather than a concrete step. There is no actual DOCX guidance. Fits anchor 2 (minimal concrete guidance, missing the specific steps to execute); not 3 because the single command given does not perform the described action.

2 / 5

Workflow Clarity

A rough sequence exists (inspect upstream README, install the bundle, invoke the skill by name) but it is expressed only in prose with no concrete commands and no validation steps. Fits anchor 2 (rough sequence present, many gaps, validation absent); not 3 because the steps themselves are poorly defined, not merely missing checkpoints.

2 / 5

Progressive Disclosure

Sections are short and clearly labeled, but the actual instructional content is entirely delegated to an external GitHub URL embedded as a code-block comment, with no bundled references (no references/, scripts/, or assets/ directories exist). Fits anchor 3 (some structure, references present but not clearly signaled); not 5 because the simple-skill exception requires no reliance on external references, and not 4 because the path to the real content is not cleanly navigable.

3 / 5

Total

11

/

20

Passed

Description

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

The description clearly states what the skill does and names a specific technology, but it never tells the agent when to invoke it, and it lacks the natural synonyms (.docx, Word) that would strengthen triggering and distinctiveness. It reads as a capability statement rather than an invocation guide.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to create, edit, or format Word documents (.docx files), or mentions branded reports, proposals, or template-based authoring.'

Include natural synonyms and file extensions such as '.docx', 'Word documents', and 'Word files' to broaden and sharpen triggering.

Replace generic actions ('creation and editing') with 1-2 more concrete operations (e.g. 'apply brand styles, insert tables and images, edit existing .docx files') to raise specificity.

DimensionReasoningScore

Specificity

Names the domain ('DOCX document', 'OpenXML SDK') and two actions ('creation and editing'), but those actions are generic — the remaining phrases ('branded reports, polished proposals, template-based authoring') describe output types, not concrete operations. Matches anchor 3 (domain plus 1-2 actions, not comprehensive); not 4 because no specific sub-operations are listed.

3 / 5

Completeness

The 'what' is clear, but there is no 'Use when...' clause or equivalent explicit trigger guidance — 'Useful for branded reports, polished proposals, and template-based authoring' names output categories without stating when to invoke the skill, and the judging guidelines cap completeness at 3 in that case. Not 4 because the cap explicitly overrides the 'when could be more explicit' anchor.

3 / 5

Trigger Term Quality

Good natural keyword coverage ('DOCX', 'document', 'branded reports', 'proposals', 'template') but missing common synonyms and extensions like '.docx', 'Word', or 'Word documents'. Fits anchor 4 (good coverage, a few natural terms missing); not 5 because synonyms and file extensions are absent.

4 / 5

Distinctiveness Conflict Risk

'Professional DOCX document creation and editing using OpenXML SDK' carves a fairly distinct niche with minor overlap risk against other document skills. Fits anchor 4 (mostly distinct, minor overlap with closely related skills); not 5 because missing '.docx'/'Word' synonyms leave some overlap with generic document skills.

4 / 5

Total

14

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

nexu-io/open-design

Path

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