Better Auth authentication framework skills for JavaScript/TypeScript projects
75
94%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly identifies the specific library (better-auth), enumerates concrete capabilities across APIs, frameworks, plugins, and DB adapters, and provides explicit trigger guidance with both contextual scenarios and keyword lists. It uses proper third-person voice and is well-structured without unnecessary verbosity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: answering questions about better-auth APIs, wiring up sign-in/sign-up/sessions, integrating framework adapters (with specific frameworks named), adding plugins (with specific plugins named), and configuring DB adapters (with specific adapters named). | 3 / 3 |
Completeness | Clearly answers both 'what' (answer questions about better-auth, help build authentication features) and 'when' with an explicit 'Use when developers...' clause covering five numbered scenarios, plus a dedicated 'Triggers on' list with specific keywords. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms including API names ('betterAuth', 'authClient', 'auth.api.*'), user-facing concepts ('sign in flow', 'auth session', 'social login', 'magic link', 'passkey'), framework names, and the library name itself. These are terms developers would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive by targeting a specific library ('better-auth') with its unique API surface ('betterAuth', 'authClient', 'auth.api.*') and specific plugin names ('organization plugin', 'oauth-proxy'). Unlikely to conflict with generic auth skills or other library-specific skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, well-structured skill that provides actionable guidance for working with better-auth. Its greatest strengths are the clear workflow from discovery through implementation, the comprehensive tables for quick lookup, and the well-organized progressive disclosure to reference files. Minor verbosity in a few sections prevents a perfect conciseness score, but overall the content is highly effective.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient and well-structured, but includes some unnecessary explanation (e.g., explaining where `betterAuth` lives in the source tree, the note about `create-context.ts` and `utils/url.ts` for env vars, and some verbose phrasing like 'Missing or misconfigured values are the single most common source of runtime errors'). The tables are dense and useful, but a few sections could be tightened. | 2 / 3 |
Actionability | The skill provides fully executable bash commands for discovery, concrete TypeScript code for server and client setup, specific import paths per framework, and exact CLI commands for schema generation and migration. The guidance is copy-paste ready and covers the full workflow from installation through debugging. | 3 / 3 |
Workflow Clarity | The skill presents a clear sequential workflow: verify installation → find docs via `ask` → set up env vars → server setup → client setup → pick adapter → pick plugins → pick DB adapter → regenerate schema → handle errors. It includes validation checkpoints (typecheck after changes, verify plugin names before generating code, check common-errors.md before deep debugging) and explicit fallback paths when tools are unavailable. | 3 / 3 |
Progressive Disclosure | The skill provides a concise overview with well-organized tables and canonical patterns inline, then clearly signals four one-level-deep reference files (adapters.md, plugins.md, databases.md, common-errors.md) for detailed information. The references section is clean and each reference has a clear description of what it contains. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Reviewed
Table of Contents