Content
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is lean, highly actionable, and well-structured with one-level-deep progressive disclosure. Its main weakness is workflow_clarity: the multi-step scan flow lacks explicit validation/verification checkpoints and a feedback loop for triaging findings.
Suggestions
Add an explicit verification checkpoint after scanning (e.g. 'Review results/ output; confirm exit code reflects --fail-on severity before failing CI') to close the validation gap.
Include a short scan → triage → fix → re-scan feedback loop so the workflow reads as iterative rather than fire-and-forget.
Show how to inspect a specific finding (the query ID + file:line in JSON/SARIF output) so users can act on results directly from the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — tight numbered steps with compact code blocks and one-line framing; it does not re-explain concepts Claude already knows, and nearly every token earns its place. A few editorial lines (e.g. "For most teams, this is the unique reason to use KICS alongside Checkov") are tool-specific guidance rather than padding. | 3 / 3 |
Actionability | Provides fully executable, copy-paste-ready commands (docker pull/run, kics scan flag variants, CI GitHub Action YAML) and concrete directives with real query-ID formats, matching the executable-and-complete anchor. | 3 / 3 |
Workflow Clarity | The 9 steps are clearly sequenced (Install → Run → Output → Severity → Skip → Custom queries → CI → OpenAPI → Pulumi), but there are no explicit validation checkpoints or feedback loops (e.g. verify scan output, inspect findings before acting); checkpoints are only implicit via --fail-on and CI `if: always()`. | 2 / 3 |
Progressive Disclosure | The SKILL.md spine is an overview that points via clearly-signaled links to a single one-level-deep reference (references/kics-policy.md, verified present) holding the pinned-install, full Rego template, and anti-patterns table — content is appropriately split with easy navigation. | 3 / 3 |
Total | 11 / 12 Passed |