Content
77%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.
An exceptionally actionable, well-sequenced operational skill — copy-paste-ready code with expected outputs and thoughtful failure-mode handling in every mode. Its weaknesses are density (justification prose that should be trimmed) and progressive disclosure: the body carries detail that belongs in references/ai-governance.md, and none of the referenced bundle files actually exist in the bundle.
Suggestions
Ship the referenced bundle files (references/ai-governance.md, examples/ai-governance/evaluate.sh, examples/ai-governance/ai-governance-check.yml) or remove the instructions that depend on them — the skill currently tells Claude to read and copy files that are not present.
Move the tier-table exception, per-mode detail, and evaluator flag semantics into references/ai-governance.md, keeping SKILL.md to the wizard, mode dispatch, and the generate-critical steps.
Trim design-rationale prose (e.g., the yq-provenance paragraph, "degrades in reach, not in kind") to one-line justifications; the operational instruction survives without the editorializing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — the operational detail (jq merge semantics, bootstrap ordering, tier behavior) is non-obvious — but several passages are padded design-document rationale rather than instruction (e.g., "it degrades in reach, not in kind, without it", the extended yq-provenance justification), so it could be noticeably tightened without losing actionability. Not 2: nothing explains concepts Claude already knows; not 4: multiple paragraphs of justification prose don't earn their tokens. | 3 / 5 |
Actionability | Fully executable throughout: complete YAML policy packs, JSON hook configs, a copy-paste idempotent jq merge script, a gh api scan loop, and validation commands with expected outputs and exit codes ("exit 2 for deny"). Specific examples cover the common cases for every mode. | 5 / 5 |
Workflow Clarity | Each mode is a clearly numbered sequence with explicit validation: a Validation block with expected per-tier outputs, a stop-and-ask checkpoint for missing yq, idempotent re-run design, and an explicitly sequenced two-stage bootstrap that states the failure mode it prevents. Feedback loops are present (tune policy from check results before rollout). | 5 / 5 |
Progressive Disclosure | In-body structure is good (one clearly signaled top-level reference, one level deep, plus per-mode headers), but the referenced bundle files — references/ai-governance.md and every examples/ai-governance/ file it instructs Claude to copy — are absent from the bundle, and ~230 lines of per-mode and tier detail that the reference file should carry are inlined in SKILL.md. Not 4: dangling referenced paths are more than a minor organization gap; not 2: structure is present and the reference is clearly signaled, not buried. | 3 / 5 |
Total | 16 / 20 Passed |