Content
86%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 advisory skill body: executable Quick Start commands, concrete formulas and worked examples, explicit sequencing, and clean progressive disclosure to real one-level-deep references. The only improvement areas are trimming the duplicated Keywords section and the restated risk-based reasoning section, and adding explicit validation/recovery checkpoints to the IR workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and efficient — tables, formulas, tier definitions, and a two-command Quick Start with no padding or explanations of concepts Claude already knows. Minor trim opportunities: the 'Keywords' section duplicates the frontmatter description, and 'Reasoning Technique: Risk-Based Reasoning' restates the ALE framing already covered in sections 1 and 5 — 'minor instances of over-explanation that could be trimmed' rather than every token earning its place. | 4 / 5 |
Actionability | Copy-paste-ready commands ('python scripts/risk_quantifier.py', 'python scripts/compliance_tracker.py'), an explicit formula (ALE = SLE × ARO), a worked dollar example ('$200K program preventing a $2M breach at 40% annual probability has $800K expected value'), concrete vendor tiers with assessment cadences, and an Output Artifacts table mapping common requests to specific deliverables. For an instruction/advisory skill this is fully actionable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | Multi-step processes are explicitly sequenced (SOC 2 Type I (3–6 mo) → Type II (12 mo) → ISO 27001/HIPAA; identity → network segmentation → data classification), and the Internal Quality Loop plus confidence tagging serves as an output validation checkpoint. It falls short of anchor 5 because error-recovery loops and per-step checkpoints are not explicit — e.g., the IR workflow delegates to the reference without inline validation steps. | 4 / 5 |
Progressive Disclosure | A clear overview body with all detailed material appropriately split into real, one-level-deep bundle files — references/security_strategy.md, compliance_roadmap.md, incident_response.md and the two scripts all exist and none reference further nested documents (verified). References are well signaled both inline ('See references/...' in each section) and in a consolidated 'Detailed References' section, and the Quick Start points directly to the scripts — easy navigation throughout. | 5 / 5 |
Total | 18 / 20 Passed |