Content
81%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 highly actionable with executable code and clear, validated workflows for risky database operations. The main weakness is a moderate amount of concept-explaining prose and inlined advanced detail that could be offloaded to reference files for better token efficiency.
Suggestions
Trim rationale prose that explains well-known concepts (e.g., the thundering-herd and circuit-breaker-state explanations) to one-line justifications, since Claude already knows these.
Move the full circuit-breaker, rate-limit, and alternate better-sqlite3 stack implementations into the references file, keeping only the decision rule and a minimal snippet inline.
Type the middleware signatures (req, res, next) and resolve the undefined verifyAccessToken so the auth code is fully copy-paste executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and largely efficient with executable code and decisive guidance, but includes some rationale prose explaining concepts Claude largely knows (thundering herd, circuit-breaker states, RLS rationale) that could be trimmed. | 4 / 5 |
Actionability | Multiple copy-paste-ready code blocks (Prisma schema, Zod validators, middleware, better-sqlite3 repos, circuit breaker) covering common cases, with minor gaps like untyped (req, res, next) and undefined verifyAccessToken. | 4 / 5 |
Workflow Clarity | Auth flow is numbered and migrations include an explicit zero-downtime checklist with a validation checkpoint (UP in staging → verify coexistence → DOWN → verify → promote), providing strong feedback loops for destructive/db operations. | 5 / 5 |
Progressive Disclosure | Good section structure with a real, one-level-deep, clearly signaled reference (references/idempotencia-e-postgres-avancado.md), though substantial detailed code (circuit breaker, rate limiting, services, alternate stack) is inlined in SKILL.md that could live in references. | 4 / 5 |
Total | 17 / 20 Passed |