Content
75%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 strong, tightly written migration skill: the workflow is explicitly sequenced with required gates, per-slice CI validation, a finish gate, and a final checklist, and it consistently names exact DRF and DMR constructs rather than vague directions. The main weaknesses are moderate redundancy of the parity contract across the Policy/Rules/Checklist sections, a merely implied fix-retry loop, and most operational detail living inline rather than progressively disclosed.
Suggestions
Consolidate the repeated 'preserve X unless drift approved' statements: state the parity contract once in Migration Policy and have Translation Rules and the Output Checklist reference it instead of restating it, trimming perhaps 20-30 lines.
Make the error-recovery feedback loop explicit in the per-slice validation step (e.g., 'If linters/tests fail: fix, then re-run the same CI entrypoints before proceeding') so the workflow matches the validate-fix-retry pattern.
Move the 'Migration Pitfalls (DRF-derived)' section into references/drf-to-dmr-map.md (or a dedicated pitfalls reference) so the SKILL.md body stays a lean overview with one-level-deep, well-signaled references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and directive with zero explanation of concepts Claude already knows — every line instructs an action ('Replace `Serializer` / `ModelSerializer` transport DTO usage with explicit typed DTOs'). However, the parity contract is restated across Migration Policy, Translation Rules, and the Output Checklist ('preserve ... unless drift approved' appears ~10 times), which is more than purely minor over-explanation and could be consolidated. | 4 / 5 |
Actionability | Guidance is concrete and specific: exact DMR constructs are named (`Controller[...]`, `Body[...]`, `Query[...]`, `Path[...]`, `Headers[...]`, `Cookies[...]`, `ResponseSpec`, `validate_responses`), alongside exact DRF constructs to find and replace. Per the rubric's code-vs-instruction note, absence of code in an instruction-only skill is not penalized. It falls short of 5 because a few steps stay high-level ('inspect existing project libraries', 'run the same commands CI uses') without naming or exemplifying concrete commands. | 4 / 5 |
Workflow Clarity | The workflow is clearly sequenced (inventory DRF surface → inventory native batteries → freeze behavior → decide error strategy → migrate by slice → port auth/tests → validate per slice → finish gate) with explicit gates ('required gate', 'Do not mark slice done until linters pass, tests pass, report is updated') and a checklist. It falls short of the 5 anchor only because the fix-and-revalidate feedback loop is implied by the finish gate rather than stated as an explicit 'if validation fails, fix and re-run' step. | 4 / 5 |
Progressive Disclosure | The single bundle file (references/drf-to-dmr-map.md) is real, one level deep, and clearly signaled in the required-docs list ('Local map: [references/drf-to-dmr-map.md]'). The body is well-sectioned and navigable. It does not reach 5 because nearly all operational detail lives inline in the ~190-line SKILL.md — the Migration Pitfalls section partially duplicates the reference map and could itself be offloaded or consolidated, leaving the body closer to a true overview. | 4 / 5 |
Total | 16 / 20 Passed |