← Explore all 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.

“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.

Upstream setup instructions ↗

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
  1. Install the complete skill directory; the nine references are the substance and must travel with the SKILL.md.
  2. 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.

  1. https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/pinia/SKILL.md

    Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access

  2. https://github.com/JetBrains/skills/tree/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/pinia/references

    Supports: review, whySelected

  3. https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/skills/pinia/SKILL.md

    Supports: review, limitations

  4. Upstream licence (MIT) ↗Checked

    https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/LICENSE.md

    Supports: license

  5. https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/README.md

    Supports: review, install

  6. https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md

    Supports: install

Evidence & Ask