# pinia-skilld

Скилл для ИИ-агентов, который подсказывает верные API Pinia 4.x: хранилища, геттеры, действия, SSR и миграцию с v2 и v3.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 305 установок · ★ 184
- Автор: skilld-dev
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/skilld-dev/vue-ecosystem-skills/tree/HEAD/skills/pinia-skilld/SKILL.md
- Обновлён: 2026-10-10
- HTML: https://affpapa.org/nevibecode/skills/pinia-skilld

## Что делает

Правила скилла включаются, когда код импортирует `pinia`. Агент получает справку по option- и setup-хранилищам, состоянию, геттерам, действиям, подпискам, плагинам, гидратации в SSR и тестированию. Отдельно разобраны map-хелперы для Options API и диагностика v4.

Внутри — набор справочных файлов: поверхность API с сигнатурами, хранилища, подписки, плагины, SSR, тестирование, Options API и каталог диагностик. Источники — подготовленный код pinia 4.0.3 и официальная документация.

Установка потребует `@vue/devtools-api` версии `^8.1.5` рядом с pinia, потому что в v4 он стал обязательным peer-пакетом. Пакет поставляется только как ESM, поэтому `require()` в старом CommonJS-коде сломается. Нужен Vue `^3.5.11`; Vue 2 не поддерживается с третьей версии. Для Nuxt берите `@pinia/nuxt` 1.x, для тестов — `@pinia/testing` 2.x.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add skilld-dev/vue-ecosystem-skills --skill pinia-skilld -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/pinia-skilld/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/pinia-skilld/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add skilld-dev/vue-ecosystem-skills --skill pinia-skilld -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/pinia-skilld/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add skilld-dev/vue-ecosystem-skills --skill pinia-skilld -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/pinia-skilld/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install skilld-dev/vue-ecosystem-skills pinia-skilld
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/pinia-skilld/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add skilld-dev/vue-ecosystem-skills --skill pinia-skilld -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/skilld-dev/vue-ecosystem-skills --path skills/pinia-skilld
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/pinia-skilld/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add skilld-dev/vue-ecosystem-skills --skill pinia-skilld -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/skilld-dev/vue-ecosystem-skills/tree/HEAD/skills/pinia-skilld/SKILL.md

## Когда брать
- написать setup-хранилище и не потерять реактивность при деструктуризации
- починить `$reset()`, который падает на setup-хранилище
- настроить гидратацию состояния в SSR без утечки между запросами
- перевести проект с `defineStore({ id: 'x' })` на новый синтаксис
- разобраться, почему после обновления до v4 ломается `require()`

## Примеры запросов агенту
- добавь хранилище todos на setup-синтаксисе с геттером done
- почему `$reset()` бросает ошибку в моём setup-хранилище?
- перенеси хранилище counter с pinia v2 на v4

## Похожие
- [pinia](https://affpapa.org/nevibecode/skills/pinia.md) — скилл · 19700 установок
- [vue-pinia-best-practices](https://affpapa.org/nevibecode/skills/vue-pinia-best-practices.md) — скилл · 16900 установок
- [nuxt-data](https://affpapa.org/nevibecode/skills/nuxt-data.md) — скилл · 388 установок
- [unit-test-vue-pinia](https://affpapa.org/nevibecode/skills/unit-test-vue-pinia.md) — скилл · 1800 установок
- [vuejs-typescript-best-practices](https://affpapa.org/nevibecode/skills/vuejs-typescript-best-practices.md) — скилл · 1000 установок
- [vue](https://affpapa.org/nevibecode/rules/vue.md) — правило · ★ 40418

Из того же набора: [skilld-dev/vue-ecosystem-skills](https://affpapa.org/nevibecode/by/skilld-dev/vue-ecosystem-skills.md) — 5 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md