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 skill is a rigorous, internally consistent behavioral contract with a genuinely well-structured references bundle, but it is delivered as a dense ~500-line formal monograph rather than an operational skill file. Redundant restatement of the same invariants, abstract axiom-based direction in place of worked examples, and a workflow the reader must reassemble from scattered sections hold it to the middle of the scale.
Suggestions
Move the Lean formal contract to a references file (e.g. references/contract.md) and keep in SKILL.md only the operational summary — the flow, the invariants once, and the user-facing realization — cutting the body to a fraction of its current size.
Add one worked example: a sample classification relay and a rendered frame map / round offer in everyday language, so the abstract rules ("targets", "the map", "the offer") are grounded in concrete output the model can pattern-match.
Consolidate the invariants currently repeated in FLOW, MORPHISM, axiom doc comments, and Rules into a single list, and present the run's step sequence as one numbered walkthrough with the decision points (taking, fresh invocation, non-bearing turn) as explicit checkpoints.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a ~500-line monolith in which the same invariants ("never eliminates, ranks, or scores") are restated across FLOW, MORPHISM, axiom doc comments, Rules, and Known Limitations, and the Definition carries literature-review padding ("Runco & Acar, 2012", "Wadinambiarachchi et al., 2024") plus a Lean formal block whose prose commentary duplicates the Protocol section. It does not explain concepts Claude already knows, so not a 1, but several sections are noticeably padded and redundant — anchor 2. | 2 / 5 |
Actionability | Concrete guidance exists — "read `references/blank-entry.md` before presenting it", "read `references/seeded-entry.md` before the first pass", "present continue first and 'Take this field as it stands' second" — but the bulk is a formal contract whose axioms are "yours to judge", with no worked example of a relay, a rendered map, or a round's offer. Some concrete guidance, incomplete — anchor 3; not 4 because the operational core is buried in abstract formalism rather than executable direction. | 3 / 5 |
Workflow Clarity | A sequence is present (FLOW: "start: the records `reference` names, read → the classification relay → Blank: … → the map"; the `ideate` definition's Taken/Invoked/Reaches decision branches) but it is scattered across the formal block, PHASE TRANSITIONS, Protocol, and Rules with no consolidated step list, and checkpoints (relay correction, map completeness, the taking gate) are implicit rather than stated as verification steps. Anchor 3 — sequence present but checkpoints missing or implicit; not 4 because the multi-step process requires reassembly by the reader. | 3 / 5 |
Progressive Disclosure | The bundle structure is genuinely good — all three references exist, are one level deep, and are clearly conditionally signaled ("read `references/round-composition.md` before composing when a term's rendering has to hold across the session") — but the entire ~500-line Lean formal block is inlined in SKILL.md when it is exactly the deep-detail material that belongs in a reference file, matching the anchor's "content that should be separate is inline." Not 4 because most of the body's mass is misplaced relative to a lean overview; not 2 because the references that do exist are well organized and never nested. | 3 / 5 |
Total | 11 / 20 Passed |