Content
92%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 well-structured, highly actionable overview for a complex four-mode skill, with concrete commands, explicit validation/feedback loops, and one-level-deep references that all resolve to real bundle files. The only weakness is moderate verbosity in the Gotchas and per-mode constraint sections that could be offloaded to the mode reference files.
Suggestions
Move some of the -w/-f-specific Gotchas entries into references/mode-whiteboard.md and references/mode-full.md so the SKILL.md overview stays leaner, since those details are only relevant when that mode is selected.
Consolidate the scattered font/color constraint statements for -f (currently split across three sections) into a single block or a reference file to reduce repetition.
Trim the longest Gotchas bullets to their core rule and link to the relevant mode file for rationale, preserving the dense instruction style while lowering token cost.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is instruction-dense and assumes Claude's competence (no basic-concept padding), but the long Gotchas list and several per-mode constraints could be trimmed or pushed into the mode reference files. It sits noticeably above the midpoint anchor but is not perfectly lean. | 4 / 5 |
Actionability | Copy-paste ready commands (bun assets/capture.ts, bun assets/prepare-whiteboard-source.ts, bun install, bunx playwright install chromium, bun run audit/test/fixtures) and concrete placeholders/data attributes ({{LOGIC_LEDGER_JSON}}, {{SOURCE_LINE}}, data-state="empty", data-source-claim) cover the common cases. | 5 / 5 |
Workflow Clarity | The numbered 共同生产线 (9 steps) provides a clear sequence with explicit validation checkpoints (wait for fonts/images before screenshot, stop on broken image, verify-full-text.ts must fail on edits, overlapping-slice QA, SHA-256 checks) and error-recovery feedback loops (up to 2 targeted regenerations before blocking). | 5 / 5 |
Progressive Disclosure | SKILL.md acts as an overview with a 必读顺序 and a mode 路由 table pointing one level deep to references/mode-*.md and assets/*_template.html; all referenced paths were verified to exist as real bundle files, and navigation is clearly signaled. | 5 / 5 |
Total | 19 / 20 Passed |