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.
An executable, well-sequenced protocol with strong validation feedback loops and clean progressive disclosure into real reference files. Its only weak dimension is conciseness, dragged slightly by overall length and a few repeated emphases.
Suggestions
Consolidate the 'never edit generated/ by hand' rule to a single authoritative statement; the rule currently recurs in Phase 5, Common Pitfalls, and the description, and repeating it inflates length without adding clarity.
Tighten the empty-class-body (`: ...` vs `pass`) pitfall: lead with the actionable takeaway (verify the generated file imports cleanly when overriding a synthetic class) and move the 9-file enumeration and codegen.py internals into a reference file.
Dedupe the e2e `-k` keyword guidance, which appears in both Phase 6/Phase 7 tables and the Common Pitfalls list; a single canonical keyword-rules table would cut repetition.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with genuinely non-obvious operational knowledge (patchgen decorators, OpSlots, NPU KERNEL_REGISTRY gaps, empty-class-body syntax quirks) and assumes Claude's competence rather than restating known concepts, but its ~750-line length and some repetition (the 'never edit generated/' rule stated 3+ times, the verbose empty-class-body pitfall) leave minor trimming room. | 4 / 5 |
Actionability | Provides copy-paste-ready bash commands, executable PatchConfig/register-pattern code skeletons, concrete file paths, and specific test tables to append to, covering the common cases for GPU/NPU and dense/MoE/VLM/Omni variants. | 5 / 5 |
Workflow Clarity | A clear Phase 0–8 sequence carries explicit Validation checkpoints (end of Phase 1, Phase 2, Phase 5), Phase 7 acceptance criteria, and Phase 8 review-gate feedback loops (safe/needs-attention/risky plus the patchgen --check --fix and pytest --collect-only error-recovery paths). | 5 / 5 |
Progressive Disclosure | SKILL.md is a well-signaled spine with a capability-routed navigation table pointing one level deep to references/model-examples.md, moe.md, and multimodal.md (all present with the referenced sections), keeping category-specific bulk out of the spine and saving ~380 lines for simple text-only dense models. | 5 / 5 |
Total | 19 / 20 Passed |