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

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

Скилл unhead-vue-skilld помогает ИИ-агенту настраивать теги head, метаданные SEO и скрипты в проектах на Vue 3 через библиотеку @unhead/vue.

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

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

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

Скилл содержит правила и шаблоны кода для @unhead/vue версии 3.4.1. Он направляет агента при настройке SSR, гидратации в браузере, потокового рендеринга и бандлеров на базе Vite или Webpack. В базу включены примеры использования композаблов useHead, useSeoMeta, useHeadSafe и useScript.

В инструкциях зафиксированы частые ошибки и изменения API. Например, функция createHead теперь импортируется строго из подпутей @unhead/vue/client или @unhead/vue/server, а не из корня пакета. Скилл также предотвращает дублирование тегов: напоминает использовать параметр key вместо устаревших hid и запрещает вызывать useHead внутри колбэков вотчеров.

Для работы требуется vue >= 3.5.18 и формат ESM; CommonJS и Vue 2 не поддерживаются. Если вы пишете приложение на Nuxt, ставить этот скилл бессмысленно: Unhead уже встроен в фреймворк из коробки.

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

  • настроить создание экземпляра head для клиента и SSR во Vue 3
  • прописать реактивные метатеги Open Graph и Twitter с помощью useSeoMeta
  • исправить ошибку provide context при асинхронном вызове useHead
  • подключить сторонние аналитические скрипты через useScript без блокировки загрузки
  • очистить ненадёжные метаданные от XSS через useHeadSafe

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

  • Настрой серверный рендеринг head через @unhead/vue/server для нашего SSR-шаблона
  • Добавь разметку Open Graph для карточки товара с помощью useSeoMeta
  • Исправь дублирование метатегов при переключении динамических маршрутов

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы об unhead-vue-skilld

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

Выполните в терминале команду npx skills add skilld-dev/vue-ecosystem-skills --skill unhead-vue-skilld -a claude-code.

Зачем нужен этот скилл?

Он даёт модели знания об актуальном синтаксисе @unhead/vue 3.x, предотвращая генерацию устаревших конструкций из версий 1 и 2.

Можно ли применять его в проектах на Nuxt?

Нет. В Nuxt библиотека Unhead интегрирована по умолчанию и не требует отдельной настройки плагина.

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

SKILL.md · MIT
---
name: unhead-vue-skilld
description: Full-stack <head> manager for Vue (@unhead/vue 3.x). Use when writing, reviewing, or debugging code that imports @unhead/vue, calls useHead, useSeoMeta, useHeadSafe, useScript, injectHead, createHead, or sets up Unhead SSR / streaming SSR / build plugins in a Vue app.
license: MIT
---

# @unhead/vue 3.4.1

Full-stack `<head>` management for Vue 3. ESM only (`"type": "module"`), no CJS.
Peer deps: `vue >= 3.5.18`; optional `vite >= 6.4.2`, `webpack >= 5.0.0` (source: `package.json:138-150`).
Vue 2: not supported; use `@unhead/vue@^1`.
Nuxt: Unhead is integrated already; do not install or set it up manually.

## Setup (mandatory)

Install `@unhead/vue`, create the head instance, and register it as a Vue plugin. `createHead` comes from a subpath export, not the package root.

```ts
// entry-client.ts (SPA or hydration)
import { createHead } from '@unhead/vue/client'
import { createApp } from './main'

const { app } = createApp()
const head = createHead()
app.use(head)
app.mount('#app')
```

```ts
// entry-server.ts (SSR)
import { createHead } from '@unhead/vue/server'
import { renderToString } from 'vue/server-renderer'
import { createApp } from './main'

export async function render(url: string) {
  const { app } = createApp()
  const head = createHead()
  app.use(head)
  const html = await renderToString(app)
  return { html, head } // render tags later with transformHtmlTemplate(head, template)
}
```

Full SSR template wiring, streaming SSR, Options API, and auto-imports: [references/setup.md](references/setup.md).

## Composables

All imported from `@unhead/vue` root and used inside `setup()`:

```vue
<script setup lang="ts">
import { useHead, useSeoMeta } from '@unhead/vue'

useHead({
  title: () => `${user.value.name} - Profile`, // getters, refs, computed all reactive
  titleTemplate: '%s | My Site',
  meta: [{ name: 'description', content: () => description.value }],
})

useSeoMeta({ // flat, type-safe keys; og/twitter handled automatically
  ogTitle: 'My Page',
  ogImage: 'https://example.com/image.jpg',
})
</script>
```

