К основному содержанию
скилл CX Codex

state-management · patternsdev — скилл для Claude Code: что делает и как установить

Скилл state-management направляет агента при проектировании реактивного состояния во Vue 3. Помогает выбрать между props, простым хранилищем на reactive() и Pinia.

MIT 201 установок ★ 259 обновлён 2026-04-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add PatternsDev/skills --skill state-management -a claude-code
Открыть на GitHub

Что делает state-management

Скилл задаёт правила обмена данными в проектах на Vue при редактировании файлов **/*.vue. Он объясняет агенту, когда базовой связки props и кастомных событий $emit перестаёт хватать. Для связанных или глубоко вложенных компонентов скилл предлагает выносить общее состояние на уровень приложения.

Внутри заложены ориентиры по архитектуре без усложнений. Для небольших интерфейсов достаточно синглтона на reactive() с явным разделением на действия и мутации. Для крупных систем с TypeScript и devtools инструкция предписывает подключать Pinia через defineStore.

Тащить Pinia в крошечный интерфейс не нужно. Скилл прямо запрещает перегружать кодовую базу сложными хранилищами там, где хватит стандартного Composition API.

Какие задачи решает

  • связать общее реактивное состояние между соседними компонентами Vue
  • настроить передачу событий от дочернего компонента к родительскому через $emit
  • спроектировать легковесный store с помощью reactive() без сторонних библиотек
  • организовать глобальное хранилище на Pinia с типизацией

Примеры запросов агенту

  • Сделай общее реактивное хранилище на reactive() для передачи списка покупок между двумя соседними компонентами
  • Настрой передачу данных из дочерней формы в родительский компонент через событие @submit
  • Переведи глобальное состояние приложения на Pinia с использованием defineStore

Как установить state-management

1Через Skills CLI (Vercel)

npx skills add PatternsDev/skills --skill state-management -a claude-code

2Вручную: положить файлы

~/.claude/skills/state-management/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/state-management/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о state-management

Как установить state-management в Claude Code?

Выполните команду npx skills add PatternsDev/skills --skill state-management -a claude-code. Файл с инструкцией сохранится по пути ~/.claude/skills/state-management/SKILL.md.

Что делает скилл state-management?

Он учит языковую модель грамотно организовывать работу с данными во Vue 3. Ассистент перестаёт прокидывать глубокие цепочки props и выбирает подходящую архитектуру хранилища под размер проекта.

Когда скилл рекомендует использовать Pinia вместо обычного хранилища?

Pinia предлагается внедрять в крупных проектах, где требуются поддержка TypeScript, плагины и отладка через devtools.

Исходный текст

SKILL.md · MIT
---
name: state-management
description: Teaches Vue state management with stores, Pinia, and the Composition API. Use when you need to share and synchronize state across multiple components beyond what props and events can handle.
paths:
  - "**/*.vue"
license: MIT
metadata:
  author: patterns.dev
  version: "1.1"
related_skills:
  - "composables"
  - "components"
---

# State Management

## Table of Contents

