Content
82%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 well-structured, highly actionable CLI reference with executable examples covering the common cases and explicit validation guidance for agent consumers. The main gaps are minor: a small amount of redundancy (duplicated description, version section), no error-recovery feedback loop in workflows, and external documentation pointers that are not part of the skill bundle.
Suggestions
Remove the opening paragraph that duplicates the frontmatter description and drop or contextualize the 'Version: 1.0.0' section to save tokens.
Integrate validation into the example workflows (e.g. after 'export render', add 'verify output.svg exists; if render fails, parse stderr and fix diagram syntax') to create an explicit feedback loop.
Resolve the 'More Information' pointers: either include README.md/TEST.md/HARNESS.md as actual bundle reference files or remove the section, since those paths are not part of the skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — compact command tables, executable code blocks, and no explanations of concepts Claude already knows. Minor trimmable instances remain: the opening paragraph repeats the frontmatter description verbatim, the 'Version: 1.0.0' section is time-sensitive information outside any deprecated section, and 'More Information' points to README.md/TEST.md/HARNESS.md that are not part of the skill bundle. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands with concrete flags and output paths throughout (e.g. 'cli-anything-mermaid project new --sample flowchart -o flow.json' and 'export render output.svg --format svg'), and the examples cover the common cases: flowchart creation/render, sequence diagram, share URLs, and REPL usage. | 5 / 5 |
Workflow Clarity | Multi-step workflows are clearly sequenced (create project → set source → render/share) and the 'For AI Agents' section provides explicit validation checkpoints ('Check return codes', 'Parse stderr for error messages on failure', 'Verify outputs exist after render operations'). It falls short of anchor 5 because there is no explicit validate→fix→retry feedback loop integrated into the workflow steps themselves. | 4 / 5 |
Progressive Disclosure | Good structure with clear section headers, well-organized command-group tables, and a 'More Information' section signaling further documentation. It is not anchor 5 because no bundle files exist, the referenced README.md/TEST.md/HARNESS.md live outside the skill directory and cannot be loaded, and a ~183-line single file could split command detail into references. | 4 / 5 |
Total | 17 / 20 Passed |