_{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:

Agent	Project path	Global path
Claude Code	.claude/skills/	~/.claude/skills/
Cursor	.cursor/skills/	~/.cursor/skills/
Codex	.codex/skills/	~/.codex/skills/
OpenCode	.opencode/skill/	~/.config/opencode/skill/
Copilot	.github/skills/	—

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

You're working on...	Agent may auto-load...
.vue file	vue skill
server/api/ route	nuxt skill
nuxt.config.ts	nuxt skill
NuxtHub storage	nuxthub 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:

Workflow	Schedule	Purpose
update-skills.yml	Weekly (Monday)	Regenerates reka-ui docs from upstream
skill-maintenance.yml	Biweekly (1st & 15th)	Claude analyzes upstream changelogs, creates PRs if updates needed
bundle-ecosystem-skills.yml	Weekly (Monday)	Replaces configured local skills with upstream ecosystem copies, validates them, and pushes changes

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.

Skill	Provenance
arkenv	Bundled from nuxt-modules/yamcodes/arkenv
comark	Bundled from nuxt-modules/comarkdown/comark
nitro	Bundled from antfu/skills
nuxt	Bundled from antfu/skills
nuxt-better-auth	Bundled from nuxt-modules/nuxt-modules/better-auth
nuxt-content	Manually written in this repository.
nuxt-i18n	Manually written in this repository.
nuxt-modules	Manually written in this repository.
nuxt-seo	Manually written in this repository.
nuxt-studio	Manually written in this repository.
nuxt-ui	Bundled from nuxt-modules/nuxt/ui
nuxt-users	Bundled from nuxt-modules/rrd108/nuxt-users
nuxthub	Manually written in this repository.
pinia	Bundled from antfu/skills
regle	Bundled from nuxt-modules/victorgarciaesgi/regle
reka-ui	Manually written in this repository.
t3-code-continue-thread	Manually written in this repository.
unocss	Bundled from antfu/skills
vite	Bundled from antfu/skills
vitest	Bundled from antfu/skills
vue	Bundled from antfu/skills
vue-best-practices	Bundled from vuejs-ai/skills
vue-debug-guides	Bundled from vuejs-ai/skills
vue-router-best-practices	Bundled from vuejs-ai/skills
vue-testing-best-practices	Bundled from vuejs-ai/skills
vueuse-functions	Bundled from vueuse/skills