Content
73%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, comprehensive security audit skill with clear multi-phase workflows, explicit validation loops (re-audit deltas), and concrete output formats. Its main strengths are the detailed fix-loop with user interaction options and the structured handoff ritual. Minor weaknesses include some verbosity in workflow integration details that could be consolidated and a few audit phases that lack inline executable examples, relying instead on external reference files that weren't provided for verification.
Suggestions
Remove the Keywords block at the bottom—trigger keywords belong in frontmatter only and waste tokens in the body.
Consider adding a brief inline example of a CWE grep pattern in the SAST phase rather than deferring entirely to the reference file, so the skill is partially self-contained.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient for its complexity but includes some sections that could be tightened—e.g., the 'When to run' section states obvious triggers, the Keywords block at the end is redundant with frontmatter, and some workflow integration details (sync-status, flow.py commands) are repeated or could be referenced rather than inlined. However, it avoids explaining basic concepts Claude already knows. | 3 / 5 |
Actionability | The skill provides concrete finding formats, specific CLI commands (npm audit --json, pip-audit, flow.py commands), exact file paths for output, a structured fix-loop with user prompts, and canonical commit messages. Minor gaps exist—e.g., the SAST phase says 'grep and analyze code per CWE patterns' without showing specific grep patterns inline (deferred to a reference file), and some phases lack executable examples of what the analysis looks like in practice. | 4 / 5 |
Workflow Clarity | The workflow is exceptionally well-sequenced across audit phases (1-6), a fix-loop (Steps 1-7) with explicit validation (re-audit in Step 4 with delta reporting), a feedback loop (loop until resolved or user aborts), user decision points (Step 2 options A-D), and a structured handoff ritual. The consistency-check at Step 7 serves as a final validation checkpoint. Destructive/batch operations (fixing findings) include verification via re-audit. | 5 / 5 |
Progressive Disclosure | The skill references external files well—CWE patterns, OWASP checklists, OWASP LLM checklist, audit template, backlog template, team-workflow, and project-conventions. References are one level deep and clearly signaled in the phase table. Minor gap: no bundle files were provided to verify these references exist, and some referenced paths (like templates/AUDIT-TEMPLATE.md) could benefit from brief inline descriptions of what they contain. The skill itself is appropriately sized for an overview without inlining reference content. | 4 / 5 |
Total | 16 / 20 Passed |