```ts
// Third-party scripts
import { useScript } from '@unhead/vue'

const { proxy, onLoaded, status } = useScript(
  { src: 'https://example.com/analytics.js' },
  { use: () => window.analytics, trigger: 'client' },
)
proxy.track('pageview') // queued until the script loads
```

Details, options tables, and recipes: [references/composables.md](references/composables.md).

## Critical rules

1. **Async context**: calling `useHead()` after an `await` inside `onMounted()`/watchers throws `useHead() was called without provide context`. Fix, in order of preference: top-level `await` in `<script setup>`; declare `useHead()` once with refs/computed and update the ref later; capture `const head = injectHead()` at setup time and pass `useHead(input, { head })`. Source: https://unhead.unjs.io/docs/vue/head/guides/core-concepts/reactivity-and-context
2. **Never call `useHead()` inside a watcher callback**: each call pushes a new entry and duplicates tags. Pass the reactive value into one `useHead()` call instead.
3. **Deduplication key is `key`**, not `hid`/`vmid`: `meta: [{ key: 'description', name: 'description', content: '...' }]`.
4. **Inline content**: `innerHTML` (was `children` in v1); body scripts use `tagPosition: 'bodyClose'` (was `body: true`).
5. **Untrusted input**: use `useHeadSafe()`; it whitelists attributes and strips scripts/handlers.
6. **Head instance access in Vue**: use `injectHead()` from `@unhead/vue`, not `getActiveHead()` from `unhead`; only the former binds to component context (e.g. `onServerPrefetch`).

## Deprecated in 3.4.1 (present but slated for removal)

| Export | Status | Replacement |
|---|---|---|
| `useServerHead`, `useServerHeadSafe`, `useServerSeoMeta` | deprecated (`dist/index.d.ts:26-30`) | `useHead` / `useHeadSafe` / `useSeoMeta` |
| `@unhead/vue/legacy` (`createHead`, `createServerHead`, `legacyPlugins`) | deprecated, removed in v4 (`dist/legacy.d.ts:14-30`) | `@unhead/vue/client` / `@unhead/vue/server` |
| `resolveUnrefHeadInput` | deprecated (`dist/utils.d.ts:9`) | `resolveTags(head)` from `unhead/utils` |
| `unheadVuePlugin` from `@unhead/vue/stream/vite` | deprecated (`dist/stream/vite.d.ts:8`) | `Unhead({ streaming: true }).vite()` from `@unhead/vue/bundler` |
| `MergeHead` type | deprecated (`dist/types.d.ts:66`) | generics on `VueHeadClient` |

Removed in v3 (will not compile): `DeprecationsPlugin`, `setHeadInjectionHandler`, `createHeadCore`, `{ mode: 'server' | 'client' }` entry option, `init`/`dom:renderTag`/`dom:rendered` hooks, `headEntries()` (use `[...head.entries.values()]`).
Migration details: [references/migration.md](references/migration.md).

## Export map

| Subpath | Purpose |
|---|---|
| `@unhead/vue` | composables: `useHead`, `useSeoMeta`, `useHeadSafe`, `useScript`, `injectHead`, `VueHeadMixin`, `unheadVueComposablesImports`, `createUnhead`, `defineLink`, `defineScript` |
| `@unhead/vue/client` | `createHead()` (SPA/hydration), `renderDOMHead`, `VueHeadMixin` |
| `@unhead/vue/server` | `createHead()` (SSR), `renderSSRHead`, `transformHtmlTemplate`, `propsToString` |
| `@unhead/vue/components` | `<Head>` component |
| `@unhead/vue/plugins` | re-exports `unhead/plugins` (`TemplateParamsPlugin`, `AliasSortingPlugin`, `PromisePlugin`, `InferSeoMetaPlugin`, `ValidatePlugin`, ...) |
| `@unhead/vue/bundler` | unified build plugin `Unhead()` for vite/webpack/rspack/rollup |
| `@unhead/vue/vite` | Vite-only `Unhead()`; prefer `/bundler` |
| `@unhead/vue/stream/server`, `/stream/client` | `createStreamableHead()` for streaming SSR |
| `@unhead/vue/types`, `/utils`, `/scripts`, `/legacy` | types, utilities, script types, legacy shims |

Signatures and full type surface: [references/api-surface.md](references/api-surface.md).

## Optional plugins at creation

Template params (`%s`, `%separator`), alias sorting (`before:`/`after:`), and Promise inputs are opt-in since v2:

```ts
import { createHead } from '@unhead/vue/client'
import { AliasSortingPlugin, TemplateParamsPlugin } from '@unhead/vue/plugins'

const head = createHead({ plugins: [TemplateParamsPlugin, AliasSortingPlugin] })
```

Without `TemplateParamsPlugin`, `%siteName` placeholders render literally.

