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

vueuse-integrations-skilld — скилл для Claude Code: установка

Скилл vueuse-integrations-skilld учит ИИ-агента правильно использовать 12 обёрток библиотеки @vueuse/integrations v15. Помогает писать типизированный код без ошибок в импортах и сигнатурах.

MIT 145 установок ★ 186 обновлён 2026-10-10

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

Что делает vueuse-integrations-skilld

Скилл добавляет в контекст модели сигнатуры и правила импорта для @vueuse/integrations версии 15.0.0. Он ориентирует модель импортировать функции из отдельных подмодулей вроде @vueuse/integrations/useAxios, чтобы работал tree-shaking. Это сохраняет чистый бандл.

Внутри зашиты особенности утилит, включая useSortable и useFocusTrap. Модель учитывает критические изменения пятнадцатой версии. Например, функция useIDBKeyval теперь возвращает объект со свойствами { data, isFinished, isSupported, set } вместо ref и синхронизирует вкладки через BroadcastChannel.

Без установки нужной peer-зависимости (axios@^1, idb-keyval@^6 или другой) вызов упадёт в рантайме. Зависимости не поставляются внутри. Для работы требуются Node версии не ниже 22 и Vue ^3.5.0.

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

  • настроить вызовы через useAxios с ручным запуском и строгой типизацией
  • связать список с сортировкой через useSortable и sortablejs
  • обновить код с useIDBKeyval под новый формат возвращаемого объекта в v15
  • заблокировать фокус внутри диалогового окна с помощью useFocusTrap

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

  • Сделай запрос через useAxios к /api/users с начальным массивом в initialData
  • Настрой перемещение элементов списка через useSortable с параметром watchElement
  • Сохрани значение в IndexedDB через useIDBKeyval с отключённой синхронизацией вкладок

Как установить vueuse-integrations-skilld

1Через Skills CLI (Vercel)

npx skills add skilld-dev/vue-ecosystem-skills --skill vueuse-integrations-skilld -a claude-code

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

~/.claude/skills/vueuse-integrations-skilld/SKILL.md

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

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

Вопросы о vueuse-integrations-skilld

Как установить vueuse-integrations-skilld в Claude Code?

Выполните в терминале команду npx skills add skilld-dev/vue-ecosystem-skills --skill vueuse-integrations-skilld -a claude-code. Конфигурация запишется в файл ~/.claude/skills/vueuse-integrations-skilld/SKILL.md.

Что делает скилл vueuse-integrations-skilld?

Он передаёт агенту точные сигнатуры и опции для 12 утилит @vueuse/integrations v15. Модель начинает подставлять верные субпути для tree-shaking и учитывает отказ от старых псевдонимов.

Какие требования к окружению нужны для работы кода?

Проекту требуется среда Node не ниже версии 22, Vue ^3.5.0 и сборка только под ESM. Для каждой используемой функции необходимо отдельно доустановить её peer-зависимость, например axios@^1 или fuse.js@^7.

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

SKILL.md · MIT
---
name: vueuse-integrations-skilld
description: Integration wrappers for utility libraries in @vueuse/integrations v15. ALWAYS use when writing code importing "@vueuse/integrations" or any of its composables (useAxios, useSortable, useFocusTrap, useCookies, useIDBKeyval, useFuse, useChangeCase, useDrauu, useJwt, useNProgress, useQRCode, useAsyncValidator). Consult for debugging, best practices, or modifying @vueuse/integrations, vueuse integrations, vueuse.
license: MIT
---

# @vueuse/integrations 15.0.0

Add-on to VueUse: reactive wrappers for 12 utility libraries. Requires Vue (`^3.5.0`) and ships `@vueuse/core` + `@vueuse/shared` 15.0.0 as dependencies (package.json:55-70,108-111). ESM-only since v13. Node >= 22 since v15 (package.json:52-54).

## References

- [Full API surface](./references/api.md) — every export, signature, option, and default, verified against `dist/`.
- [Usage patterns](./references/usage-patterns.md) — per-function recipes and gotchas.
- [Migration v14 to v15](./references/migration-v14-to-v15.md) — breaking changes and update steps.

## Install

```bash
npm i @vueuse/integrations
```

Each wrapper needs its own optional peer dependency installed, otherwise the import fails at runtime:

| Composable | Peer dependency |
|---|---|
| `useAsyncValidator` | `async-validator@^4` |
| `useAxios` | `axios@^1` |
| `useChangeCase` | `change-case@^5` |
| `useCookies` | `universal-cookie@^7 || ^8` |
| `useDrauu` | `drauu@^1 || ^0.4` |
| `useFocusTrap` | `focus-trap@^7 || ^8` |
| `useFuse` | `fuse.js@^7` |
| `useIDBKeyval` | `idb-keyval@^6` |
| `useJwt` | `jwt-decode@^4` |
| `useNProgress` | `nprogress@^0.2` |
| `useQRCode` | `qrcode@^1.5` |
| `useSortable` | `sortablejs@^1` |

