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.
An exemplary project-contract skill: dense with non-obvious invariants, precise identifiers, and explicit anti-patterns, closing with a concrete validation checklist. The only gaps are the absence of any sequenced change workflow with a fix-and-retry loop and of copy-paste-ready code examples for common edits.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense with project-specific invariants Claude cannot know (ghostHash seeding rules, pathZForRow/pathXForCol contracts, override semantics, world[][] as single source of truth); it assumes competence, teaches no general concepts, and every section carries non-obvious constraints. Not 4 because no section contains over-explanation that could be trimmed — even the rationale lines (e.g. why the reveal cache would lie on nondeterminism) encode project-critical consequences. | 5 / 5 |
Actionability | Concrete, executable-by-name guidance throughout: exact function signatures and responsibilities (ghostCellAt, getGhostNeighbors, applyToolToCell), the exact cell schema "{ terrain, kind, floors, buildingType, fenceSide, extras }", and precise density formulas like "(h % 100) < 30 → -1". Per the code-vs-instruction note the absence of code is not penalized, but it stops short of 5 because there are no copy-paste-ready snippets or worked examples for the common change cases. | 4 / 5 |
Workflow Clarity | The doc is a constraint contract rather than a step sequence, but it closes with an explicit, checkable Validation section (pan east for continuous strips, pan away and back for identical regen, bridge rendering, home-board isolation) that serves as verification checkpoints. Not 5 because there is no sequenced workflow for making a change (which helpers to touch first, order of operations) and no fix-and-retry feedback loop around the validation checks; not 3 because validation is explicit and concrete, not merely implied. | 4 / 5 |
Progressive Disclosure | A single self-contained file with well-organized, clearly headed sections covering one coherent subsystem; no bundle files exist and none are needed at this size, so per the simple-skill guidance well-organized sections alone merit full credit. Navigation is easy — sections are scannable and the 'Don't' and 'Validation' sections are prominently separated. | 5 / 5 |
Total | 18 / 20 Passed |