Skip to main content
skill CX Codex

vueuse-integrations-skilld — Claude Code skill: how to install

vueuse-integrations-skilld equips AI agents with reference rules for 12 utility wrappers in @vueuse/integrations v15. Prevents broken imports and guides API migration.

MIT 145 installs ★ 186 updated 2026-10-10

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add skilld-dev/vue-ecosystem-skills --skill vueuse-integrations-skilld -a claude-code
Open on GitHub

What vueuse-integrations-skilld does

This skill guides coding agents through @vueuse/integrations 15.0.0 APIs. It directs models to import from function subpaths such as @vueuse/integrations/useAxios instead of package roots. This preserves tree-shaking.

The reference details helpers such as useSortable and useFocusTrap, including breaking changes introduced in version 15. For example, useIDBKeyval returns an object with { data, isFinished, isSupported, set } rather than a raw ref, and defaults to cross-tab updates via BroadcastChannel.

Peer packages are not bundled. Each helper requires its own peer dependency like axios@^1 or sortablejs@^1, or runtime imports will fail. You also need Node 22 or newer alongside Vue ^3.5.0 in an ESM project.

What it helps with

  • configure useAxios with typed responses and deferred execution
  • implement drag-and-drop lists with useSortable and sortablejs
  • update useIDBKeyval calls to handle the v15 return object structure
  • trap keyboard focus within modal dialogs using useFocusTrap

Example prompts for the agent

  • Create a useAxios call to /api/users with initialData set to an empty array
  • Set up a reorderable list using useSortable with watchElement enabled
  • Store a persistent setting using useIDBKeyval with cross-tab syncing disabled

How to install vueuse-integrations-skilld

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/vueuse-integrations-skilld/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about vueuse-integrations-skilld

How do I install vueuse-integrations-skilld in Claude Code?

Run npx skills add skilld-dev/vue-ecosystem-skills --skill vueuse-integrations-skilld -a claude-code in your terminal. The configuration is stored at ~/.claude/skills/vueuse-integrations-skilld/SKILL.md.

What does vueuse-integrations-skilld do?

It provides API signatures and migration rules for all 12 helpers in @vueuse/integrations v15. The model learns to use submodule imports and avoids deprecated aliases.

What environment requirements does this skill enforce?

The code requires Node 22 or higher along with Vue ^3.5.0 in an ESM project. You must also install the specific peer dependency for each helper you import, such as fuse.js@^7 or idb-keyval@^6.

Source text

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

Similar skills

All skills for Frontend and UI →

From the same set32

The whole set →
vue-test-utils-skilld The vue-test-utils-skilld skill guides Vue 3 tests with @vue/test-utils 2.5.1, including mounting, wrapper queries, async work, and v1 migration. CX Codex +1 168installs vueuse-components-skilld vueuse-components-skilld is a Claude Code skill that guides Vue 3 template work with @vueuse/components, including debugging and translating composables into component or directive usage. CX Codex +1 168installs motion-v-skilld motion-v-skilld — a skill for motion-v (Motion for Vue) animations: motion component, gestures, variants, v-motion directive, Nuxt module. CX Codex +1 146installs reka-ui-skilld reka-ui-skilld is a Claude Code skill for building accessible interfaces with Reka UI 2.10.5 in Vue 3. It helps agents write clean component compositions and use props accurately. CX Codex +1 146installs tanstack-vue-table-skilld tanstack-vue-table-skilld helps AI agents write and migrate @tanstack/vue-table v9 code. Enforces explicit tableFeatures, atom-based state, and clean Vue 3 reactivity patterns. CX Codex +1 144installs vueuse-motion-skilld vueuse-motion-skilld guides coding agents through @vueuse/motion v3 APIs in Vue 3 and Nuxt 3, preventing runtime bugs with SSR, timing units, and imports. CX Codex +1 141installs vueuse-shared-skilld vueuse-shared-skilld — a skill that brings @vueuse/shared v15.0.0 API reference into Claude Code, Cursor, and other editors. Covers reactive utilities: debounce, throttle, watch variants, state sharing, and ref synchronization for Vue 3. CX Codex +1 137installs tanstack-vue-virtual-skilld The tanstack-vue-virtual-skilld skill guides Vue work with @tanstack/vue-virtual, from implementing virtual lists to debugging adapter usage. It also covers window scrolling and chat feeds anchored at the end. CX Codex +1 129installs

Project sponsors

Companies that keep this analytics open