Source: package.json:55-69.

## Import rule: use submodules

Import from per-function submodules for tree-shaking (README.md:33-42):

```ts
// Preferred
import { useAxios } from '@vueuse/integrations/useAxios'

// Avoid
import { useAxios } from '@vueuse/integrations'
```

Components import from `/component` subpaths:

```ts
import { UseFocusTrap } from '@vueuse/integrations/useFocusTrap/component'
import { UseSortable } from '@vueuse/integrations/useSortable/component'
import { UseAsyncValidator } from '@vueuse/integrations/useAsyncValidator/component'
```

Alias exports were deprecated in v14.0.0; use the original names (https://github.com/vueuse/vueuse/issues/5009).

## v15 breaking changes (from v14)

1. `useIDBKeyval` returns an object `{ data, isFinished, isSupported, set }`, not a ref (dist/useIDBKeyval.d.ts:46-51). `const count = useIDBKeyval('k', 0)` no longer compiles; destructure `data` instead.
2. `useIDBKeyval` syncs across tabs via `BroadcastChannel` by default; disable with `listenToStorageChanges: false` (dist/useIDBKeyval.js:60-76, https://github.com/vueuse/vueuse/pull/5338).
3. Node.js 20 dropped; requires Node >= 22 (https://github.com/vueuse/vueuse/releases/tag/v15.0.0).
4. `drauu` peer range widened to `^1 || ^0.4` (https://github.com/vueuse/vueuse/pull/5595).

Details and migration code: [migration reference](./references/migration-v14-to-v15.md).

## Quick examples

### useAxios

```ts
import { useAxios } from '@vueuse/integrations/useAxios'

// Awaits the whole result; rejects on error
const { data, error } = await useAxios('/api/posts')

// Manual trigger without firing immediately
const { execute } = useAxios('/api/posts', { method: 'GET' }, { immediate: false })

// Typed data via initialData (data becomes Ref<T> instead of Ref<T | undefined>)
const { data } = useAxios<User[]>('/api/users', undefined, { initialData: [] })
```

`execute()` accepts `url`, `config`, or both. Default options: `immediate` (true only when a url string is passed), `shallow: true`, `abortPrevious: true`, `resetOnExecute: false` (dist/useAxios.js:13-17,35).

### useIDBKeyval

```ts
import { useIDBKeyval } from '@vueuse/integrations/useIDBKeyval'

const { data: count, set } = useIDBKeyval('my-count', 0)
count.value++          // watched, persisted automatically
await set(10)          // explicit write, resolves after the IDB transaction
count.value = null     // deletes the key
```

### useSortable

```ts
import { useSortable } from '@vueuse/integrations/useSortable'

const list = ref(['a', 'b', 'c'])
const { start, stop, option } = useSortable(el, list, {
  watchElement: true, // reinitialize when el appears/disappears (v-if)
})
```

The default `onUpdate` handler moves the array element for you (dist/useSortable.js:14-16). Pass your own `onUpdate` to override; use `moveArrayElement(list, from, to, e)` for manual moves.

### useFocusTrap

```ts
import { useFocusTrap } from '@vueuse/integrations/useFocusTrap'

const target = useTemplateRef<HTMLElement>('modal')
const { activate, deactivate, hasFocus } = useFocusTrap(target, { immediate: true })

async function open() {
  show.value = true
  await nextTick() // wait for v-if to render the element
  activate()
}
```

Container element changes are tracked automatically; the returned object is `{ hasFocus, isPaused, activate, deactivate, pause, unpause }` with no `updateContainerElements` (dist/useFocusTrap.js:37-66).

### useCookies

```ts
import { useCookies } from '@vueuse/integrations/useCookies'

const { get, set, remove } = useCookies(['token'], { autoUpdateDependencies: true })
```

For SSR, build the composable from the request with `createCookies(req)` (dist/useCookies.d.ts:4-9). In Nuxt, import explicitly to avoid clashing with Nuxt's `useCookie`.

### useFuse

```ts
import { useFuse } from '@vueuse/integrations/useFuse'

const search = ref('')
const { results } = useFuse(search, data, {
  fuseOptions: { keys: ['title'] },
  resultLimit: 10,
  matchAllWhenSearchEmpty: true,
})
```

### Remaining wrappers

```ts
useChangeCase('hello world', 'camelCase')   // writable computed; type must match a change-case *Case export
useDrauu(svgEl, { brush: { color: 'red' } }) // target must be an <svg> element
useJwt(token)                                // { header, payload } with fallbackValue on decode error
useNProgress()                               // { isLoading, progress, start, done, remove }
useQRCode('https://vueuse.org')              // ShallowRef<string> of a data URL
useAsyncValidator(form, rules, { manual: true }) // thenable; { pass, errors, execute }
```

See [usage patterns](./references/usage-patterns.md) before writing non-trivial code with `useDrauu`, `useNProgress`, `useQRCode`, or `useAsyncValidator`.

## Environment limits

- Vue `^3.5.0` peer (package.json:68).
- ESM-only; no CommonJS build since v13.0.0 (https://github.com/vueuse/vueuse/releases/tag/v13.0.0).
- Node >= 22 (package.json:53).
- `useQRCode` renders only in the browser (`isClient` guard, dist/useQRCode.js:16).
- `useIDBKeyval` tab sync needs `BroadcastChannel`; `isSupported` reports it (dist/useIDBKeyval.js:18).

© skilld-dev · MIT · skilld-dev/vue-ecosystem-skills

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

Все скиллы по теме «Фронтенд и UI» →
vueuse-mcp kovoor Даёт агенту доступ к документации VueUse: он сам ищет композаблы и читает их описания, пока вы пишете код. CX Codex +1 ★ 5звёзд репо vueuse-functions SerKo Скилл vueuse-functions подбирает функции VueUse для задач во Vue.js и Nuxt и помогает применять их вместо собственного кода. Подходит для Vue 3+ и Nuxt 3+. CX Codex +1 4 100установок spatie-javascript Spatie Скилл spatie-javascript внедряет стандарты оформления JavaScript и TypeScript от команды Spatie. Он помогает форматировать код, настраивать Prettier и писать чистые компоненты. CX Codex +1 580установок axios sanjeed5 Задаёт ИИ-агенту единый стиль работы с axios: общий инстанс, модули API, перехватчики и отмена запросов. Устраняет разнородные вызовы в компонентах и учит агента давать подсказки на конкретном коде. CX Codex +1 ★ 3 589звёзд репо vue sanjeed5 Задаёт строгие стандарты для Vue 3: синтаксис <script setup>, Composition API, Pinia и чистые вычисляемые свойства. Применяется к файлам .vue, .js и .ts. CX Codex +1 ★ 3 589звёзд репо tauri-svelte-typescript-guide-cursorrules-prompt-f PatrickJS Правило tauri-svelte-typescript-guide-cursorrules-prompt-f для Cursor, которое задаёт агенту стиль работы с десктопными приложениями на Tauri: Svelte во фронтенде, TypeScript для типов. CX Codex +1 ★ 41 178звёзд репо

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

Весь набор →
vue-test-utils-skilld Скилл vue-test-utils-skilld помогает писать, отлаживать и проверять тесты Vue 3 с @vue/test-utils 2.5.1. CX Codex +1 168установок vueuse-components-skilld Скилл vueuse-components-skilld помогает писать и отлаживать Vue 3-шаблоны с компонентами и директивами @vueuse/components. Пригодится и при переходе от composable к компонентной или директивной форме. CX Codex +1 168установок motion-v-skilld Скилл motion-v-skilld для анимаций через motion-v (Motion для Vue) — компонент motion, жесты, варианты, директива v-motion, Nuxt-модуль. CX Codex +1 146установок reka-ui-skilld Скилл reka-ui-skilld для Claude Code помогает собирать доступные интерфейсы на Reka UI 2.10.5 во Vue 3, писать чистую композицию и не путать пропсы. CX Codex +1 146установок tanstack-vue-table-skilld Скилл tanstack-vue-table-skilld обучает агента правилам @tanstack/vue-table v9: явной регистрации фич в tableFeatures, атомарному состоянию и миграции с v8. Пригодится при сборке headless-таблиц на Vue 3. CX Codex +1 144установок vueuse-motion-skilld Скилл vueuse-motion-skilld помогает ИИ писать и отлаживать декларативные анимации через @vueuse/motion в Vue 3 и Nuxt 3 без ошибок в таймингах и SSR. CX Codex +1 141установок vueuse-shared-skilld Скилл vueuse-shared-skilld добавляет в Claude Code, Cursor и другие редакторы знание API @vueuse/shared v15.0.0 — фреймворк-агностичных реактивных утилит для Vue. CX Codex +1 137установок tanstack-vue-virtual-skilld Скилл tanstack-vue-virtual-skilld помогает писать, проверять и отлаживать виртуализированные списки и сетки во Vue с @tanstack/vue-virtual. Пригодится и для лент чата с прокруткой к концу. CX Codex +1 129установок

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

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