Content
78%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 high-quality, heavily action-oriented body: executable code for every provider, a validated multi-step workflow with feedback loops for Better Auth, and dense version-specific knowledge with no filler. Its one structural weakness is that a ~530-line, four-provider skill keeps all detail inline in SKILL.md instead of splitting per-provider guides into reference files.
Suggestions
Move per-provider detail into one-level-deep reference files (e.g., references/clerk.md, references/better-auth.md, references/vercel-primitives.md), keeping SKILL.md as the decision matrix plus a short setup per provider.
Relocate time-sensitive material — the "Clerk Core 3 Breaking Changes (March 2026)" list and version pins — into a clearly labeled migration/deprecated reference file so the main body stays version-stable.
Add explicit verification steps to the Clerk, Descope, and Auth0 sections (analogous to Better Auth's GET /api/auth/ok check) so every provider workflow has a checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and code-first with essentially no explanation of concepts Claude already knows — it spends tokens on non-obvious, version-specific facts ("ClerkProvider must be inside <body>", "VERCEL_URL is not read automatically", "signToken is deprecated"). A few sentences could still be trimmed (e.g., the Better Auth intro paragraph restates positioning already in the description), which keeps it just below the lean 5 anchor. | 4 / 5 |
Actionability | Nearly everything is copy-paste ready: install commands ("npm install better-auth pg", "vercel integration add clerk"), complete proxy.ts and route-handler code, env-var blocks with generation hints ("<openssl rand -base64 32>"), migration commands ("npx auth@latest migrate"), and a symptom/cause/fix mistake table. Specific examples cover the common cases across all four providers, matching the 5 anchor. | 5 / 5 |
Workflow Clarity | The Better Auth "Agent Workflow" is an 8-step numbered sequence with explicit validation and feedback loops ("Verify GET /api/auth/ok returns { "status": "ok" }", "run a sign-up → sign-in → getSession() pass", "Re-run migrate after every plugin change"), so the destructive/batch cap does not apply. However, only that provider has checkpoints — the Clerk, Descope, and Auth0 sections are reference-style with no verification steps, which is a minor validation gap placing this at 4 rather than 5. | 4 / 5 |
Progressive Disclosure | The skill is a single ~530-line SKILL.md with no references/, scripts/, or assets/ files, so per-provider setup guides, the plugin table, and the Clerk Core 3 breaking-changes list are inlined where a multi-provider skill of this size should split them into one-level-deep reference files. Section headers, the decision matrix, and the cross-reference list ("⤳ skill: routing-middleware") give it real structure and clearly signaled links, which keeps it above the 2 anchor, but the content-that-should-be-separate-is-inline pattern matches the 3 anchor. | 3 / 5 |
Total | 16 / 20 Passed |