Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with clear workflows and concrete schemas, but it is verbose — heavy on philosophical justification and anecdotes — and monolithic, with no progressive disclosure despite its length. The specialized operational content is strong; the surrounding prose and structure could be tightened and split.
Suggestions
Trim explanatory philosophy and anecdotes ('Why most RAID logs fail', the Sibelius case, 'Levy's principle', the BLUF origin) to the operative rules; assume Claude already understands general risk-management concepts.
Move the four IRAD field-structure tables and the risk-identification category lists into reference files (e.g. references/irad-schema.md, references/risk-categories.md) linked one level deep, leaving SKILL.md as a tighter overview.
Consolidate the repeated output-format guidance (BLUF/IRAD ordering appears in Step 3, Step 4, and the Output format section) into a single authoritative section to reduce redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~460-line body carries genuine specialized guidance (field schemas, signal taxonomies, lifecycle rules) but is padded with explanatory philosophy and anecdotes Claude does not need — 'Why most RAID logs fail', the Sibelius project case, 'Levy's principle', and the US-military BLUF origin. Not level 3 because much prose restates risk-management concepts a competent model already knows; not level 1 because the core operational content is specific and useful rather than abstract filler. | 2 / 3 |
Actionability | Provides concrete, copy-ready guidance: explicit field tables for Issues/Risks/Assumptions/Decisions, ID conventions (I-/R-/A-/D-), enumerated status values, output ordering, and worked examples of decision/scope/risk language. Not level 2 because the instruction is specific and executable rather than pseudocode or vague direction; absence of code is fine for an instruction-only skill. | 3 / 3 |
Workflow Clarity | Multi-step process is clearly sequenced (Steps 1–4 across three modes) with explicit checkpoints: the materiality test, the risk→issue transition test, the 'Did someone with authority make a choice' decision test, and the 'confirm the full picture — ask what's missing' closure step. Not level 2 because validation/confirmation gates are explicit rather than implied. | 3 / 3 |
Progressive Disclosure | No bundle files exist (references/scripts/assets absent) and the entire ~460-line skill is a single monolithic SKILL.md with no one-level-deep references; field schemas and category taxonomies that could live in separate files are inline. Not level 3 because the simple-skill exception (under 50 lines) does not apply and nothing is split out; not level 1 because sections are well-organized and navigable rather than a disorganized wall of text. | 2 / 3 |
Total | 10 / 12 Passed |