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

vue-router-skilld — скилл для Claude Code: что делает и как установить

Скилл vue-router-skilld для Claude Code содержит правила настройки [email protected]: типизированная маршрутизация, data loaders и файловые роуты без устаревшего API.

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

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

Что делает vue-router-skilld

Скилл содержит правила работы с [email protected] и совместимыми версиями vue ^3.5.34 || ^4.0.0. Он задаёт карту импортов для Vite, Unplugin и модулей авто-роутинга, отсекая устаревший vue-router/auto.

Внутри описаны нюансы навигационных гардов: отказ от вызова next() в пользу возврата значений, чтение router.currentRoute.value и замена удалённого router.onReady() на await router.isReady(). Также зафиксирован порядок подключения в сборщике: плагин VueRouter() обязан стоять строго перед плагином Vue().

Для загрузки данных скилл задаёт использование defineBasicLoader и функции reroute(to) из vue-router/experimental. Учтите: модуль vue-router/experimental работает только в ESM и сломается при попытке запустить его в сборке CJS.

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

  • перевести навигационные гарды с next() на возврат значений
  • настроить плагин vue-router/vite перед плагином @vitejs/plugin-vue
  • подключить генерацию типов RouteNamedMap и типизированные параметры
  • настроить data loaders через defineBasicLoader из vue-router/experimental

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

  • Сконфигурируй файловый роутинг в vite.config.ts с плагином vue-router/vite
  • Перепиши beforeEach гард в router/index.ts без использования устаревшего next
  • Добавь типизированный data loader для страницы пользователя с вызовом reroute

Как установить vue-router-skilld

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/vue-router-skilld/SKILL.md

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

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

Вопросы о vue-router-skilld

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

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

С какими версиями Vue работает этот скилл?

Скилл ориентирован на [email protected] и требует vue ^3.5.34 || ^4.0.0. Опционально поддерживаются vite ^7.3.0 || ^8.0.0, pinia ^3.0.4 || ^4.0.2 и @pinia/colada >=0.21.2.

Почему скилл запрещает импорт vue-router/auto?

Импорт vue-router/auto объявлен устаревшим и запланирован к удалению. Вместо него скилл направляет использовать vue-router/auto-routes для маршрутов или плагин vue-router/vite.

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

SKILL.md · MIT
---
name: vue-router-skilld
description: ALWAYS use when writing code that imports "vue-router", "vue-router/vite", "vue-router/auto-routes", or "vue-router/experimental". Consult for debugging, best practices, or modifying vue-router, vue router, router, file-based routing, typed routes, data loaders.
license: MIT
---

# vuejs/router `[email protected]`

Prepared source: `[email protected]`, ESM package (`"type": "module"`, package.json:2,20).
Peers: `vue ^3.5.34 || ^4.0.0`; optional `vite ^7.3.0 || ^8.0.0`, `pinia ^3.0.4 || ^4.0.2`, `@pinia/colada >=0.21.2` (package.json:173-193).
Docs: https://router.vuejs.org

## Import map

| Import | Use for |
|---|---|
| `vue-router` | `createRouter`, `createWebHistory`, `createWebHashHistory`, `createMemoryHistory`, `RouterLink`, `RouterView`, `useRouter`, `useRoute`, `useLink`, `onBeforeRouteLeave`, `onBeforeRouteUpdate`, `isNavigationFailure`, `NavigationFailureType`, `START_LOCATION`, `parseQuery`, `stringifyQuery` (dist/vue-router.d.ts:6) |
| `vue-router/vite` | Vite plugin, file-based routing (package.json:104) |
| `vue-router/unplugin/{vite,webpack,rollup,esbuild,rolldown}` | same plugin for other bundlers (dist/unplugin/) |
| `vue-router/unplugin` | `VueRouterAutoImports`, `createRoutesContext`, `EditableTreeNode`, plugin `Options` (dist/unplugin/index.d.mts:62) |
| `vue-router/auto-routes` | generated `routes` array + `handleHotUpdate(router)` (vue-router-auto-routes.d.mts:6,28) |
| `vue-router/auto-resolver` | generated `resolver` for `experimental_createRouter` + `handleHotUpdate` (vue-router-auto-resolver.d.mts:15,21) |
| `vue-router/experimental` | data loaders, `reroute`, `miss`, `definePage`, `defineParamParser`, `PARAM_PARSER_INT`/`PARAM_PARSER_BOOL`, `experimental_createRouter`, `useIsDataLoading` (dist/experimental/index.d.ts:7) |
| `vue-router/experimental/pinia-colada` | `defineColadaLoader` (package.json:77) |
| `vue-router/volar/sfc-route-blocks`, `vue-router/volar/sfc-typed-router` | Volar plugins: `<route>` blocks, per-file typed `useRoute()` (package.json:115-121) |

