Content
87%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, highly actionable reference whose only gap is workflow framing — it presents practices as a checklist rather than a sequenced process with explicit verification checkpoints.
Suggestions
Frame the rules as a short sequenced workflow with an explicit verification checkpoint, e.g. 'Before commit: run ggshield/truffleHog; if a secret is found, rotate it and re-scan before proceeding.'
Add one copy-paste happy-path example (e.g. a python-dotenv or Vault retrieval snippet) to complement the anti-pattern snippet.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean set of bullets with no padding or explanation of concepts Claude already knows; every line earns its place, matching the score-3 anchor. | 3 / 3 |
Actionability | It names concrete tools (python-dotenv, AWS Secrets Manager, Vault, 1Password CLI, ggshield, truffleHog, git-secrets), gives copy-paste gitignore entries, and a concrete anti-pattern code snippet, providing actionable guidance for an instruction-style skill. | 3 / 3 |
Workflow Clarity | Rules are numbered and a detect→rotate loop is implied (Scanning plus rule 5), but it reads as a parallel checklist rather than a sequenced process with explicit validation checkpoints, so it does not reach the score-3 anchor. | 2 / 3 |
Progressive Disclosure | The skill is under 50 lines, needs no external references (no bundle files exist), and is organized into clear sections (Rules, Scanning, Anti-patterns), satisfying the simple-skill allowance for a 3. | 3 / 3 |
Total | 11 / 12 Passed |