Content
52%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 shows unusual discipline in its reference structure — every bundle file is real, condition-triggered, and one level deep — and its dialogue flow is specified with genuine branching precision. But the body buries this in a monolithic 535-line Lean specification that restates its core invariants four or more times and offers no executable commands or worked examples, making it verbose and only partially actionable.
Suggestions
Consolidate the four restatements of the flow (FLOW, MORPHISM, PHASE TRANSITIONS, LOOP) and the repeated invariants ('index gist is a cue, never evidence', 'took place, not that it still holds') into a single statement each, cutting the body to a fraction of its current size.
Add one worked example of a round and a close (cue in, story with citations out, identification, RecalledContext emitted) so the abstract contract is anchored to concrete input/output behavior.
Move the full Lean type definitions (Origin, Turn, Cite, Coord, Occ, Reach, SourceScan, etc.) into a reference file loaded on demand, keeping only the FLOW summary and the operational rules in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body restates the same invariants many times over — "an index's gist is a cue and supports nothing" appears in the MORPHISM block, the ClaimSupported axiom, the grounding table, and the Source-grounded recognition rule, and "knowing it took place, not that it still holds" is repeated across the FLOW, RecalledContext, presentation, and rules sections. The 535-line Lean contract plus four prose restatements of the same flow (FLOW, MORPHISM, PHASE TRANSITIONS, LOOP) is heavily padded relative to what an executing model needs, though it does not explain concepts Claude already knows. | 2 / 5 |
Actionability | There is concrete guidance — the condition-triggered reference-loading sequence ("read its realization reference (references/claude.md or references/codex.md)"), a failure-mode taxonomy with recognizable triggers ("FalseAnchor — an identifier matched, and its record is not the one meant"), and an explicit presentation checklist — but the operational core is a Lean specification whose axioms are declared "black boxes to the contract, yours to make", and the body contains no executable commands or worked example of a round. This is pseudocode-level guidance with key execution details deferred, matching the anchor for some concrete but incomplete guidance. | 3 / 5 |
Workflow Clarity | The FLOW block gives an explicit branching sequence (pass reads the cue, runs searches, opens the leading recognizable, then presents / asks / closes unresolved) and classifies every subsequent utterance (identified / Elsewhere / Reaches / session answers), with checkpoints for scope reports, dissent, and capture qualification. It falls short of anchor 5 because error recovery is deferred to references and the actual sequence must be assembled from four separate restatements rather than one explicit validated workflow. | 4 / 5 |
Progressive Disclosure | All seven reference files referenced in the body exist in references/ and each is loaded under an explicit condition ("read references/supra-session.md before joining records into it", "read references/fork-resume.md before emitting its handle"), one level deep, with scripts reachable via capture-outcome.md. However SKILL.md itself is a ~43KB monolith carrying the full Lean contract inline rather than a concise overview, which is more than a minor organization gap and keeps it below the clear-overview anchor. | 4 / 5 |
Total | 13 / 20 Passed |