Content
92%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 tight, well-structured instruction skill: an unambiguous two-action interpretation section, a seven-step workflow with a genuine idempotency checkpoint, concrete evidence and privacy rules, and a correctly scoped one-level reference verified to exist. Only minor trimming opportunities in a few redundant lines keep it from full marks on token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is directive with zero concept-explanation padding, but a few lines could be trimmed: "Do not require the user to know the start action" restates the intent of the preceding sentence, "Treat the file as a public, evidence-based build log" repeats the description, and a few evidence principles in "Use evidence carefully" overlap the reference's field rules. It is not a 3 because nothing explains concepts Claude already knows; not a 5 because these minor tokens do not all earn their place. | 4 / 5 |
Actionability | Guidance is fully concrete and executable for an instruction-only skill: exact commands ("git rev-parse --show-toplevel"), exact paths ("references/log-format.md", "convex/convex.config.ts"), sentinel values ("not deployed", "none"), and explicit conditions covering Git vs. no-Git, start vs. update, and no-op runs. Specific rules cover the common cases. | 5 / 5 |
Workflow Clarity | The seven numbered steps are clearly sequenced with an explicit validation gate ("Check idempotency before saving... leave the file unchanged"), fallback paths (Git root vs. workspace root), and a correction loop ("If local evidence conflicts with an existing claim, keep the evidence-based value and briefly flag the correction"). The destructive/batch cap does not apply since the skill edits only hackathon.md. | 5 / 5 |
Progressive Disclosure | The body's single reference ("Read `references/log-format.md` before creating or editing `hackathon.md`") points to a real, one-level-deep bundle file, clearly signaled at the exact point of need. The split is appropriate: workflow and guardrails in SKILL.md, exact header/entry formats and the detection table in the reference, which itself opens with a Contents list for navigation. | 5 / 5 |
Total | 19 / 20 Passed |