Content
70%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 is well-organized with a clear, validated workflow and concrete stack detection, but it depends on two reference files (checks.md, patterns.md) that are absent from the bundle, which breaks both actionability of the core audit and the progressive-disclosure structure.
Suggestions
Ship the missing references/checks.md and references/patterns.md files in the bundle so the core audit checks (SEC-01, DB-07, etc.) and their scan patterns are actually available.
Inline at least one or two representative check definitions with their regex/grep patterns in SKILL.md so the skill remains actionable even before the reference files are loaded.
Verify every referenced path in the body (references/checks.md, references/patterns.md) resolves to a real file, and use markdown link syntax so broken references are obvious.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete detection rules and a compact categories table, though the full 25-line example SHIP GATE REPORT and the lengthy detection block could be trimmed slightly; no padding of concepts Claude already knows. | 4 / 5 |
Actionability | The body gives concrete, executable stack-detection rules and a clear process, but the core check definitions (SEC-01, DB-07, etc.) are delegated to references/checks.md and references/patterns.md, which are not present in the bundle — leaving the central executable guidance incomplete. | 3 / 5 |
Workflow Clarity | A clearly sequenced four-step process (Detect Stack, Run Automated Checks, Manual Confirmation, Verdict) with an explicit verdict validation gate, a fix-and-re-run feedback loop, a manual confirmation checklist, and per-category progress reporting. | 5 / 5 |
Progressive Disclosure | The overview is well-structured and references are clearly signaled ("Full check details in references/checks.md", "using the patterns in references/patterns.md"), but those referenced files do not exist in the bundle, so the one-level-deep disclosure points to missing content and navigation fails. | 3 / 5 |
Total | 15 / 20 Passed |