Content
63%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.
The body delivers genuinely actionable assessment machinery — pinned-version citation rules, control statuses, severity timelines, a complete evidence format, and two gated workflows — without teaching known concepts. Its weaknesses are redundancy (a duplicated capability-summary comment block and thrice-stated fix-prompt rules) and a progressive-disclosure structure whose ~20 referenced files are absent from the bundle, leaving all detailed templates and checklists unreachable.
Suggestions
Remove the CAPABILITIES_SUMMARY/COLLABORATION HTML comment block (duplicates body content) and consolidate the fix-prompt suppression rules, currently stated three times, into the single LLM Fix Prompt Generation section.
Ship the referenced bundle files (reference/*.md including compliance-templates, legal-document-checklists, fix-prompt-generation, and the _common/*.md contracts) or inline the essential templates — currently every deferral points to a file that does not exist in the bundle.
Move the time-sensitive Standards Categories version table (2025/2026-dated pins like CIS Controls v8.1 and OWASP Agentic Applications 2026) into a dated reference file so stale pins don't live in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids explaining known concepts and uses dense tables, but it carries real redundancy: the 32-line CAPABILITIES_SUMMARY comment block (lines 6-37) duplicates body content, fix-prompt suppression rules are stated three times (Core Contract, Output Requirements, LLM Fix Prompt Generation), and the Standards Categories and Output Routing tables overlap. Mostly efficient but noticeably tightenable; sits at the 3/2 boundary. | 3 / 5 |
Actionability | Concrete, executable guidance throughout for an instruction-only skill: control statuses (Implemented/Partial/Missing/N/A), severity timelines (Critical 24-48h, High 1 week), the full evidence-format string, a citation example ("OWASP Top 10:2025 A03", not "OWASP Top 10"), and a subcommand dispatch list. Not 5 because no worked example of a finding or fix prompt is shown — examples are deferred to reference files that are absent from the bundle. | 4 / 5 |
Workflow Clarity | Two clearly sequenced phase-table workflows (SCOPE→MAP→ASSESS→EVIDENCE→VERIFY→PRESENT and LEGAL_SCOPE→...→SUGGEST) with explicit gates ("No assessment before scope", "Assertions are not evidence", "A remediation closes after retest"), Ask-First checkpoints, and trigger tables with "ask only when" conditions. Not 5 because there is no in-run error-recovery loop when a phase fails, and runtime citation verification is asserted as a rule without a mechanism. | 4 / 5 |
Progressive Disclosure | References are clearly signaled (Read columns, Reference Map, read-trigger tables) — better than anchor 3's "not clearly signaled" — but the bundle contains no files at all: every referenced reference/*.md and _common/*.md path is dangling, the Reference Map adds an index-of-references indirection level, and time-sensitive version tables are inlined in SKILL.md rather than in a dated reference. Good structure undermined by unverifiable targets and organization gaps. | 3 / 5 |
Total | 14 / 20 Passed |