Content
75%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.
A highly actionable, well-organized security reference: concrete executable patterns for every rule, explicit validation tooling, and a closing checklist. Its main cost is length — dated incident history and guard implementation details are inlined in SKILL.md rather than split into reference files, which hurts token efficiency and progressive disclosure.
Suggestions
Move the 2026-04-29/2026-04 incident history and the four guard-allowlist/opt-out enumerations into a references/guards.md file, keeping only the rule and the guard name in SKILL.md.
Place dated, time-sensitive information in an explicit 'old patterns' or 'deprecated' section (or drop the dates in favor of the current rule) so it does not age the skill.
Tighten the SSRF and Same-Origin sections to rule + one code example, trimming explanatory prose around the mechanics (DNS rebinding, redirect hops) that the code comments already cover.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence (no re-explanation of what XSS or SQL injection are) and mostly earns its tokens with project-specific rules, but it carries inline time-sensitive material — 'On 2026-04-29 the previous one-arg resolveCredential…', 'the 2026-04 cross-tenant leak class', 'MCP 2026 hosts' — outside any old-patterns/deprecated section, plus long incident narratives and guard-allowlist enumerations that could be tightened. Not 4 because the dated history and guard minutia are noticeable padding that could move to a reference file. | 3 / 5 |
Actionability | Every rule ships copy-paste-ready executable code: defineAction with Zod schema, parameterized Drizzle/SQL, ssrfSafeFetch with options, resolveCredential with request context, getSession/401 handlers, accessFilter/runWithRequestContext route pattern, authorize and needsApproval examples. Runnable verification commands ('pnpm action db-check-scoping', 'pnpm prep' guards) and bad/good code contrasts cover the common cases. | 5 / 5 |
Workflow Clarity | The custom-routes section gives a clear numbered 1-2-3 sequence, a closing checklist consolidates the rules, and CI guards plus db-check-scoping provide validation checkpoints. Not 5 because there are no explicit validate-fail-fix-retry loops, and the multi-section rule layout (appropriate for this reference-style skill) is not a single sequenced workflow. | 4 / 5 |
Progressive Disclosure | Well-organized single file with clear section headers and clearly signaled one-level-deep pointers to related skills ('storing-data', 'actions', 'authentication') and spec files; no bundle files exist so everything is inline. Not 5 because at ~340 lines the guard-allowlist details and historical incident notes are content that could split into reference files, keeping the core rules leaner; not 3 because navigation is easy and references are explicit, not buried. | 4 / 5 |
Total | 16 / 20 Passed |