## Build plugin (recommended for standalone Vue apps)

```ts
// vite.config.ts
import { Unhead } from '@unhead/vue/bundler'

export default defineConfig({
  plugins: [vue(), Unhead()], // add { streaming: true } for streaming SSR
})
```

Tree-shakes server-only composables from the client bundle, converts `useSeoMeta()` to `useHead()` (~3kb), injects `ValidatePlugin` in dev. Options table and webpack notes: [references/build-plugins.md](references/build-plugins.md).

## Common mistakes

- Importing `createHead` from `@unhead/vue` root (removed in v2): use `/client` or `/server`.
- Awaiting `renderSSRHead` / `renderDOMHead`: both are synchronous in v3.
- `useScript()` return is not a Promise: use `onLoaded(() => ...)`; call APIs through `.proxy`.
- Meta tags require `content`: `{ name: 'description', content: null }` removes the tag.
- Font preloads require `crossorigin`: `{ rel: 'preload', as: 'font', href: '/f.woff2', crossorigin: 'anonymous' }`.

## References

- [references/setup.md](references/setup.md) — SPA, SSR, streaming SSR, Options API, `<Head>` component, auto-imports, defaults
- [references/composables.md](references/composables.md) — `useHead`, `useSeoMeta`, `useHeadSafe`, `useScript` usage and options
- [references/api-surface.md](references/api-surface.md) — export map, types, instance API
- [references/build-plugins.md](references/build-plugins.md) — `Unhead()` bundler plugin and streaming
- [references/migration.md](references/migration.md) — v2 and v3 breaking changes

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

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

Все скиллы по теме «Фронтенд и UI» →
vue-typescript Mindrally Скилл vue-typescript для Claude Code задаёт правила генерации кода на Vue 3 и TypeScript с Vite, Pinia и Tailwind, включая синтаксис и оптимизацию загрузки. CX Codex +1 832установок 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-debug-guides github.com/vuejs-ai Скилл vue-debug-guides для диагностики ошибок Vue 3: реактивность, watchers, компоненты, шаблоны и hydration. Когда агент видит баг во Vue-проекте, он находит причину по каталогу типовых проблем. CX Codex +1 28 400установок 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-expert-js https://github.com/Jeffallan Скилл vue-expert-js для Claude Code создаёт код Vue 3 на JavaScript с JSDoc-аннотациями вместо TypeScript. Создаёт компоненты, композаблы, роутинг и состояние в проектах без TS. CX Codex +1 4 400установок capacitor-vue capawesome-team Скилл capacitor-vue помогает внедрять нативные плагины Capacitor в проекты на Vue 3, Quasar и Nuxt с помощью Composition API и реактивных композаблов. CX Codex +1 1 200установок

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

Весь набор →
floating-ui-vue-skilld Скилл floating-ui-vue-skilld помогает писать позиционирование всплывающих окон, тултипов и меню через @floating-ui/vue 2.0.1 во Vue 3.3+. CX Codex +1 119установок vue-data-ui-skilld Скилл vue-data-ui-skilld помогает агенту работать с библиотекой графиков vue-data-ui для Vue 3: выбирать компоненты, настраивать темы и разбирать ошибки. CX Codex +1 118установок unovis-vue-skilld Скилл unovis-vue-skilld для Claude Code помогает писать и отлаживать код на Vue 3 с компонентами @unovis/vue. Используется для построения графиков и обновления интеграции с Unovis 1.7.0. CX Codex +1 112установок vitepress-skilld Скилл vitepress-skilld даёт агенту справочник по API, настройкам и CLI VitePress 1.6.4 при сборке сайтов документации. CX Codex +1 110установок tanstack-ai-vue-skilld Скилл tanstack-ai-vue-skilld помогает писать и отлаживать Vue 3-код с @tanstack/ai-vue: чат, генерация медиа и типизированные инструменты. CX Codex +1 110установок formkit-core-skilld Скилл formkit-core-skilld для Claude Code помогает писать, отлаживать и проверять код для @formkit/core: узлов, значений, событий и хуков. CX Codex +1 105установок tanstack-vue-router-skilld Скилл tanstack-vue-router-skilld для работы с @tanstack/vue-router — типобезопасным роутером Vue. Учит агента правилам настройки, file-based маршрутов, композаблов с Ref, линков и лоадеров. CX Codex +1 101установок tanstack-vue-store-skilld Скилл tanstack-vue-store-skilld для Claude Code направляет агента при разработке стейт-менеджмента на @tanstack/vue-store в проектах на Vue. Подключается при импорте библиотеки и настройке хранилищ. CX Codex +1 100установок

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

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