Content
86%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 tight, well-structured instruction-only skill: it separates content from runtime, gives precise field-level contracts, a decision workflow with validation steps, and a thorough verification program, all in lean prose. The main gaps are the absence of a concrete example definition/schema and explicit error-recovery loops after validation failures.
Suggestions
Add a minimal example enemy definition (inline or in a references/ file) showing the authored-content schema and one move entry, so the field lists have a concrete template to follow.
In the 'Add a new enemy' workflow, make the feedback loop explicit: on validation failure, fix the definition and re-validate before proceeding to proof.
Name the concrete validation/playthrough commands or scripts (e.g., how to run the deterministic fixtures and the browser playthrough) rather than only describing what to verify.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative throughout — e.g., "Never mutate authored definitions, store live timers in content, or duplicate the combat clock across AI, animation, and rendering" — with zero background exposition of concepts Claude already knows and no padded sections. Every line adds domain-specific constraints, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Guidance is concrete and executable in intent: exact field lists ("stable ID, AI tags, eligibility range/angle/line-of-sight, weight, and state prerequisites"), a numbered decision workflow, and specific test categories. However, there is no example content definition, schema snippet, or command — an instruction-only skill is not penalized for lacking code, but a minimal example definition and a concrete validation/playthrough command would close the gap to fully actionable. | 4 / 5 |
Workflow Clarity | "Add a new enemy" is a clear 5-step decision sequence with explicit validation checkpoints (step 4 "Validate references, timing, contact, cooldown, recovery, interrupts, and feedback hooks"; step 5 "Add deterministic fixtures and automated tests, then run desktop and mobile playthroughs"), and "Prove the system" is a verification checklist. It falls short of the top anchor because no error-recovery feedback loop is stated — what to do when content validation rejects a definition (fix and re-validate) is implied but not explicit. | 4 / 5 |
Progressive Disclosure | There are no bundle files (references/, scripts/, assets/ do not exist), and none are needed: the ~53-line body is compact, well-sectioned, and contains no bulk material (long API tables, extended examples) that clearly belongs in a separate file. Per the simple-skill guidance, well-organized sections with no external-reference need satisfy the top anchor. | 5 / 5 |
Total | 18 / 20 Passed |