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-built reference-and-workflow skill: highly actionable output formats and mappings, clean progressive disclosure with genuine one-level-deep reference files, and clearly sequenced workflows. The main improvements are trimming textbook knowledge Claude already has and adding output validation checkpoints to the generation workflows.
Suggestions
Remove the persona preamble and drop textbook knowledge Claude already has (the 'likelihood × impact' methodology and 'Accept | Avoid | Transfer | Mitigate' treatment options), keeping only the skill-specific column spec and treatment-workflow steps.
Add explicit validation checkpoints to the generation workflows, e.g., after generating a policy, verify all mandatory sections are present and each clause/control mapping is correct before presenting it.
Move the dated Standards Family Update (ISO/IEC 27017:2026, 27000:2026) into a clearly labeled 'Recent changes' or 'Old patterns' section so time-sensitive details stay contained.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and tabular with almost every table earning its tokens (clause deliverables, policy-to-control mappings, version differences), but it includes text Claude already knows — the persona preamble 'You are an expert ISO 27001 Lead Auditor...', the textbook 'likelihood × impact' methodology and 'Accept | Avoid | Transfer | Mitigate' treatment options — and dated news (October 2026 standards update) outside any deprecated/changes section. This matches 'efficient; minor instances of over-explanation that could be trimmed'; a 3 would require a heavier share of unnecessary explanation, and a 5 would leave nothing to trim. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: exact output schemas ('Control ID | Control Name | Status | Evidence Needed | Gap Notes'), a complete risk-register column spec, required policy sections with a document control block, a fixed control-guidance response structure, and a policy mapping table with specific IDs (e.g., A.5.15–5.18). This matches the anchor where specific examples cover the common cases; per the scoring notes, the absence of code is not penalized for instruction skills. | 5 / 5 |
Workflow Clarity | Each workflow is a clear numbered sequence, the gap analysis opens with a clarification checkpoint ('Ask for: version (2013/2022), scope of ISMS'), statuses are explicitly defined, and a mandatory documentation checklist is provided. However, no validation or self-check steps exist for generated outputs (e.g., confirming a generated policy includes all mandatory sections or that mappings are correct), and 'selected Annex A themes' is left undefined. This matches 'clear sequence with most checkpoints present; minor validation gaps'; 5 would require explicit validation steps and feedback loops. | 4 / 5 |
Progressive Disclosure | SKILL.md is a true overview and the three detailed control catalogs are correctly split into references/annex-a-2022.md, annex-a-2013.md, and control-mapping.md — all real files, verified to be one level deep with no nested references — each with a one-line description and explicit load conditions ('User asks about a specific control → load the relevant version's reference file'). This matches the clear-overview, well-signaled, one-level-deep anchor. | 5 / 5 |
Total | 18 / 20 Passed |