Content
100%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 exemplary instruction-only skill body: a concrete, validated four-step workflow with copy-paste commands, one-level-deep references verified to exist, lean prose with no padding, and explicit handling of edge cases (pre-0.13 releases, non-breaking releases, unresolved prompt items). The reporting section closes the loop with a defined output format.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~76-line body is lean and dense: it never explains concepts Claude already knows (what Django, REST, or a lock file is) and every sentence carries task-specific guidance — 'Do not guess how an API changed', 'Never skip a release', 'Releases in between that are not listed had no breaking changes'. The version numbers in the table are file-navigation metadata, not time-sensitive API advice, so they do not warrant the staleness penalty. | 5 / 5 |
Actionability | Nearly every instruction is copy-paste ready: `uv pip show django-modern-rest`, `pip show django-modern-rest`, lock-file names to check, the PyPI URL, `python manage.py check`, `python manage.py dmr_export_schema <schema-path>`, the version-specific `llms.txt` URL pattern, and a table mapping each release jump to its exact prompt file. The few un-parametrized steps ('install it', 'search the project for every symbol named in the prompts') are dynamic by nature rather than gaps. | 5 / 5 |
Workflow Clarity | A clear four-step sequence (find versions → bump → apply prompts oldest-first → verify) with a dedicated Verify section that runs the type checker, tests, `manage.py check`, a schema diff, and a residual-symbol search with an explicit completion criterion ('the upgrade is complete when none is left'). It also batches edits one release at a time for reviewability and defines a stop-and-ask rule when a prompt item conflicts with desired project behavior — feedback loops and checkpoints well beyond the anchor-4 bar. | 5 / 5 |
Progressive Disclosure | The body is a pure overview and navigator; the three per-release migration prompts live in references/ and are surfaced via a table of well-signaled one-level-deep links. All three linked files exist and contain the actual migration prompts, so the split is real and easy to navigate. | 5 / 5 |
Total | 20 / 20 Passed |