Content
7%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is essentially a table of contents with no substantive content. It lacks any concrete code examples, specific security patterns, executable guidance, or clear workflows. The main file delegates everything to sub-skill files that aren't provided, while filling space with redundant descriptions and generic instructions that don't leverage Claude's existing knowledge.
Suggestions
Add at least 3-5 concrete, executable code examples of common security patterns (e.g., input validation, parameterized queries, JWT verification) directly in the main SKILL.md so it provides immediate value.
Replace the generic instructions ('Apply relevant best practices and validate outcomes') with specific, sequenced workflows for common tasks like 'securing an API endpoint' or 'implementing authentication', including validation checkpoints.
Remove redundant sections (duplicate purpose statements, when-to-use/not-use boilerplate, the empty 'Capabilities' header) to improve conciseness.
Add brief summaries next to each sub-skill link describing what specific guidance each contains, so the main file serves as a useful overview rather than just a link list.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is verbose and redundant. It explains when to use/not use the skill in generic terms, restates the purpose multiple times, explains the difference between this skill and a security auditor (context Claude doesn't need), and includes a 'Purpose' section that largely repeats the description. The 'Capabilities' header is empty. Much of this is padding that doesn't add actionable value. | 1 / 3 |
Actionability | There is no concrete code, no executable examples, no specific commands, and no actionable security patterns. The instructions are entirely abstract ('Apply relevant best practices and validate outcomes'). The skill delegates everything to sub-skill files without providing any immediately usable guidance in the main file. | 1 / 3 |
Workflow Clarity | There is no clear workflow or sequenced process. The four bullet points under 'Instructions' are generic platitudes ('Clarify goals, constraints, and required inputs') with no specific steps, validation checkpoints, or feedback loops for security-critical operations. | 1 / 3 |
Progressive Disclosure | The skill does reference 10 sub-skill files and a resources/implementation-playbook.md, which shows an attempt at progressive disclosure with one-level-deep references. However, no bundle files were provided to verify these exist, the main file contains almost no substantive content of its own, and the 'Capabilities' section is just a list of links with no overview content to orient the reader. | 2 / 3 |
Total | 5 / 12 Passed |