march-3-late-night/better-auth-best-practices
Configure Better Auth server and client, set up database adapters, manage sessions, add plugins, and handle environment variables. Use when users mention Better Auth, betterauth, auth.ts, or need to set up TypeScript authentication with email/password, OAuth, or plugin configuration.
100
100%
Does it follow best practices?
Impact
Pending
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 a well-crafted skill description that excels across all dimensions. It provides specific capabilities, includes natural trigger terms with product name variations, explicitly states when to use it, and is clearly distinguishable from other authentication-related skills through its focus on the Better Auth library specifically.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Configure Better Auth server and client, set up database adapters, manage sessions, add plugins, and handle environment variables.' These are clear, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what (configure server/client, database adapters, sessions, plugins, env vars) AND when with explicit 'Use when...' clause specifying trigger terms and use cases. | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'Better Auth', 'betterauth', 'auth.ts', 'TypeScript authentication', 'email/password', 'OAuth', 'plugin configuration'. Good coverage of both the product name variations and authentication concepts. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with specific product name 'Better Auth' and file reference 'auth.ts'. Unlikely to conflict with generic auth skills due to the specific library focus and naming conventions mentioned. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent skill file that demonstrates best practices: it's highly concise, uses efficient formatting (tables, bullets), provides actionable commands and config examples, and includes a clear setup workflow with verification. The 'Common Gotchas' section adds significant value by highlighting non-obvious pitfalls. External documentation is appropriately referenced rather than duplicated.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely lean and efficient - uses tables, bullet points, and terse descriptions throughout. No unnecessary explanations of concepts Claude would know; every section delivers actionable information without padding. | 3 / 3 |
Actionability | Provides concrete commands (npm install, CLI commands), specific config options with exact syntax, and clear examples. The setup workflow has copy-paste ready commands and verification steps. | 3 / 3 |
Workflow Clarity | Setup workflow is clearly numbered with explicit verification step (call GET /api/auth/ok). Includes critical reminders like 'Re-run after adding/changing plugins' and clear storage priority ordering for sessions. | 3 / 3 |
Progressive Disclosure | Well-organized with clear sections, appropriate use of tables for reference material, and explicit links to external docs for deeper information. Content is appropriately scoped for a SKILL.md overview. | 3 / 3 |
Total | 12 / 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