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 well-structured instruction skill: a clear sequenced workflow with verification gates and posting approval, concrete verdicts and record contracts, and executable detail correctly split into one-level-deep reference files that exist in the bundle. The only real cost is mild redundancy between the principles section and the numbered sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, assumes competence, and never explains basics Claude already knows, but there is measurable redundancy: the "What matters" principles are restated across sections 1, 6, and "Tone", and lines like "The gap between your model and theirs exposes anchoring in both directions" are framing rather than instruction. Not score 5 (every token does not earn its place) and not score 3 (there is no unnecessary explanation or padding of known concepts). | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully actionable: an exact record path (`.mastracode/scratch/issues/<owner>-<repo>-<n>.md`), a closed verdict taxonomy with literal strings, branch-name patterns to infer the issue, per-branch deeper checks, and executable commands one level deep in `references/recipes.md` pointed to at each step. Not score 4 because there are no minor gaps — the common cases (resolve issue, trace symptom, history, regression, probe, posting) are all covered concretely. | 5 / 5 |
Workflow Clarity | A clear six-step sequence (build model → read thread → diagnose → history → verify → decide and brief) with explicit validation checkpoints: falsification-based verification, "Never claim a reproduction you did not run", an approval gate for posting ("Show the draft; wait for the go"), and a re-investigation loop. The destructive/outward-facing operation (GitHub posting) has validation, so no cap applies. | 5 / 5 |
Progressive Disclosure | The body is an overview and all executable detail lives one level deep in the existing `references/recipes.md` and `references/templates.md`, each clearly signaled at the exact point of use ("Resolve the issue with the minimal recipe in `references/recipes.md`", "Use `references/templates.md` as an example, not a schema"). Not score 4 because there is no inline content that should have been split out and navigation is unambiguous. | 5 / 5 |
Total | 19 / 20 Passed |