Content
75%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-organized advisory-skill body: information-dense, free of padding explanations, and rich in concrete numbers, thresholds, and decision rules rather than generic advice. The main weaknesses are duplicated keyword/reasoning sections, quick-start commands pointing at scripts absent from the bundle, and reference paths that don't resolve to real files.
Suggestions
Remove the "Keywords" section — it duplicates trigger terms already in the frontmatter description and adds no body value — and fold the "Reasoning Technique" paragraph into the Risk Quantification section.
Ensure the referenced bundle files (references/security_strategy.md, references/compliance_roadmap.md, references/incident_response.md, scripts/risk_quantifier.py, scripts/compliance_tracker.py) actually ship with the skill, or replace the Quick Start commands with self-contained inline examples.
For the most common requests (e.g., "assess our security posture"), add a short numbered end-to-end workflow — read company-context → build risk register → quality loop → output — so the main flow doesn't have to be assembled from scattered sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense with non-derivable, role-specific judgment (metric targets, vendor tier cadences, red flags) and no explanations of concepts Claude already knows. Not 5 because the "Keywords" section duplicates the frontmatter description's trigger terms and "Reasoning Technique: Risk-Based Reasoning" largely restates the Risk Quantification section — tokens that could be trimmed. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: the ALE formula with board phrasing, sequenced compliance timelines ("SOC 2 Type I (3–6 mo) → SOC 2 Type II (12 mo)"), a numeric budget example ($200K program / $2M breach / 40% / $800K expected value), tiered vendor assessment cadences, and copy-paste Quick Start commands. Not 5 because the Quick Start commands reference scripts/risk_quantifier.py and scripts/compliance_tracker.py which are not present in the bundle, leaving the runnable entry point unverifiable. | 4 / 5 |
Workflow Clarity | Clear sequences within sections (identity → network segmentation → data classification; SOC 2 Type I → Type II → ISO/HIPAA), a request→artifact mapping table, and an explicit verification checkpoint pattern ("Self-verify... Peer-verify... Critic pre-screen" plus "Always read company-context.md before responding"). Not 5 because the main advisory flows are never laid out as an end-to-end numbered workflow with recovery guidance; not 3 because checkpoints are explicit, not merely implied. | 4 / 5 |
Progressive Disclosure | Good structure: overview-level body with clearly signaled one-level-deep references ("See `references/security_strategy.md`" inline plus a dedicated "Detailed References" section) and appropriately split detail. Not 5 because none of the referenced files — references/security_strategy.md, references/compliance_roadmap.md, references/incident_response.md, the two scripts, or ../agent-protocol/SKILL.md — exist in the staged bundle, so every pointer dangles and navigation breaks in practice. | 4 / 5 |
Total | 16 / 20 Passed |