nuxt-production

| Nuxt 4 production optimization: hydration, performance, testing with Vitest, deployment to Cloudflare/Vercel/Netlify, and v4 migration. Use when: debugging hydration mismatches, optimizing performance and Core Web Vitals, writing tests with Vitest, deploying to Cloudflare Pages/Workers/Vercel/Netlify, or migrating from Nuxt 3 to Nuxt 4.

Quality

82%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Quality

Content

64%

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

This is a comprehensive, highly actionable Nuxt 4 production guide with excellent executable code examples across hydration, performance, testing, deployment, and migration. Its main weaknesses are redundancy (hydration issues covered in 3-4 places), excessive inline detail that contradicts its own progressive disclosure strategy (detailed sections inline despite referencing separate files), and missing validation checkpoints in deployment and migration workflows.

Suggestions

Move the detailed hydration fix patterns, performance optimization, testing, and deployment content into the referenced files (hydration.md, performance.md, etc.) and keep only quick-reference summaries in the main SKILL.md to reduce redundancy and honor the progressive disclosure structure.

Add validation/verification steps to the deployment workflow (e.g., 'verify build output exists', 'test deployed URL returns 200') and migration workflow (e.g., 'run tests after each step', 'verify dev server starts after moving files').

Consolidate the duplicated hydration content—the causes table, fix patterns, common anti-patterns, and troubleshooting sections all cover the same material. Pick one canonical location.

Dimension	Reasoning	Score
Conciseness	The skill is fairly comprehensive but includes some redundancy—hydration mismatch causes are covered in both a table, fix patterns section, common anti-patterns, AND troubleshooting. The 'What's New in Nuxt 4' section with version features adds bulk that may become stale. Some sections like the anti-patterns repeat earlier content nearly verbatim.	2 / 3
Actionability	Excellent actionability throughout—every section provides executable code examples with correct syntax, specific CLI commands, complete config files, and concrete patterns. The testing section includes full test files, the deployment section has complete configs, and the migration guide has step-by-step commands.	3 / 3
Workflow Clarity	The migration from Nuxt 3 section has clear sequential steps which is good. However, the deployment workflow lacks validation checkpoints (no 'verify the build succeeded' or 'test the deployment' steps). The troubleshooting section is a flat list rather than a diagnostic workflow. No feedback loops for deployment failures beyond generic advice.	2 / 3
Progressive Disclosure	The 'When to Load References' section clearly signals four reference files (hydration.md, performance.md, testing-vitest.md, deployment-cloudflare.md), which is good progressive disclosure design. However, no bundle files are provided, so these references don't actually exist. Additionally, the main file is quite long (~400+ lines) with substantial inline content that overlaps with what the referenced files should contain—the hydration, performance, testing, and deployment sections are all detailed inline despite having dedicated reference files.	2 / 3
	Total	9 / 12 Passed

Description

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 strong skill description that clearly defines its scope around Nuxt 4 production optimization. It lists specific concrete capabilities, includes an explicit 'Use when' clause with natural trigger terms, and occupies a distinct niche that minimizes conflict risk. The description is concise yet comprehensive, using proper third-person voice throughout.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: hydration debugging, performance optimization, testing with Vitest, deployment to specific platforms, and v4 migration. These are clearly defined capabilities.	3 / 3
Completeness	Clearly answers both 'what' (hydration, performance, testing, deployment, migration) and 'when' with an explicit 'Use when:' clause listing five specific trigger scenarios.	3 / 3
Trigger Term Quality	Excellent coverage of natural terms users would say: 'hydration mismatches', 'Core Web Vitals', 'Vitest', 'Cloudflare Pages', 'Workers', 'Vercel', 'Netlify', 'migrating from Nuxt 3 to Nuxt 4'. These are all terms developers would naturally use when seeking help.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive with a clear niche: Nuxt 4 production-specific concerns. The combination of Nuxt 4, specific deployment targets, Vitest, and migration from Nuxt 3 makes it very unlikely to conflict with other skills.	3 / 3
	Total	12 / 12 Passed

Validation

81%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 9 / 11 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (660 lines); consider splitting into references/ and linking	Warning
metadata_field	'metadata' should map string keys to string values	Warning

	Total	9 / 11 Passed

Repository: secondsky/claude-skills
Commit: 5e92b71

Reviewed: about 2 months ago

Table of Contents

Discovery Implementation Validation

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.