Pinia Skilld

This covers Pinia 3.0.4, Vue's official state management library. You'll want it whenever you're working with Pinia imports, whether you're setting up new stores, debugging reactivity issues, or migrating from v2. The skill documents the breaking changes in v3 (dropped Vue 2 support, removed the old object signature with id property, now ESM-first), plus newer helpers like the action() wrapper and disposePinia(). The best practices section is genuinely useful: it explains why $patch with a function is better than an object, when to use skipHydrate() for SSR, and how to avoid context bugs when composing stores across async boundaries. Solid reference if you're doing anything non-trivial with Pinia.

skills.sh installs: 170
GitHub stars: 165
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add harlan-zw/vue-ecosystem-skills --skill pinia-skilld --agent claude-code

Installs into .claude/skills of the current project.

Files

pinia@4.0.3

Source citations use package-relative paths from the prepared pinia 4.0.3 source: package.json, README.md, dist/pinia.js (runtime), dist/pinia.d.ts (types). Other citations are official documentation URLs.

Requirements

Vue ^3.5.11 peer [package.json:62]. Vue 2 is unsupported since v3.
@vue/devtools-api ^8.1.5 is a required, non-optional peer [package.json:60-68]. Install it alongside pinia: npm install pinia @vue/devtools-api [README.md:108-111], v4.0.0 release notes.
TypeScript >=5.6.0 optional peer [package.json:69-71].
ESM-only package: "type": "module", single export . to dist/pinia.js [package.json:42,47-50]. v4 removed CJS resolution; a require() fallback breaks.
@pinia/nuxt 1.x and @pinia/testing 2.x are the companion versions for pinia 4 (https://github.com/vuejs/pinia/releases).

Install and setup

import { createApp } from 'vue'
import { createPinia } from 'pinia'
import App from './App.vue'

const pinia = createPinia()
const app = createApp(App)
app.use(pinia)
app.mount('#app')

SKILL.md on GitHub