vue
Vue 3 Composition API, components, composables. Use when editing .vue files, writing reactive code, or encountering ref, computed, watch, defineProps errors.
Summary
This skill provides expert guidance on Vue 3 Composition API, including components, composables, and reactive patterns.
- It helps developers write idiomatic Vue code using ref, computed, watch, and script setup, and troubleshoot common errors like defineProps issues.
Overview
[!WARNING]
This repo may be replaced by nuxt-skill.onmax.me. Stay tuned.
[!TIP]
Debug Vite issues with Vite Doctor.
<p align="center"> <img src="https://raw.githubusercontent.com/onmax/nuxt-skills/main/.github/nuxt-skills.webp" alt="Nuxt Skills" width="100%"> <br> <sub>Design inspired by <a href="https://github.com/HugoRCD">HugoRCD</a>'s work</sub> </p>
<p align="center">Vue, Nuxt, and NuxtHub skills for AI coding assistants.</p>
<p align="center"> <img src="https://raw.githubusercontent.com/onmax/nuxt-skills/main/.github/badge-claude-code.svg" alt="Claude Code"> <img src="https://raw.githubusercontent.com/onmax/nuxt-skills/main/.github/badge-copilot.svg" alt="GitHub Copilot"> <img src="https://raw.githubusercontent.com/onmax/nuxt-skills/main/.github/badge-codex.svg" alt="OpenAI Codex"> <img src="https://raw.githubusercontent.com/onmax/nuxt-skills/main/.github/badge-gemini.svg" alt="Google Gemini"> <img src="https://raw.githubusercontent.com/onmax/nuxt-skills/main/.github/badge-opencode.svg" alt="OpenCode"> </p>
<p align="center"> <a href="https://github.com/nuxt/nuxt/discussions/34059"> š Related Nuxt RFC: Bundling Agent Skills in Nuxt Modules </a> </p>
Installation
npx skills add onmax/nuxt-skillsThe `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-skillsClaude Code installs Nuxt Skills as one plugin and dynamically discovers all included skill entries.
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
| Skill | Description |
|---|---|
| vue | Vue 3 Composition API, components, composables, testing |
| nuxt | Nuxt 4+ server routes, routing, middleware, config |
| nuxt-modules | Creating Nuxt modules with defineNuxtModule, Kit utilities, testing |
| nuxthub | NuxtHub v0.10 database, KV, blob, cache, multi-cloud |
| nuxt-content | Nuxt Content v3 collections, queries, MDC rendering, NuxtStudio |
| nuxt-ui | Nuxt UI v4 components, theming, forms, overlays, composables |
| nuxt-better-auth | Auth with @onmax/nuxt-better-auth, useUserSession, route protection, clientOnly |
| reka-ui | Reka UI headless Vue components, accessible primitives, props/emits/slots |
| document-writer | Writing documentation for Nuxt ecosystem - MDC, style, structure, code examples |
| ts-library | TypeScript library authoring - exports, tsdown, API patterns, type tricks, CI |
| motion | Motion Vue animations - motion component, composables, scroll, gestures |
| vueuse | VueUse composables - state, browser, sensors, network, animation utilities |
| nuxt-seo | Nuxt SEO meta-module - robots, sitemap, og-image, schema-org, site config |
| vitest | Vitest testing - test API, mocking, coverage, type testing, environments |
| vite | Vite build tool - config, plugins, HMR, SSR, library mode, performance |
| pnpm | pnpm package manager - workspaces, catalogs, CLI commands, CI/CD |
| tsdown | tsdown bundler - TypeScript libraries, DTS generation, package validation |
| tresjs | TresJS 3D framework - TresCanvas, Cientos helpers, post-processing effects |
| writing-web-documentation | Write and review developer docs - page types, house style, templates, web-project rules |
How Skills Work
Skills follow the Agent Skills open format. They can be activated in two ways:
- Auto-discovery ā The agent reads each skill's
descriptionand loads it when relevant to your task - 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 |
| Auth/login/session | nuxt-better-auth |
Structure
Follows agentskills standard format.
nuxt-skills/
āāā skills/ # Skills (agentskills format)
ā āāā vue/
ā ā āāā SKILL.md # Entry point with frontmatter
ā ā āāā references/ # Sub-files loaded on-demand
ā āāā nuxt/
ā āāā nuxt-modules/
ā āāā nuxthub/
ā āāā nuxt-content/
ā āāā nuxt-ui/
ā āāā nuxt-better-auth/
ā āāā reka-ui/
ā āāā document-writer/
ā āāā ts-library/
ā āāā motion/
ā āāā vueuse/
ā āāā nuxt-seo/
ā āāā vitest/
ā āāā vite/
ā āāā pnpm/
ā āāā tsdown/
ā āāā tresjs/
ā āāā writing-web-documentation/
āāā .claude-plugin/
āāā plugin.json # Claude Code plugin manifest
āāā marketplace.json # Claude Code marketplaceAutomated Maintenance
Skills are kept up-to-date via GitHub Actions:
| Workflow | Schedule | Purpose |
|---|---|---|
| update-skills.yml | Weekly (Monday) | Regenerates reka-ui, nuxt-ui, and vueuse docs from upstream |
| skill-maintenance.yml | Biweekly (1st & 15th) | Claude analyzes upstream changelogs, creates PRs if updates needed |
The maintenance workflow uses claude-code-action to intelligently detect breaking changes, new features, and deprecations from upstream sources.
Resources
- ā¢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, vite, pnpm, tsdown skills from @antfu's skills
License
MIT
Install & Usage
/plugin marketplace add <org/repo>Add the configuration to /plugin install vue@<marketplace>
/pluginUse Cases
Usage Examples
/vue Create a Vue 3 component with script setup that fetches data on mount and displays it in a list
/vue Write a composable called useCounter that exposes count, increment, and decrement
/vue Debug this component: the computed property is not updating when the ref changes
Security Audits
Frequently Asked Questions
What is vue?
This skill provides expert guidance on Vue 3 Composition API, including components, composables, and reactive patterns. It helps developers write idiomatic Vue code using ref, computed, watch, and script setup, and troubleshoot common errors like defineProps issues.
How to install vue?
To install vue: add a marketplace (/plugin marketplace add <org/repo>), then add the config to /plugin install vue@<marketplace>. Finally, /plugin in Claude Code.
What is vue best for?
vue is a plugin categorized under General. It is designed for: api, vue, vue3, composition-api, components, composables, reactivity, script-setup. Created by onmax.
What can I use vue for?
vue is useful for: Writing a Vue 3 component with Composition API and script setup; Creating a reusable composable for shared state or logic; Debugging reactivity issues with ref, computed, or watch; Migrating an Options API component to Composition API; Defining props and emits with TypeScript in script setup; Optimizing component performance with computed and watchEffect.