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.
An excellent operational skill: executable copy-paste commands for every tool it covers, a clearly sequenced workflow with the key trap (never let the renderer run the command) front and center, and properly bundled scripts that are real and well-signaled. The only trims available are minor: the motivational prose in "Why this exists" and the one-time install instructions could be tightened or deferred.
Suggestions
Compress the "Why this exists" section to one or two sentences — the motivation is already implied by the description and the method section.
Consider moving the "Installing freeze" setup details (tap vs. go install, GOPROXY/GOSUMDB troubleshooting) into a short reference file or collapsing to the two bare install commands plus one fallback sentence, since installation is a one-time concern.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every line is non-obvious operational knowledge Claude cannot be assumed to have — the non-TTY color-dropping trap, the `freeze --execute` degradation, the wrong brew cask, `GOSUMDB=off` for firewalled installs, background-matching. Anchor 4 rather than 5 because the "Why this exists" section and a few rhetorical flourishes ("Reading hex values is guessing", "that separation is the whole trick") are motivational prose that could be compressed to one sentence without losing operational content. | 4 / 5 |
Actionability | Fully executable throughout: a copy-paste table of per-tool capture commands, a complete worked delta example, the exact wrapper invocation `scripts/render_ansi.sh <input.ansi> <output.png> [background_hex]`, a command to discover the real background hex, and two concrete install paths. This matches anchor 5's copy-paste-ready commands covering the common cases. | 5 / 5 |
Workflow Clarity | A clear two-step sequence (capture to `.ansi`, then render and read) with the one critical rule emphasized up front, a full end-to-end example, and an explicit verification step ("Read /tmp/diff.png and judge whether add/remove contrast is clear"). The pitfalls section maps failure symptoms to fixes (clipped output → widen `--window-size`; freeze uninstallable → documented fallback; dark theme on light page → use real background), giving genuine feedback loops. Not a destructive/batch operation, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | Good structure: both bundled scripts exist on disk, are correctly offloaded (render and ANSI-parsing logic live in `render_ansi.sh`/`ansi2html.py`, not inline), and are indexed in a "Bundled scripts" section with one-level-deep, well-signaled references. Anchor 4 rather than 5 because the one-time "Installing freeze" section (~15 lines of setup and firewall troubleshooting) is inline content that only runs once and could be deferred to a reference, keeping SKILL.md centered on the core capture-render workflow. | 4 / 5 |
Total | 18 / 20 Passed |