---
title: "Pinia: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/jetbrains-pinia/
description: "Reference-index over Pinia store design: defining stores, state, getters and actions, storeToRefs destructuring, plugins, composing stores without circular dependencies, SSR hydration, HMR and testing with @pinia/testing."
---

# Pinia: review, setup & limitations · Undominated.ai

> Reference-index over Pinia store design: defining stores, state, getters and actions, storeToRefs destructuring, plugins, composing stores without circular dependencies, SSR hydration, HMR and testing with @pinia/testing.

[← Explore all skills](/skills/)

FRAMEWORK DEVELOPMENT / JetBrains

# Pinia

Reference-index over Pinia store design: defining stores, state, getters and actions, storeToRefs destructuring, plugins, composing stores without circular dependencies, SSR hydration, HMR and testing with @pinia/testing.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/JetBrains/skills/tree/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/pinia)

SOURCE REVIEW

 Reviewed 2026-10-07
 Evidence 6 linked sources
 Publisher JetBrains
 Licence [MIT (upstream antfu/skills) ↗](https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/LICENSE.md)
 Revision e0f258b5cfed
 [Read what was—and wasn’t—checked ↓](#review)

“Pinia official Vue state management library, type-safe and extensible. Use when defining stores, working with state/getters/actions, or implementing store patterns in Vue apps.”

 [JetBrains · upstream description ↗](https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/pinia/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Splits the parts of Pinia that agents get wrong into nine reference files — storeToRefs reactivity, composing stores without circular dependencies, using stores outside components, SSR hydration — rather than compressing them into prose.
- The key recommendations encode the failure modes directly: destructuring state without storeToRefs loses reactivity, module-scope store calls break SSR, actions are bound and can be destructured safely.
- Mirrors the official Pinia manual structure generated from the upstream antfu/skills generator, so an agent loads exactly one topic at a time instead of the whole library.

### A good fit for

 - Designing or refactoring Pinia stores in a Vue 3 application
- Fixing reactivity lost to destructuring or module-scope store use
- Testing stores with @pinia/testing and setting up SSR state hydration

### Weigh up before choosing

 - The mirror carries the January 2026 generation, based on Pinia v3.0.4; the upstream antfu/skills generator has since produced a Pinia v4.0.3 revision (2026-09-25) that the pinned mirror does not include.
- Reference-index style: the SKILL.md is a routing table over nine reference files and deliberately carries no worked project.
- Vue-specific; state-management questions outside Pinia get nothing here.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - pinia/SKILL.md (JetBrains mirror, complete, 60 lines)
- pinia/references directory listing (9 files)
- upstream antfu/skills skills/pinia/SKILL.md
- upstream antfu/skills LICENSE.md
- JetBrains/skills README mirror policy

### Our findings

 - Every reference link in the SKILL.md resolves to a file present in the mirror's references directory, verified against the directory listing.
- Front matter credits Anthony Fu's antfu/skills as source and states the skill is based on Pinia v3.0.4, generated 2026-01-28.
- The upstream generator has since moved to a 2026-09-25 Pinia 4.0.3 build; the pinned mirror revision is eight months behind upstream.

### Not established by this review

 - No Pinia store was written or run; the workflow was read, not executed.
- Reference files were verified to exist and sampled, not read end to end.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md)

DOCUMENTED COMMAND

 npx skills add JetBrains/skills/pinia --skill pinia Copy command ↗

Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.

 Optional: install the reviewed revision

Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.

 npx skills add https://github.com/JetBrains/skills/tree/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/pinia --skill pinia Copy reviewed-revision command ↗ - Install the complete skill directory; the nine references are the substance and must travel with the SKILL.md.
- Point the agent at the store being designed or the reactivity bug; let it load only the reference topic it needs.

### Before you start

 - Node.js/npm for the installer
- An agent that supports the Agent Skills format
- A Vue 3 project using or adopting Pinia

### Compatibility

Agent Skills-compatible coding agents · Vue 3 applications using Pinia 3.x · Nuxt integration covered in a dedicated reference

### Reads Vue components and store files; writes store code

 - Read Vue components, store definitions and test files
- Write Pinia store definitions, composables and tests
- Run the dev server or test suite only when the user asks

### Cost model

MIT-licensed instruction package; store execution costs only local machine and agent time.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Skill definition at reviewed revision ↗](https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/pinia/SKILL.md) Checked 2026-10-07 https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/pinia/SKILL.md Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access
- [Reference directory listing at reviewed revision (9 documents) ↗](https://github.com/JetBrains/skills/tree/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/pinia/references) Checked 2026-10-07 https://github.com/JetBrains/skills/tree/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/pinia/references Supports: review, whySelected
- [Upstream skill definition (origin of the mirrored content) ↗](https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/skills/pinia/SKILL.md) Checked 2026-10-07 https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/skills/pinia/SKILL.md Supports: review, limitations
- [Upstream licence (MIT) ↗](https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/LICENSE.md) Checked 2026-10-07 https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/LICENSE.md Supports: license
- [Mirror policy: JetBrains-filtered, JetBrains-verified snapshot with source links and CI skill scanning ↗](https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/README.md) Checked 2026-10-07 https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/README.md Supports: review, install
- [Skills installer source formats and selective installation ↗](https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md) Checked 2026-10-07 https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md Supports: install

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Svelte Core Best Practices ↗ Svelte-maintained guidance for reactivity, component composition and integration with browser APIs.](/skills/svelte-svelte-core-bestpractices/)[### Temporal Developer ↗ Temporal SDK guidance across seven languages, centred on replay determinism, versioning and wrapping LLM calls in activities.](/skills/temporalio-temporal-developer/)[### VitePress ↗ Documentation-site guidance for VitePress: .vitepress configuration, file-based routing and rewrites, Markdown extensions, Vue components inside Markdown, build-time data loaders, dynamic routes, theming, internationalization, SSR compatibility, and deployment recipes.](/skills/jetbrains-vitepress/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