Avoid:
- `vue-router/auto` — deprecated, will be removed (vue-router-auto.d.ts:1).
- `vue-router/experimental` in CJS builds — ESM-only since v5.1.0 (https://github.com/vuejs/router/releases/tag/v5.1.0).

## Quick start (classic routes)

```ts
import { createRouter, createWebHistory } from 'vue-router'

const router = createRouter({
  history: createWebHistory(),
  routes: [
    { path: '/', component: () => import('./pages/Home.vue') },
    { path: '/users/:id', component: () => import('./pages/User.vue'), props: true },
  ],
})
app.use(router)
```

In components: `useRoute()` / `useRouter()` from `vue-router`; `<RouterLink to="...">` and `<RouterView>` are globally registered by `app.use(router)`.

## Quick start (file-based routing)

```ts
// vite.config.ts
import VueRouter from 'vue-router/vite'
import Vue from '@vitejs/plugin-vue'

export default defineConfig({
  plugins: [VueRouter(), Vue()], // Vue plugin MUST come after VueRouter
})
```

```ts
import { createRouter, createWebHistory } from 'vue-router'
import { routes, handleHotUpdate } from 'vue-router/auto-routes'

const router = createRouter({ history: createWebHistory(), routes })
if (import.meta.hot) handleHotUpdate(router)
```

Pages live in `src/pages` by default. Start the dev server once to generate `typed-router.d.ts`, add it to `tsconfig.json` `include` with `"moduleResolution": "Bundler"`. Details, naming conventions, and plugin options: [references/file-based-routing.md](./references/file-based-routing.md).

## Core rules

- Return values from navigation guards, never call `next()`. `next` is deprecated (runtime warning since v5.0.3) and will be removed (dist/index-D7ja2BKs.d.ts:362-393, https://github.com/vuejs/router/releases/tag/v5.0.3).
  ```ts
  router.beforeEach(to => {
    if (to.meta.requiresAuth && !isAuthenticated) return { name: 'login' }
    // return nothing, true, false, or a route location
  })
  ```
- In data loaders, redirect with `reroute(to)`; `new NavigationResult(to)` is deprecated and logs a warning (dist/experimental/index.js:1106-1111).
- `router.currentRoute` is a `ShallowRef<RouteLocationNormalizedLoaded>` — read it as `router.currentRoute.value` (dist/index-D7ja2BKs.d.ts:1433).
- `router.onReady()` does not exist (removed in v4); use `await router.isReady()`.
- `scrollBehavior` returns `{ top, left }` (v4 renamed `x`/`y` to `left`/`top`).
- Detect failed navigations: `const failure = await router.push(...)`; check with `isNavigationFailure(failure, NavigationFailureType.aborted)`.
- `route.meta` merges non-recursively from all matched records; read `to.meta.requiresAuth` directly instead of scanning `to.matched`. Type `meta` via `RouteMeta` module augmentation.
- Use `router.beforeResolve` (not `beforeEach`) for work that needs async components resolved.
- Use `inject()` inside guards to reach Pinia stores (supported since Vue 3.3).
- Decouple components from the router with route `props: true` or `props: route => ({ ... })`; pass query values this way to keep components testable.
- Watch narrow sources (`() => route.params.id`), never the whole `route` object.

Full core API notes: [references/core-api.md](./references/core-api.md).

## Typed routes

Enable by using the file-based routing plugin (types are generated automatically), or augment manually:

```ts
declare module 'vue-router' {
  interface TypesConfig {
    RouteNamedMap: RouteNamedMap
  }
}
```

Typed `push('/users/:id', { params: { id: 42 } })`, typed `useRoute()`, per-file typing via Volar plugin `vue-router/volar/sfc-typed-router`. Param parsers (`int`, `bool`, custom in `src/params/`) give typed, validated params; `definePage({ params: { query: { page: { parser: 'int', default: 1 } } } })` declares query params. Details: [references/typed-routes.md](./references/typed-routes.md).

## Data loaders (experimental)

```ts
// src/pages/users/[id].vue
import { defineBasicLoader } from 'vue-router/experimental'
import { reroute } from 'vue-router/experimental'

export const useUserData = defineBasicLoader(async (to) => {
  if (!to.params.id) reroute('/') // reroute throws: stops the loader immediately
  return fetchUser(to.params.id)
})
```

Install `DataLoaderPlugin` **before** the router: `app.use(DataLoaderPlugin, { router })`. Non-blocking loaders: `defineBasicLoader(loader, { lazy: true })`; errors then land in `error`, not in `router.onError`. Details: [references/data-loaders.md](./references/data-loaders.md).

## Version notes (5.0.x → 5.3.1)

- v5.0.7: `RouteNamedMap` is wired through the generated `typed-router.d.ts` (https://github.com/vuejs/router/releases/tag/v5.0.7); param parser folders gained `include`/`exclude`.
- v5.1.0: typed `definePage` `params.path`, `defineParamParserRaw`, strict default typing, `TypesConfig` global `Router` override, experimental export is ESM-only (https://github.com/vuejs/router/releases/tag/v5.1.0).
- v5.2.0: added diagnostics for common mistakes; allows pinia 4 (https://github.com/vuejs/router/releases/tag/v5.2.0).
- v5.3.0: scroll skips when `history.scrollRestoration` says so; duplicate `definePage()` reported instead of crashing; `EditableTreeNode.name` accepts `false` to unset (https://github.com/vuejs/router/releases/tag/v5.3.0).
- v5.3.1: fixes `isActive` with non-string params (https://github.com/vuejs/router/releases/tag/v5.3.1).

Migration from v3/v4, or from `unplugin-vue-router`: [references/migration.md](./references/migration.md).

## References

- [core-api.md](./references/core-api.md) — router creation, histories, guards, failures, scroll, RouterLink/RouterView.
- [file-based-routing.md](./references/file-based-routing.md) — plugin setup, file naming, `definePage`, `<route>` blocks, `extendRoute`, options.
- [typed-routes.md](./references/typed-routes.md) — `TypesConfig`, generated types, param parsers, `experimental_createRouter`.
- [data-loaders.md](./references/data-loaders.md) — `defineBasicLoader`, `defineColadaLoader`, `reroute`, lazy loaders, SSR notes.
- [migration.md](./references/migration.md) — v3→v4 and v4→v5 changes, deprecations in the v5 line.

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

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

Все скиллы по теме «Фронтенд и UI» →
clerk-vue-patterns clerk Скилл clerk-vue-patterns для Claude Code подсказывает, как связать Clerk с Vue 3. Он включается при работе с композаблами, защитой маршрутов и авторизацией через Pinia. CX Codex +1 14 700установок vue официальный github Задаёт стандарты разработки на Vue 3. Подключается как файл инструкций и направляет Copilot при работе с компонентами, реактивностью, Pinia и TypeScript. CX Codex +1 ★ 41 430звёзд репо vue-typescript Mindrally Скилл vue-typescript для Claude Code задаёт правила генерации кода на Vue 3 и TypeScript с Vite, Pinia и Tailwind, включая синтаксис и оптимизацию загрузки. CX Codex +1 832установок vue-expert 0xfurai Субагент vue-expert для Claude Code, заточенный под разработку на Vue.js. Помогает писать однофайловые компоненты, настраивать Vue Router и проектировать хранилище Vuex. CX Codex ★ 1 029звёзд репо vue-3-nuxt-3-typescript-cursorrules-prompt-file PatrickJS Правило vue-3-nuxt-3-typescript-cursorrules-prompt-file для Cursor задаёт стиль кода на Vue 3 и Nuxt 3: Composition API, TypeScript-интерфейсы, конвенции Nuxt. Помогает агенту писать код, согласованный с архитектурой проекта. CX Codex +1 ★ 41 178звёзд репо vue-router-best-practices github.com/vuejs-ai Скилл vue-router-best-practices для Claude Code обучает правилам Vue Router 4: навигационным гвардам, параметрам маршрутов и синхронизации с жизненным циклом компонента. Помогает избежать редиректов и утечек памяти. CX Codex +1 16 700установок

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

Весь набор →
vue-i18n-skilld Скилл vue-i18n-skilld для работы с vue-i18n в Vue 3: подсказывает синтаксис сообщений, плюрализацию, форматы дат и чисел, миграцию на v12. CX Codex +1 438установок vue-skilld Скилл vue-skilld помогает писать компоненты и композаблы на Vue 3.6. Направляет агента при переходе на Vapor Mode, настройке SSR и обновлении кода с версий 3.4–3.5. CX Codex +1 434установок vuetify-skilld Скилл vuetify-skilld настраивает агента на разработку с Vuetify 4.x под Vue 3. Помогает подключить компоненты, разрулить CSS-слои и мигрировать проект с третьей версии. CX Codex +1 421установок pinia-skilld Скилл pinia-skilld для ИИ-агентов, который подсказывает верные API Pinia 4.x: хранилища, геттеры, действия, SSR и миграцию с v2 и v3. CX Codex +1 349установок pinia-colada-skilld Скилл pinia-colada-skilld добавляет в Claude Code шаблоны и правила работы с @pinia/colada. Помогает настраивать выборку данных, мутации, сброс кэша и работу с SSR во Vue. CX Codex +1 240установок tanstack-vue-query-skilld Скилл tanstack-vue-query-skilld для Claude Code задаёт правила работы с @tanstack/vue-query v5. Помогает писать запросы и мутации в Vue 3 или Vue 2 без типичных ошибок с реактивностью. CX Codex +1 223установок vueuse-core-skilld Скилл vueuse-core-skilld с полным API @vueuse/core 15.0.0: новые composables, правила миграции с v14, устаревшие функции и требования окружения. CX Codex +1 219установок vee-validate-skilld Скилл vee-validate-skilld помогает писать, проверять и отлаживать формы Vue 3 с vee-validate 4.15.x. Даёт актуальные примеры Composition API, паттерны схем валидации, интеграцию typed-schema и решение типичных ошибок. CX Codex +1 188установок

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

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