Content
43%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |