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 content encodes an unusually rigorous behavioral contract — the closing, standing, set-aside, and overturn semantics are specified more precisely than most dialogical skills — but at severe cost to readability and token efficiency. The Lean block duplicates the prose protocol, no worked example grounds the abstractions, and the workflow must be reverse-engineered from code. Moving the formalism to a reference and adding one concrete example sheet would lift most dimensions.
Suggestions
Move the ~550-line Lean formal block to references/formal-spec.md, keep a concise prose contract plus the FLOW summary in SKILL.md, and cite it under load conditions the way round-composition.md is cited.
Add one worked example: a short dialogue with two or three cases, one rendered sheet (goal, candidate, cross-view rows, cases section, doubts, open points, move), and the resulting recognition trace.
Rewrite the Protocol prose into a scannable numbered sequence (activation → first sheet → per-turn reading → recognition/close) with the checkpoints (Reaches, ClosingSupported, Overturned) called out at the step where they apply.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~595 lines, dominated by a ~550-line Lean formal block whose rules are restated in the prose Protocol section ('The sheet', Mode Activation, Rules), producing substantial duplication; sentences like 'Then the cross view, one row per live reading, a merge you drew beside the readings it merges...' pack multiple clauses into nearly unreadable constructions throughout. This matches 'Noticeably verbose; several unnecessary explanations or padded sections'. Not score 1, because it never explains concepts Claude already knows — every part is bespoke to this protocol. | 2 / 5 |
Actionability | There is concrete guidance in the Protocol section — the sheet layout is specified ('Then the goal: what the abstraction is for... Under it, the working candidate — a name and a rule —') and the move structure is described — but the Lean block's operative content is axiom doc comments ('Every `axiom` is one of those judgments — a black box to the contract'), and no worked example of a sheet or dialogue is ever shown. This matches 'Some concrete guidance but incomplete; missing key details'. Not score 4, because without a single rendered example an implementer cannot execute the guidance confidently; not score 2, because the sheet and move composition are specified in structured, specific detail. | 3 / 5 |
Workflow Clarity | A real sequence exists (FLOW block: start → notActivated → sheet per utterance → crystallized/holding, plus Mode Activation, Protocol, and the seam/converge entries) and internal checkpoints are defined (notActivated, Reaches, ClosingSupported, Overturned), but the sequence is scattered across a Lean structural recursion, comment blocks, and prose, requiring the reader to reconstruct it. This matches 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit'. Not score 4, because the sequencing is implicit in code rather than presented as a followable workflow; not score 2, because the flow is coherent and the recognition/overturn checks are explicit. | 3 / 5 |
Progressive Disclosure | The single bundle reference, references/round-composition.md (a real 15-line file), is well signaled with explicit load conditions ('Read `references/round-composition.md` before composing when terminology must remain stable, wording must be carried unchanged...') and is one level deep — but ~550 lines of Lean formalism are inlined in SKILL.md where the prose contract already covers usage, matching 'Some structure but could be better organized; content that should be separate is inline'. Not score 4, because the bulk of the content is a monolithic inline block rather than an overview pointing to detail; not score 2, because headings and a clearly signaled reference do provide navigable structure. | 3 / 5 |
Total | 11 / 20 Passed |