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 dense, expert-level design reference that trusts the reader and delivers unusually concrete decisions (specific glyphs, color policy, failure modes, and a real verification matrix). Its weaknesses are mild: recurring mouse guidance across sections, embedded date stamps, and a body long enough that some reference-grade tables belong in the already well-organized references/ bundle.
Suggestions
Consolidate the mouse-interaction guidance that currently spans the 'Make It Feel Modern and Clickable' table, the 'Mouse navigation'/'Mouse capture' rows in 'Input, Focus, and Editing', and two Anti-Patterns rows into a single section with short cross-references.
Move the two 'Checked 2026-09-04' date stamps into the existing 'Primary Sources' section (or a single maintenance note) so time-sensitive information is isolated from the durable guidance.
Consider relocating the Terminal Capability Policy table and the verification test matrix into a references/ file, keeping SKILL.md to the layout, interaction, and state guidance that every invocation needs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — no space is spent explaining what a TUI is or how frameworks work — but the '2026-09-04' date stamps appear twice outside any deprecated/old-patterns section, and mouse-interaction guidance recurs across 'Make It Feel Modern and Clickable', 'Input, Focus, and Editing', and two Anti-Patterns rows. These minor instances could be trimmed, matching the 'efficient; minor instances of over-explanation' anchor rather than the fully lean anchor above it. | 4 / 5 |
Actionability | For an instruction-only design skill the guidance is fully actionable: 'prefer rounded box-drawing corners (╭ ╮ ╰ ╯) over square (┌ ┐ └ ┘)', 'one cell of padding inside panels', 'Do not mix EventStream with read/poll', 'WCAG's 4.5:1 normal-text contrast', '80x24 is a useful test case', plus a concrete test matrix and named reference apps (lazygit, k9s, yazi). Per the rubric's code-vs-instruction note, absence of code is not penalized when guidance is this specific, and it is not below the anchor since common cases are covered. | 5 / 5 |
Workflow Clarity | The sections form a coherent progression — 'Choose the Layout from the Work' → interaction/inputs → 'State and Async Work' → capability policy → accessibility → rendering/lifecycle → 'Verification That Changes Confidence' — with concrete validation checkpoints ('inspect at least one real PTY session', 'verify the shell cursor and echo behavior are restored'). It is a design-concern reference rather than a sequenced build procedure, so it sits at 'clear sequence with most checkpoints present' rather than the fully explicit step/feedback-loop anchor. | 4 / 5 |
Progressive Disclosure | References are well-signaled and one level deep — 'Read [app-patterns.md](references/app-patterns.md) for examples and tradeoffs' and 'Read [visual-catalog.md](references/visual-catalog.md) when selecting glyphs' — and both files exist. However, the 176-line body inlines reference-grade material (full Terminal Capability Policy, verification matrix, anti-pattern tables) that could live in references/, so it matches 'good structure; most content appropriately placed; minor organization gaps' rather than the ideal clear-overview split. | 4 / 5 |
Total | 17 / 20 Passed |