Content
42%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 an ambitious formal contract whose operational core — a checked map of understanding, rounds grounded in cited material, person-only closure — is sound and even elegant, but it is buried in ~390 lines of Lean scaffolding that duplicates the prose rules several times over. The executable guidance that exists is specific yet delivered without a single worked example, and the whole formal apparatus should live in a reference file rather than the main body.
Suggestions
Move the Lean block to references/contract.md (or similar) and keep SKILL.md to the operational prose: activation conditions, the round/map structure, the verification rules, and a pointer to the formalism for occasions that need it.
Add one worked example — a short sample target, the first-round map with 2-3 aspects, a fact with its cited material, and the person's reading — so the round format is copy-paste-imagined rather than inferred from a 500-word sentence.
De-duplicate the repeated judgments (acknowledgment-is-not-a-reading, only-a-person-closes, no-recording) by stating each once and cross-referencing, and break the `.present` grounding entry into discrete, scannable rules.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~430 lines, of which roughly 390 are an inlined Lean 4 formal block whose axiom doc comments repeatedly restate judgments that also appear in FLOW, MORPHISM, TOOL GROUNDING, and the Rules section (e.g. "an acknowledgment of your explanation is acceptance, not the person's own reading" appears at least four times). Anchor 2 fits: several padded and redundant sections; it is not anchor 1 because it does not explain concepts Claude already knows — the redundancy is bespoke rather than filler — and not anchor 3 because the duplication is pervasive, not occasional. | 2 / 5 |
Actionability | There is genuinely specific guidance — "cite concrete locations in the target — file and line where it is code", checks write to "a scratch space outside the target's tree", contradictions must show "their words quoted; the narrowest material... never your own explanation" — but no worked example or template of an actual round or map, and the central instructions are compressed into a single ~500-word run-on sentence in the `.present` entry. Anchor 3 fits: some concrete guidance but incomplete, with key details (what output looks like) missing. | 3 / 5 |
Workflow Clarity | The sequence (gather → check → map → present → fuse → close) is present in the FLOW and MORPHISM comments and encoded in `grasp`/`start`, and a feedback loop exists (checks run before rounds, results return through `consult`), but it is implicit: the reader must reverse-engineer the Lean formalism, and no explicit ordered steps or checkpoints are laid out for the executor. Anchor 3 fits; not 2 (the sequence is complete, not gappy) and not 4 (checkpoints are implicit rather than "most present"). | 3 / 5 |
Progressive Disclosure | The body has clear section headers and one well-signaled, one-level-deep reference (`references/round-composition.md`, a real file with explicit when-to-read conditions), but roughly 90% of the content — the Lean formal contract — is inlined in SKILL.md where it belongs in a separate reference file. Anchor 3's "content that should be separate is inline" matches exactly; not 2 because the structure is not minimal and the reference is not buried, and not 4 because the inlining is wholesale rather than a minor gap. | 3 / 5 |
Total | 11 / 20 Passed |