nuxt-test-skill

The nuxt-test-skill is a specialized development and validation component within the npm-agentskills ecosystem. It serves as a reference implementation for library authors who wish to bundle AI-assisted context, documentation, and coding patterns directly into their npm packages for consumption by AI coding agents such as Claude Code, GitHub Copilot, and Cursor. This skill demonstrates the structural requirements for defining agent-specific metadata, including the necessary SKILL.md file and supplemental reference documentation.

By providing a controlled environment for testing, this skill enables developers to verify that their Nuxt module configuration correctly discovers and exports internal skill directories during build processes like nuxi prepare or nuxi dev. It is intended primarily for package maintainers and framework contributors who need to ensure seamless compatibility across multiple AI development tools. Users can leverage this test setup to confirm that their API documentation, architectural patterns, and boilerplate code are accurately indexed and made available to LLM-powered IDE extensions, thereby enhancing the developer experience and reducing context-switching friction.

• Validates automated discovery of agent skills within node_modules for Nuxt-based projects.

• Demonstrates the use of agent-specific metadata in package.json to trigger export processes.

• Provides a template for organizing skill documentation via references/ subdirectories.

• Ensures cross-agent compatibility for platforms including Claude, Cursor, and Goose.

• Supports debugging of manifest generation and file synchronization workflows.

• Ensure your project is using the npm-agentskills/nuxt module in your nuxt.config.ts file to trigger automatic discovery.

• Use the npx agents list command to verify that the test skill is correctly registered by the CLI.

• Check the .claude/skills/ or .cursor/skills/ directories post-execution to confirm that documentation files are exported to the target agent environments.

• Maintain the structure of the SKILL.md file with standard frontmatter to ensure parsing success by the core agent-skills engine.

• Be aware that this skill is strictly for validation purposes and should not be used as a production-level dependency in user-facing applications.