Content
83%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.
A highly actionable, well-sequenced body with a complete merge flow and verification checkpoint — strong on actionability and workflow clarity. The main weakness is progressive disclosure: no bundle files ship with the skill, while the body leans on external paths and inlines all template/placeholder detail that could be split into reference files.
Suggestions
Ship the three starter templates (commonly-brief.docx, commonly-data.xlsx, commonly-deck.pptx) as bundle assets so the referenced `/opt/commonly-bundled-skills/officecli/templates/` files actually exist alongside the skill, or repoint paths to the bundled copies.
Move the per-template placeholder-key listings into one-level-deep reference files (e.g. references/templates.md) and keep SKILL.md as a concise overview pointing to them, improving progressive disclosure and token efficiency.
Trim the 'Why this exists' paragraph and the XLSX multi-row aside to the essential sentence each; they explain background Claude can largely infer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and assumes Claude's competence (placeholder keys, a copy-paste flow, no padding about what .docx/.pptx are); minor over-explanation in 'Why this exists' and the XLSX multi-row aside that could be trimmed. | 4 / 5 |
Actionability | Fully executable: concrete absolute template paths, a complete `--data` JSON file, the exact `officecli merge` invocation, a verification `grep` command, and per-template placeholder key listings — copy-paste ready and covering the common cases. | 5 / 5 |
Workflow Clarity | The flow is a clearly numbered 5-step sequence (pick template, write data, merge, view, attach) with an explicit verification step ('Verifying the output' section with a guard explanation and a placeholder-leak grep) and a reverse-handoff section for error recovery when templates don't fit. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ absent), yet the body references template files under `/opt/commonly-bundled-skills/officecli/templates/` and a repo `build_templates.py` that are not part of this skill's bundle; the per-template placeholder detail is all inlined in SKILL.md with no one-level-deep references, so structure is present but not split across files. | 3 / 5 |
Total | 17 / 20 Passed |