Content
85%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 exceptionally well-crafted instruction skill: concrete scripts, verbatim message templates, decision tables, feedback loops, and hard gates make the conversational workflow fully executable, and the body stays lean despite covering a complex multi-stage process. The one real defect is bundle integrity — the two files the body delegates to (builder-check-prompt.md, visual-companion.md) are missing, and the visual-companion scripts in scripts/ have no surviving entry point from SKILL.md.
Suggestions
Ship the missing builder-check-prompt.md and visual-companion.md alongside SKILL.md, or repoint those references to real files — currently the builder check and the visual companion are unusable as written.
Reference the scripts/ bundle from SKILL.md (e.g. in the visual-companion section: server start/stop via scripts/start-server.sh, scripts/stop-server.sh) so the five script files are discoverable.
Trim the motivational opening paragraph and the 'waterfall, very fast' aside — they explain context Claude can infer — to push conciseness toward lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious behavioral instruction (message composition rules, the ~200-300 char paraphrase spec, three-bucket question triage, size-judgment table) and mostly assumes competence rather than teaching basics. Minor padding could be trimmed — the motivational opening ("你非常擅长构建……这个'认为'通常比你感觉到的要单薄") and asides like "智能体做事是瀑布式的,只不过非常、非常快" — so anchor 4 ('efficient; minor instances of over-explanation') fits better than 5. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is copy-paste ready: the first message is specified as exactly two items in order with a quoted skip-offer, the visual-companion proposal is given verbatim ("要我打开一个浏览器标签页,放几个原型给你看吗?"), concrete question scripts are provided ("带我走一遍上一次……的经过"), a decision table maps work sizes to next steps, and the design doc path is fully specified (docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md). Per the rubric's code-vs-instruction note, absence of code is not penalized when guidance is this concrete; anchor 5 fits. | 5 / 5 |
Workflow Clarity | The full lifecycle is clearly sequenced — first message → question loop with coverage areas → alternating paraphrase-back with confirmation → size judgment → written design → builder check → HARD-GATE → writing-plans — with explicit validation checkpoints and feedback loops: each paraphrase ends by asking "哪里不对或漏了什么", the builder check is a validation pass with a triage protocol and one bounded round of follow-up questions, and the danger-signals table plus HARD-GATE act as checklists. Anchor 5 ('explicit validation steps; feedback loops; checklists') matches; not 4 because no significant checkpoint is missing. | 5 / 5 |
Progressive Disclosure | The SKILL.md itself is well-sectioned and its references are clearly signaled and one level deep, but scored against the actual bundle both referenced paths are broken: "用本目录下的 builder-check-prompt.md 派发一个全新的子代理" and "先阅读本目录下的 visual-companion.md" point to files that do not exist in the bundle, and the five files in scripts/ (server.cjs, start-server.sh, stop-server.sh, helper.js, frame-template.html) are never referenced from SKILL.md at all. Navigation fails at exactly the delegation points, so anchor 3 ('some structure; references present but problematic') fits; not 4 because runtime navigation to referenced files is broken, and not 2 because the body itself is not monolithic and the split into a lean overview plus detail files is the right design in principle. | 3 / 5 |
Total | 17 / 20 Passed |