Content
81%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.
A strong, rigorous workflow body: fully actionable instructions, a clearly sequenced process with explicit verification and honest-failure feedback loops. The main cost is token efficiency — triple-stated extraction lists and repeated defaults make it noticeably longer than the task requires — and a ~230-line monolith that could split detail into a reference file.
Suggestions
Merge the "Inputs" section into Step 1 so the claim/assumptions/notation/sketch extraction list appears once instead of three times across Inputs, Step 1, and Step 2.
State the PROOF_PACKAGE.md default and STATUS enum once in the Constants section and reference them from Steps 1, 3, and 5 rather than restating them.
Move the required file structure template and the mathematical rigor requirements into a references/ file (e.g., references/proof-package-template.md), keeping SKILL.md as a lean workflow overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | No time is wasted explaining concepts Claude already knows, but the same extraction list (claim, assumptions, notation, sketch) is repeated nearly verbatim in "Inputs", "Step 1: Gather Proof Context" ("Extract: exact claim, assumptions, notation, proof sketch"), and again in "Step 2: Normalize the Claim" ("Restate: the exact claim being proved, all assumptions, all symbols"). The PROOF_PACKAGE.md default is also stated three times (Constants, Step 1, Step 5); a tightening pass could cut ~25-30% of lines, which is more than the "minor instances" of the anchor-4 example. | 3 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: a copy-paste-ready required file structure template, an enumerated STATUS constant, named proof strategies, explicit math formatting rules ("use $...$ for inline math and $$...$$ for display equations", "never use 'clearly', 'obviously'..."), and three fully-specified output modes. Not score 4 because no key execution detail is missing for the common cases. | 5 / 5 |
Workflow Clarity | The six steps are clearly sequenced (gather → normalize → triage → dependency map → write → verify) with an explicit validation checklist in Step 6 ("verify: the theorem statement exactly matches what was actually shown... every inequality direction is correct") and a feedback loop: "If a key step still cannot be justified, downgrade the status and write a blockage report instead of forcing a proof". Step 3's feasibility triage adds an early checkpoint, matching the anchor-5 pattern of sequence + explicit validation + error-recovery loop. | 5 / 5 |
Progressive Disclosure | The body is well-sectioned and its one external pointer (the Lean route invoking ../lean-formalize/SKILL.md) is clearly signaled with explicit triggering conditions and an anti-recursion rule. Not score 5 because at ~230 lines with no bundle files, sizable self-contained blocks (the file-structure template, rigor requirements, output modes) stay inline where a reference file would keep SKILL.md a leaner overview; not score 3 because structure and navigation are genuinely good with nothing buried. | 4 / 5 |
Total | 17 / 20 Passed |