Content
78%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 strong, highly actionable body: every mode delivers pinned, executable CI/admission snippets with verification commands and a sensible audit-first enforcement rollout. The two real weaknesses are dangling references — every mode points to `references/*.md` files that are absent from the bundle — and the absence of explicit failure-recovery loops, plus minor duplicated snippets that could be trimmed.
Suggestions
Create the missing `references/supply-chain.md` and `references/kyverno.md` (or remove the per-mode 'Reference:' pointers) — all six modes cite files that do not exist in the bundle, breaking navigation.
Move the full inline YAML (Kyverno ImageValidatingPolicy, SLSA provenance workflow) into the reference files so SKILL.md stays an overview with quick-start snippets per mode.
Add explicit error-recovery checkpoints for failures (e.g., when `cosign verify` or the Trivy severity gate fails, what to check and retry) and drop enforce-mode step 3, which duplicates the `validationActions: [Audit]` snippet already shown in the policy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is code-forward and lean — steps are directives like "Flag: always sign the digest (@sha256:…), never the tag — tags are mutable" rather than tutorials on concepts Claude knows. Minor trims remain: the digest-not-tag rule is stated twice in sign mode (step 5 and 'Key rules'), and enforce mode's step 3 re-shows the `validationActions: [Audit]` snippet already present in the policy block. Matches 'Efficient; minor instances of over-explanation that could be trimmed'; not score 5 because of this duplication, and the inline version-pinned snippets carry time-sensitive version numbers without a deprecation-style section. | 4 / 5 |
Actionability | Every mode ships executable, copy-paste-ready artifacts: pinned GitHub Actions steps (`sigstore/cosign-installer@11086d9… # v3.8.1`), a complete Kyverno ImageValidatingPolicy, and concrete verify commands (`cosign verify --certificate-identity-regexp=…`, `slsa-verifier verify-image …`). Matches 'Fully executable; copy-paste ready code or commands'; placeholders like `ghcr.io/<org>/<image>` are appropriate templating, not pseudocode, so score 3/4 anchors do not apply. | 5 / 5 |
Workflow Clarity | Each mode is a numbered sequence, the wizard gathers context before acting, and verification checkpoints exist (cosign verify after sign, severity gate that fails the build, audit-first Kyverno rollout with a Kubescape C-0237 pre-check, slsa-verifier after provenance). Matches 'Clear sequence with most checkpoints present; minor validation gaps'; not score 5 because there are no explicit error-recovery feedback loops (e.g., what to do when `cosign verify` or the Trivy gate fails) — the strongest anchor requires feedback loops for error recovery. | 4 / 5 |
Progressive Disclosure | Structure is good — six clearly-signaled modes each ending with a "Reference: references/supply-chain.md → …" pointer — but the referenced files (`references/supply-chain.md`, `references/kyverno.md`) do not exist in the bundle, so every pointer dangles and navigation is impossible. Additionally, full policy/workflow YAML (the ~30-line Kyverno policy, the SLSA workflow) is inlined where the reference files are the natural home. Matches 'Some structure but could be better organized; references present but not clearly signaled; content that should be separate is inline' — here references are clearly signaled but broken, which keeps it at the same mid-tier rather than 4 ('references mostly clear' presumes they resolve). | 3 / 5 |
Total | 16 / 20 Passed |