- [When to Use](#when-to-use)
- [Instructions](#instructions)
- [Details](#details)
- [Source](#source)

**Vue components are the building blocks of Vue apps** by allowing us to couple markup (HTML), logic (JS), and styles (CSS) within them.

## When to Use

- Use this when you need to share reactive data between sibling or deeply nested components
- This is helpful for managing global application state beyond simple parent-child prop passing

## Instructions

- Use props for parent-to-child data flow and custom events for child-to-parent communication
- Create a simple store using `reactive()` for small applications
- Use Pinia (the official Vue state management library) for larger apps needing devtools, plugins, and TypeScript support
- Choose the state management approach based on your app's complexity — don't over-engineer small apps

## Details

Here's an example of a Single-File component that displays a series of numbers from a data property:

```html
<template>
  <div>
    <h2>The numbers are {{ numbers }}!</h2>
  </div>
</template>

<script setup>
  import { ref } from "vue";

  const numbers = ref([1, 2, 3]);
</script>
```

The `ref()` function prepares the component to be _reactive_. If a reactive property value that's being used in the template changes, the component view will re-render to show the change.

What if `numbers` was a data value that needed to be accessed from another component? If we want to share `numbers` between multiple components, `numbers` doesn't only become component-level data _but also_ application-level data. This brings us to the topic of **State Management** - the management of application level data.

### Props

Vue gives us the ability to use **props** to pass data from the parent down to the child. Using props is fairly simple. All we essentially need to do is bind a value to the prop attribute where the child component is being rendered.

**ParentComponent**:

```html
<template>
  <div>
    <ChildComponent :numbers="numbers" />
  </div>
</template>

<script setup>
  import { ref } from "vue";
  import ChildComponent from "./ChildComponent";

  const numbers = ref([1, 2, 3]);
</script>
```

**ChildComponent**:

```html
<template>
  <div>
    <h2>{{ numbers }}</h2>
  </div>
</template>

<script setup>
  const { numbers } = defineProps(["numbers"]);
</script>
```

### Component Events

What if we needed to find a way to communicate information in the opposite direction? We can't use `props` since `props` can only be used to pass data in a uni-directional format (from parent down to child). To facilitate having the child component notify the parent about something, we can use custom events.

Custom events in Vue are dispatched as native CustomEvents and are used for communication between components.

**ChildComponent**:

```html
<template>
  <div>
    <h2>{{ numbers }}</h2>
    <input v-model="number" type="number" />
    <button @click="$emit('number-added', Number(number))">
      Add new number
    </button>
  </div>
</template>

<script setup>
  const { numbers } = defineProps(["numbers"]);
</script>
```

**ParentComponent**:

```html
<template>
  <div>
    <ChildComponent :numbers="numbers" @number-added="(n) => numbers.push(n)" />
  </div>
</template>

<script setup>
  import { ref } from "vue";
  import ChildComponent from "./ChildComponent";

  const numbers = ref([1, 2, 3]);
</script>
```

### Simple State Management

We can use props to pass data downwards and custom events to send messages upwards. How would we be able to either pass data or facilitate communication between two different sibling components?

A simple way to manage application-level state is to create a store pattern that involves sharing a data store between components. The store can manage the state of our application as well as the methods that are responsible for changing the state.

```js
import { reactive } from "vue";

export const store = reactive({
  numbers: [1, 2, 3],
  addNumber(newNumber) {
    this.numbers.push(newNumber);
  },
});
```

The store contains a `numbers` array and an `addNumber` method that accepts a payload and directly updates the store's `numbers` value.

With Vue 3.x, we're able to import and use the `reactive()` function to declare reactive state from a JavaScript object. When this reactive state gets changed with the `addNumber()` method, any component that uses this reactive state will automatically update!

**NumberDisplay**:

```html
<template>
  <div>
    <h2>{{ store.numbers }}</h2>
  </div>
</template>

<script setup>
  import { store } from "../store.js";
</script>
```

**NumberSubmit**:

```html
<template>
  <div>
    <input v-model="numberInput" type="number" />
    <button @click="store.addNumber(numberInput)">Add new number</button>
  </div>
</template>

<script setup>
  import { ref } from "vue";
  import { store } from "../store.js";

  const numberInput = ref(0);
</script>
```

When we say components interact with one another here, we're using the term 'interact' loosely. The components aren't going to do anything to each other but instead invoke changes to one another _through_ the store.

If we take a closer look at all the pieces that directly interact with the store, we can establish a pattern:

- The method in `NumberSubmit` has the responsibility to directly act on the store method, so we can label it as a **store action**.
- The store method has a certain responsibility as well - to directly mutate the store state. So we'll say it's a **store mutation**.
- `NumberDisplay` doesn't really care about what type of methods exist in the store or in `NumberSubmit`, and is only concerned with getting information from the store. So we'll say `NumberDisplay` is a **store getter** of sorts.

An **action** commits to a **mutation**. The **mutation** mutates state which then affects the view/components. View/components retrieve store data with **getters**. We're starting to get closer to a more structured manner to handling application-level state.

### Pinia

[Pinia](https://pinia.vuejs.org/) is a state management pattern and library for Vue.js that provides a more structured and scalable way to handle application-level state.

Pinia is an alternative to other state management solutions like [Vuex](https://vuex.vuejs.org/) and is now the official state management library for Vue. It provides a simple and efficient way to create and manage stores, which encapsulate state, actions, and getters.

In Pinia, we can define a store using the `defineStore()` function. Here we're using the Composition API syntax to define a `useNumbersStore()` function to create a `numbers` store.

```js
import { ref } from "vue";
import { defineStore } from "pinia";

export const useNumbersStore = defineStore("numbers", () => {
  const numbers = ref([1, 2, 3]);

  function addNumber(newNumber) {
    numbers.value.push(newNumber);
  }

  return { numbers, addNumber };
});
```

We can then create a Pinia instance and install it in our Vue app.

```js
import { createApp } from "vue";
import { createPinia } from "pinia";
import App from "./App.vue";

const app = createApp(App);
const pinia = createPinia();

app.use(pinia);
app.mount("#app");
```

In the `NumberDisplay` component:

```html
<template>
  <div>
    <h2>{{ store.numbers }}</h2>
  </div>
</template>

<script setup>
  import { useNumbersStore } from "../store";

  const store = useNumbersStore();
</script>
```

In the `NumberSubmit` component:

```html
<template>
  <div>
    <input v-model="numberInput" type="number" />
    <button @click="store.addNumber(numberInput)">Add new number</button>
  </div>
</template>

<script setup>
  import { ref } from "vue";
  import { useNumbersStore } from "../store";

  const store = useNumbersStore();
  const numberInput = ref(0);
</script>
```

For such a simple implementation like this, a Pinia store may not really be necessary and behaves very similarly to just using a store created with the `reactive()` function. With that said, Pinia offers additional capabilities for more complex use-cases such as the ability to extend Pinia features with plugins, have devtools support, and have more appropriate TypeScript support and server-side rendering support.

### What's the correct way?

Each method for managing application-level state comes with its advantages and disadvantages.

#### Simple Store

- **Pro**: Relatively easy to establish.
- **Con**: State and possible state changes aren't explicitly defined.

#### Pinia

- **Pro**: Devtools support, plugins + typescript + server-side rendering support
- **Con**: Additional boilerplate.

At the end of the day, it's up to us to understand what's needed in our application and what the best approach may be.

## Source

- [patterns.dev/vue/state-management](https://patterns.dev/vue/state-management)

### References

- [Props | Vue Documentation](https://vuejs.org/guide/components/props.html#props)
- [Component Events | Vue Documentation](https://vuejs.org/guide/components/events.html#component-events)
- [Simple State Management with Reactivity API | Vue Documentation](https://vuejs.org/guide/scaling-up/state-management.html#simple-state-management-with-reactivity-api)
- [Core concepts | Pinia](https://pinia.vuejs.org/core-concepts/)

© patterns.dev · MIT · PatternsDev/skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →

Сначала — state-management от других авторов.

state-management agent-skills Скилл state-management для Claude Code помогает настраивать загрузку данных, кэширование и клиентское состояние через React Query и Zustand. Активируется при работе с useQuery, useMutation и хранилищами Zustand. CX Codex +1 849установок state-management statelyai Скилл state-management для Claude Code моделирует состояние приложения до выбора библиотеки. Проверяет и рефакторит модели, сокращает исходные данные и устраняет невозможные состояния. CX Codex +1 181установок state-management akillness Скилл state-management помогает решить, кому принадлежит состояние в React-приложении, и выбрать самый узкий подходящий инструмент вместо спора о библиотеках. CX Codex +1 367установок vue-expert https://github.com/Jeffallan Скилл vue-expert для Claude Code пишет код на Vue 3 с Composition API, настраивает Nuxt 3, Pinia и Vite. Создаёт компоненты, PWA и гибридные приложения. CX Codex +1 4 800установок vue-development travisjneuman Скилл vue-development для Claude Code помогает писать код на Vue 3 с синтаксисом Composition API и Script Setup. Подключается при настройке Pinia, создании композаблов и разработке на Nuxt 3. CX Codex +1 143установок vue официальный github Задаёт стандарты разработки на Vue 3. Подключается как файл инструкций и направляет Copilot при работе с компонентами, реактивностью, Pinia и TypeScript. CX Codex +1 ★ 41 430звёзд репо Expert Vue.js Frontend Engineer официальный github Субагент Expert Vue.js Frontend Engineer для GitHub Copilot, который пишет и правит фронтенд на Vue 3 с TypeScript. Берёт на себя компоненты, сторы Pinia, тесты и вопросы производительности в одном рабочем цикле. CX Codex +1 ★ 41 430звёзд репо pinia Anthony Fu Загружает документацию Pinia v4.0.3 прямо в контекст агента. Агент начинает правильно определять сторы, работать с storeToRefs() и настраивать SSR-гидратацию. CX Codex +1 20 600установок vue-pinia-best-practices github.com/vuejs-ai Скилл vue-pinia-best-practices с лучшими практиками Pinia: как избежать ошибок при настройке хранилищ, сохранить реактивность и правильно организовать state management в Vue-проекте. CX Codex +1 18 500установок

Из того же набора58

Весь набор →
composables Скилл composables для Claude Code учит писать Vue-композаблы — переиспользуемую логику на Composition API. Выносит реактивное состояние, вычисления и побочные эффекты в функции для нескольких компонентов. CX Codex +1 211установок async-components Скилл async-components учит агента загружать Vue-компоненты асинхронно через defineAsyncComponent(), чтобы не тянуть тяжёлые модалки и диалоги при старте. CX Codex +1 207установок container-presentational Скилл container-presentational учит разделять Vue-компоненты на контейнеры (логика, запросы) и презентационные (вёрстка). Презентационный компонент получает данные через props и не трогает состояние. CX Codex +1 205установок data-provider Объясняет паттерн data provider во Vue: логика загрузки и состояния передаётся дочерним компонентам через scoped slots. CX Codex +1 204установок dynamic-components Скилл dynamic-components для Claude Code переключает компоненты Vue через <component :is> и сохраняет их состояние с <KeepAlive>. Переключает вкладки и панели без роутера. CX Codex +1 198установок provide-inject Скилл provide-inject учит агента использовать provide() и inject() из Vue для передачи данных глубоко вложенным компонентам без прокидывания пропсов через каждый уровень. CX Codex +1 196установок render-functions Скилл render-functions учит ИИ-агента писать рендер-функции через h() и синтаксис JSX во Vue. Пригодится при сборке UI-библиотек и динамической разметки, где возможностей шаблонов не хватает. CX Codex +1 196установок script-setup Учит агента писать Vue 3-компоненты с <script setup> — без лишнего кода и явного return. CX Codex +1 195установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой