CtrlK
BlogDocsLog inGet started
Tessl Logo

pleaseai/better-auth

Better Auth authentication framework skills for JavaScript/TypeScript projects

75

Quality

94%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents