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.
“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.”
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.
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.
DOCUMENTED COMMAND
npx skills add JetBrains/skills/pinia --skill pinia 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 - 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
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/pinia/SKILL.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access
https://github.com/JetBrains/skills/tree/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/pinia/references
Supports: review, whySelected
https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/skills/pinia/SKILL.md
Supports: review, limitations
- Upstream licence (MIT) ↗Checked
https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/LICENSE.md
Supports: license
https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/README.md
Supports: review, install
https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md
Supports: install