Content
100%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.
Exemplary skill body: an executable four-command workflow with exit-code-driven validation and error recovery, terse hard rules that each earn their tokens, and a clean overview-to-references split where every linked file exists exactly one level deep. The single minor observation is that hooks/forensics_hint.py is named but not present in this bundle, though it is framed as plugin machinery rather than a skill reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean throughout: the motivation is six lines that establish "The rule: when a question is about something that already happened, read the trace before answering", and everything else is a runnable command block, a two-row table, terse hard rules ("No trace, no answer.", "Exit 0 of a compound line is the last command's."), and a compact scripts table. It assumes Claude's competence and explains nothing the model already knows, matching the lean-and-efficient anchor rather than the minor-over-explanation level of 4. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready commands with real flags: "python scripts/trace_finder.py --since 7d --touched config.yaml", "python scripts/trace_timeline.py --trace <path> --files", "--why 9", and "python scripts/claim_checker.py --trace <path> --claim "passed:pytest" --claim "not-edited:config.yaml"", plus per-script exit codes and universal --help/--sample/--output json. Concrete examples cover the common cases, matching the 5 anchor. | 5 / 5 |
Workflow Clarity | The workflow is a numbered 4-step sequence with per-step comments, and validation is explicit and exit-code-driven: finder exit 2 → "say the run is not recorded here. Do not reconstruct it", claim checker "Exit 4 is a contradiction: correct the account first", and "STALE means the tests passed but files changed afterwards" as an error-recovery loop. This is a read-only skill, so the destructive/batch cap does not apply, and checkpoints are explicit rather than merely present as at level 4. | 5 / 5 |
Progressive Disclosure | The body is a true overview (workflow, rules, scripts table) pointing to five clearly labeled, one-level-deep files — references/trace_sources.md, references/recorded_vs_inferred.md, references/claim_verification.md, assets/forensic_answer_template.md, assets/claims_example.txt — each with a one-line description and token count, and all five exist in the bundle with no nested references inside them. This matches the well-signaled one-level-deep anchor; the only adjacent consideration is the parenthetical mention of the plugin's hooks/forensics_hint.py, which is described as plugin behavior rather than offered as a reading reference. | 5 / 5 |
Total | 20 / 20 Passed |