Content
88%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, example-driven playbook that teaches each visualization format by showing it, with explicit selection criteria and placement guidance, and assumes Claude's competence throughout. Its only weaknesses are minor: a placeholder in the open command, no concrete HTML artifact example, and slightly thin heading structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Prose is minimal and directive ("Skip the preamble and keep prose brief. Pick the smallest view that makes the key point clear.") and every example demonstrates a distinct output pattern with no padding or explanation of concepts Claude already knows; each token earns its place. | 5 / 5 |
Actionability | Concrete, imitable examples cover each visualization type (pseudocode, call tree, component tree, file tree, Mermaid, four diff shapes, full code block) plus an executable open command "Bash(open path/to/show-me-{description}.html)"; minor gaps are the placeholder filename and the absence of any HTML starter example despite an entire bullet devoted to HTML artifacts. | 4 / 5 |
Workflow Clarity | This is a simple single-purpose skill and the action is unambiguous: pick the smallest view, match the format to the topic with explicit selection criteria ("Use `diff` when the point is what changes and the surrounding shape already exists", "Show the whole block when most of it is new"), place each visual next to its text, and open HTML artifacts via Bash; no destructive or batch operations, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | Well-organized bullet structure with no nested references (none are needed at this size); minor gaps keep it from a 5 — the lone heading "### guidance" is an h3 with no parent h2, and the body is ~120 lines so the under-50-line simple-skill exception does not strictly apply. | 4 / 5 |
Total | 18 / 20 Passed |