Content
17%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.
The body is a persona prompt, not a usable skill: it catalogs capabilities and traits at length but provides zero executable guidance, no validation checkpoints, and its single pointer to detail targets a nonexistent file. It needs to be rebuilt around concrete code, commands, and real reference files.
Suggestions
Replace the capability/trait/knowledge catalogs with concrete, executable guidance: example model/serializer/view code, migration commands, pytest-django test snippets, and Celery/Channels setup commands.
Fix the broken reference — either create 'resources/implementation-playbook.md' with the detailed patterns or remove the pointer; move the capability and integration catalogs into that reference file.
Turn the 'Response Approach' into a real workflow with validation checkpoints (e.g., run migrations check, run test suite, verify with DRF test client) instead of abstract step labels.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Roughly 170 lines are spent enumerating capabilities, behavioral traits, and a knowledge base that largely restate what a competent model already knows about Django, and the Purpose section repeats the persona sentence verbatim — noticeably verbose with several padded sections, though it never lapses into extended concept explanations. | 2 / 5 |
Actionability | There is no code, command, or concrete step anywhere in the body; instructions like 'Clarify goals, constraints, and required inputs. Apply relevant best practices and validate outcomes.' are entirely abstract, describing rather than instructing. | 1 / 5 |
Workflow Clarity | The 'Response Approach' section provides a rough 8-step sequence ('Analyze requirements' → 'Suggest Django-idiomatic solutions' → 'Provide production-ready code'), but the steps are abstract labels with no validation checkpoints or error-recovery guidance, matching 'rough sequence present but many gaps; validation absent'. | 2 / 5 |
Progressive Disclosure | The only reference, 'resources/implementation-playbook.md', does not exist in the bundle (no references/, scripts/, assets/, or resources/ directories), and a large inline catalog of capabilities and integrations is exactly the content that belongs in separate files — minimal structure with inlined content and a broken reference. | 2 / 5 |
Total | 7 / 20 Passed |