nuxt-skills

Design inspired by HugoRCD's work

Vue, Nuxt, and NuxtHub skills for AI coding assistants.

🔗 Related Nuxt RFC: Bundling Agent Skills in Nuxt Modules

[!NOTE] Sponsored by Cactus

Your agent is working. Don't drift into YouTube. Cactus blocks distracting websites on your Mac during the hours you choose, with a schedule that repeats every week. Built by this repo's maintainer.

Try Cactus free for 7 days. Keep it for $19.99 USD, paid once. No subscription.

Other projects

• Nuxt Skill Hub: Give your coding agent Nuxt guidance tailored to your project's modules and stack.
• Vite Doctor: Catch framework bugs in Nuxt, Vue, Nitro, and Vite before code review.

Installation

npx skills add onmax/nuxt-skills

The skills CLI auto-detects your installed agents and provides an interactive picker. Use -g for global (user-wide) or -y to install all skills.

Works with Claude Code, Cursor, Codex, OpenCode, GitHub Copilot, Antigravity, Roo Code, and more.

Claude Code Marketplace

An alternative for Claude Code users:

# Add marketplace
/plugin marketplace add onmax/nuxt-skills

# Install Nuxt Skills
/plugin install nuxt-skills@nuxt-skills

Claude Code installs Nuxt Skills as one plugin and dynamically discovers all included skill entries.

Codex plugin marketplace

Install the Codex plugin from this repository's marketplace source:

codex plugin marketplace add onmax/nuxt-skills
codex plugin add nuxt-skills@nuxt-skills

See the Codex plugin manifest and marketplace source for the published metadata.

Manual Installation

Clone the repository and copy skill folders to your agent's skills directory:

Skills

The complete skill list, including provenance links for every bundled or hand-authored skill, is maintained in the generated skill catalog below.

How Skills Work

Skills follow the Agent Skills open format. They can be activated in two ways:

1. Auto-discovery — The agent reads each skill's description and loads it when relevant to your task
2. Manual invocation — Type /skill-name (e.g., /nuxt) to explicitly load a skill

Structure

Follows agentskills standard format.

nuxt-skills/
├── plugin.json             # Portable Agent Plugins manifest
├── mcp.json                # Portable Nuxt MCP configuration
├── skills/                 # Materialized manual and ecosystem skills
├── ecosystem-skills.json   # Upstream skill sources and selected paths
├── .claude-plugin/         # Claude Code manifest and marketplace metadata
└── .codex-plugin/          # Codex compatibility manifest

Automated Maintenance

Skills are kept up-to-date via GitHub Actions:

The maintenance workflow uses claude-code-action to intelligently detect breaking changes, new features, and deprecations from upstream sources.

The ecosystem bundle is configured in ecosystem-skills.json. It records the upstream repositories and skill names included in the Claude and Codex plugin. ecosystem-skills.lock.json records the exact source revisions used for each bundle.

Nuxt module skill discovery

The Nuxt-specific sources follow the discovery model used by Nuxt Skill Hub and its resolver: prefer a skill shipped by the package, then check the package's .well-known/skills publication, then use a repository path or fallback path. Configured sources live in ecosystem-skills.json; discovered sources and exact revisions are recorded in ecosystem-skills.lock.json so CI can materialize the bundle reproducibly.

Resources

VueUse maintains its own current skill, so install it directly with npx skills add vueuse/skills instead of relying on a generated copy here.

• Agent Skills Spec - Open format for extending AI agent capabilities
• Claude Code Skills - Skills in Claude Code
• VS Code Agent Skills - GitHub Copilot skills in VS Code
• GitHub Agent Skills Docs - About agent skills
• OpenCode Skills - Agent skills in OpenCode
• awesome-copilot - Community collection of custom agents and prompts

Acknowledgments

• vue skill gotchas from vuejs-ai/skills vue-best-practices (200+ rules)
• vitest and vite skills from @antfu's skills

License

MIT

Skill catalog

Every skill in the plugin is listed below with its provenance. The table is regenerated by pnpm bundle:ecosystem.