Content
81%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 well-structured, actionable migration runbook with a clear gated workflow and concrete symbol-level guidance plus repo-derived pitfalls. It is largely concise and uses one-level-deep references appropriately, with only minor tightening and a missing worked DTO example holding it back from full marks.
Suggestions
Consolidate the repeated auth/throttle guidance (currently restated in Migration Policy, step 9, Translation Rules, and Pitfalls) into a single authoritative section to reduce token cost.
Add one short, complete worked DTO example showing a ninja.Schema converted to a DMR typed DTO (Body/Query split) to lift actionability from concrete-symbol to copy-paste-ready.
Pull the repo-derived Migration Pitfalls into references/ninja-to-dmr-map.md (or a dedicated pitfalls file) so the SKILL.md body stays an overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean, imperative lists assuming Claude's Django/ninja knowledge with no padded concept explanations; minor repetition of auth/throttle guidance across Policy, step 9, Translation Rules, and Pitfalls could be tightened. | 4 / 5 |
Actionability | Provides concrete symbols and commands (Body[...], Query[...], Controller[...], ResponseSpec, validate_responses, modify(error_handler=...), ratelimit.core.ALL, strict=False, extra='forbid') with specific pitfalls, though no complete copy-paste DTO example is included. | 4 / 5 |
Workflow Clarity | Clear 12-step numbered sequence with explicit validation checkpoints and gates ("required gate", step 11 CI validation, step 12 Finish gate requiring linters/tests/report), and feedback loops (fix-and-revalidate) for a destructive/batch migration. | 5 / 5 |
Progressive Disclosure | Body is an overview that clearly signals one-level-deep required docs (DMR LLM docs URL and the real references/ninja-to-dmr-map.md), with most detail appropriately inline for the skill's scope; minor organization gaps remain. | 4 / 5 |
Total | 17 / 20 Passed |