CtrlK
BlogDocsLog inGet started
Tessl Logo

nuxt-users

Configure and use the nuxt-users module for Nuxt. Use when adding authentication, user management, roles, password reset, database setup (SQLite/MySQL/PostgreSQL), or CLI commands (migrate, create-user). Covers nuxt.config (nuxtUsers), composables (useAuthentication, useUsers, usePublicPaths, usePasswordValidation, useNuxtUsersLocale), components (NUsersLoginForm, NUsersLogoutLink, etc.), and authorization (whitelist, permissions).

63

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/nuxt-users/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is an efficient, highly actionable module reference — concrete commands, config keys with defaults, and a troubleshooting table — with a clear setup sequence. Its main weaknesses are the absence of validation checkpoints around the batch database operations (migrate/create-user) and file references that point to paths missing from the bundle, leaving the skill a single inlined file rather than an overview with well-grounded references.

Suggestions

Add verification steps to the initial-setup workflow after the batch database operations, e.g. after 'npx nuxt-users migrate' note how to confirm the migrations table exists, and after create-user show how to verify the user can authenticate — this lifts workflow clarity above the destructive/batch-operation cap.

Fix or remove the file references: '../../docs/user-guide/getting-started.md' and sibling paths do not exist in the skill bundle; either ship those docs as reference files inside the skill (e.g. references/configuration.md) or drop the local-path pointers in favor of the canonical docs URL.

Add a short code example for step 6 (using NUsersLoginForm with @success and login(user) in a page), matching the executable style of the other setup steps, and drop the generic 'guard clauses and early returns' closing advice.

DimensionReasoningScore

Conciseness

The body is dense module-specific reference material (install commands, config table with defaults, composable signatures) with no explanation of concepts Claude already knows — nothing teaches what Nuxt or authentication is. Minor trims are possible: the 'Legacy/table creation' CLI commands partially duplicate migrate, and the closing line 'use guard clauses and early returns when implementing custom auth logic' is generic advice that earns no tokens. Not a 5, but clearly above the midpoint.

4 / 5

Actionability

Mostly copy-paste-ready guidance: 'npm install nuxt-users', 'npx nuxt-users migrate', 'npx nuxt-users create-user -e admin@example.com -n "Admin User" -p password123 -r admin', a concrete nuxt.config permissions example, and a symptom→fix troubleshooting table. Not a 5 because step 6 ('Use login in a page') is described only in prose ('Use the NUsersLoginForm component and handle @success by calling login(user)') without the code example the other steps provide.

4 / 5

Workflow Clarity

The initial-setup sequence is clear and well-ordered (install → register → migrate → create-user → configure permissions → use login) with executable commands at each step, but the workflow contains batch database operations ('npx nuxt-users migrate', create-user) with no validation or verification checkpoints in the flow — there is no step to confirm the migration ran or the user was created. The troubleshooting table offers symptom→fix recovery, but verification is only implicit, and the guideline caps workflows involving batch/destructive operations without validation steps at 3.

3 / 5

Progressive Disclosure

The body is well-sectioned (setup, config reference, CLI, composables, components, troubleshooting, file references) but the bundle contains only SKILL.md: no references/, scripts/, or assets/ exist, and the 'File references' section points to '../../docs/user-guide/getting-started.md' and similar paths that do not exist in the bundle, plus a commit-pinned GitHub URL. The ~40-row config reference table and composable/component API listings are inlined in full rather than split into reference files, so structure and reference signaling are only partially realized.

3 / 5

Total

14

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that explicitly states both what the skill does and when to use it, with concrete module-specific trigger terms (migrate, create-user) and named APIs. The only weaknesses are generic lead verbs and broad auth-related trigger terms that create minor overlap risk with general authentication skills.

DimensionReasoningScore

Specificity

The description lists several concrete capability areas ('adding authentication, user management, roles, password reset, database setup (SQLite/MySQL/PostgreSQL), or CLI commands (migrate, create-user)') and names specific APIs (useAuthentication, NUsersLoginForm). Not a 5 because the lead verbs 'Configure and use' are generic, and the trailing 'etc.' and 'Covers ...' enumeration describe surface names rather than concrete actions with minor gaps in coverage.

4 / 5

Completeness

Both questions are explicitly answered: the 'what' is 'Configure and use the nuxt-users module for Nuxt' with enumerated coverage areas (nuxt.config, composables, components, authorization), and the 'when' is a concrete trigger list: 'Use when adding authentication, user management, roles, password reset, database setup (SQLite/MySQL/PostgreSQL), or CLI commands (migrate, create-user)'. This matches the anchor-5 example pattern of a clear what plus explicit 'Use when...' triggers.

5 / 5

Trigger Term Quality

Good natural-keyword coverage: 'authentication', 'user management', 'roles', 'password reset', 'migrate', 'create-user' are phrases a user of this module would naturally say. A few common variations are missing (e.g., 'login', 'sign in', 'auth', 'user accounts'), so it falls just below the comprehensive-with-synonyms anchor of 5.

4 / 5

Distinctiveness Conflict Risk

The skill is pinned to a clear niche ('the nuxt-users module for Nuxt', named composables and NUsers* components), but its trigger terms 'authentication', 'roles', and 'password reset' are broad and could also fire for general auth-implementation tasks or other Nuxt auth skills, giving minor overlap risk rather than the minimal risk of anchor 5.

4 / 5

Total

17

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
onmax/nuxt-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.