Content
88%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.
An excellent, highly actionable diagnostic workflow: concrete commands for every step, explicit validation checkpoints, and a real failure-mode taxonomy. Its weaknesses are modest — some rule/step redundancy and a monolithic single-file layout that could offload the taxonomy and report template to references.
Suggestions
Trim the repetition between the Rules section and Step-by-step (e.g., state fail-closed and cross-check rules once, where they are applied).
Consider moving the failure-mode taxonomy and/or the report template to a one-level-deep reference file (e.g. references/taxonomy.md) to shrink the always-loaded body.
Keep the exact jq/resume commands as-is — they are the skill's strongest asset.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and earns most of its tokens (exact jq selectors, per-CLI resume commands, a symptom-cause-fix taxonomy), but the Rules section restates content repeated in Step-by-step — fail-closed (rule 4 vs step 1), capability cross-check (rule 5 vs step 3), and quote-don't-paraphrase (rule 3 vs step 9). Not 5 because those duplications could be trimmed; not 3 because there is no generic-concept padding and every section is project-specific. | 4 / 5 |
Actionability | Fully executable guidance: copy-paste jq histogram commands for both codex and claude transcript formats, `find <run-dir> -name '*.jsonl'`, per-CLI resume commands with environment setup, and a complete verbatim report template with citation format. | 5 / 5 |
Workflow Clarity | Nine explicitly sequenced steps with validation checkpoints throughout: fail closed on a missing artefact kind, histogram printed BEFORE hypothesis formation, claim-vs-transcript cross-checking, mandatory two-copy snapshot diff, and re-derivation of the verdict to catch judge calibration drift. The skill is read-only, so the destructive-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | Clear, navigable sections (Why, Rules, Inputs, Step-by-step, taxonomy, Output template) in a single file with no buried references. Not 5 because the ~330-line body inlines the failure-mode taxonomy and the full report template — content that could sit in one-level-deep reference files; not 3 because the structure is well-organized and the split is a minor, defensible choice (both are needed on every invocation). | 4 / 5 |
Total | 18 / 20 Passed |