nuxt-studio — скилл для Claude Code: редактор Nuxt Content
Помогает настроить self-hosted Nuxt Studio: авторизацию, медиа, черновики и публикацию через Git. Пригодится, когда контент-редактор надо поднять на своём домене.
npx skills add onmax/nuxt-skills --skill nuxt-studio -a claude-codeЧто делает nuxt-studio
Скилл разводит зоны ответственности: Nuxt Studio отвечает за редактирование и публикацию, Nuxt Content — за коллекции, запросы, парсинг и рендеринг. Агент сначала смотрит установленные версии nuxt-studio и @nuxt/content, режим деплоя, провайдера репозитория и провайдера авторизации. Настройка считается понятной, когда маршрут редактора, Git-цель и callback логина указывают на один и тот же деплой.
Дальше скилл ведёт по трём справочникам: конфигурация (установка, настройки репозитория, OAuth или своя авторизация, фильтры редактора, переменные окружения), live editing (визуальное и MDC-редактирование, формы схем, черновики, медиа, помощь ИИ) и деплой (SSR, публикация через Git, стратегия веток, конфликты, монорепозитории). Изменения коллекций и схем остаются на стороне скилла nuxt-content.
Базовый запуск — npx nuxt module add nuxt-studio, модуль прописывается в modules вместе с @nuxt/content, а в блоке studio.repository указываются провайдер, владелец, репозиторий и ветка. Редактор живёт на /_studio. Учтите: провайдеры CI могут вывести метаданные репозитория сами, но учётные данные авторизации остаются явными секретами деплоя — для GitHub это NUXT_STUDIO_AUTH_GITHUB_CLIENT_ID и NUXT_STUDIO_AUTH_GITHUB_CLIENT_SECRET. Проверять стоит в два шага: сначала локальное редактирование по файловой системе, потом продовый логин и один цикл публикации на деплое с поддержкой SSR.
Какие задачи решает
- подключить self-hosted редактор контента к проекту на Nuxt Content
- настроить вход через GitHub OAuth или свою авторизацию
- раздать редакторам визуальное и MDC-редактирование с формами схем
- провести черновик от правки до коммита в нужную ветку
- разобраться с конфликтами и монорепозиторием при публикации через Git
Примеры запросов агенту
- Подключи nuxt-studio к проекту на Nuxt Content и настрой репозиторий на GitHub
- Настрой OAuth-вход в Nuxt Studio и переменные окружения для продакшена
- Проверь цикл публикации: черновик, коммит в main, пересборка сайта
Как установить nuxt-studio
1Через Skills CLI (Vercel)
npx skills add onmax/nuxt-skills --skill nuxt-studio -a claude-code2Вручную: положить файлы
~/.claude/skills/nuxt-studio/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/nuxt-studio/
1Через Skills CLI (Vercel)
npx skills add onmax/nuxt-skills --skill nuxt-studio -a codex2Вручную: положить файлы
.agents/skills/nuxt-studio/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add onmax/nuxt-skills --skill nuxt-studio -a cursor2Вручную: положить файлы
.cursor/skills/nuxt-studio/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install onmax/nuxt-skills nuxt-studio2Вручную: положить файлы
.github/skills/nuxt-studio/SKILL.md1Через Skills CLI (Vercel)
npx skills add onmax/nuxt-skills --skill nuxt-studio -a gemini-cli2Командой платформы
gemini skills install https://github.com/onmax/nuxt-skills --path skills/nuxt-studioВручную: положить файлы
.devin/skills/nuxt-studio/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add onmax/nuxt-skills --skill nuxt-studio -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о nuxt-studio
Как установить nuxt-studio в Claude?
Выполните npx skills add onmax/nuxt-skills --skill nuxt-studio -a claude-code. Скилл появится по пути ~/.claude/skills/nuxt-studio/SKILL.md.
Что делает скилл nuxt-studio?
Проводит по настройке и работе self-hosted Nuxt Studio для Nuxt Content: установка, настройки репозитория, OAuth или своя авторизация, медиа, черновики, публикация через Git и деплой на SSR.
Что нужно для работы Nuxt Studio?
Модуль nuxt-studio рядом с @nuxt/content и явные учётные данные авторизации в секретах деплоя. Для GitHub это NUXT_STUDIO_AUTH_GITHUB_CLIENT_ID и NUXT_STUDIO_AUTH_GITHUB_CLIENT_SECRET.
Исходный текст
SKILL.md · MIT
---
name: nuxt-studio
description: Configure and operate the self-hosted Nuxt Studio editor for Nuxt Content. Use when working with nuxt-studio installation, editor customization, OAuth or custom authentication, media, drafts, Git publishing, or production deployment.
license: MIT
---
# Nuxt Studio
Nuxt Studio owns content editing and publishing. Nuxt Content owns collections, queries, parsing, and rendering.
## Workflow
1. Inspect the installed `nuxt-studio` and `@nuxt/content` versions, deployment mode, repository provider, and authentication provider. Setup is understood when the editor route, Git target, and login callback all point at the same deployment.
2. Open the smallest matching guide below and keep collection/schema changes within the `nuxt-content` boundary.
3. Verify local editing against the filesystem, then verify production login and one publish cycle on an SSR-capable deployment. The work is complete when the commit reaches the configured branch and the rebuilt site exposes it.
## Routing
| Task | Open |
| ----------------------------------------------------------------------------------------- | -------------------------------------------- |
| Install, repository settings, OAuth/custom auth, editor filters, or environment variables | [Configuration](references/configuration.md) |
| Visual/MDC editing, schema forms, drafts, media, or AI assistance | [Live editing](references/live-editing.md) |
| SSR deployment, Git publishing, branch strategy, conflicts, or monorepos | [Deployment](references/deployment.md) |
| Collections, validators, queries, hooks, or rendering | `nuxt-content` skill |
## Baseline
```bash
npx nuxt module add nuxt-studio
```
```ts
export default defineNuxtConfig({
modules: ['@nuxt/content', 'nuxt-studio'],
studio: {
repository: {
provider: 'github',
owner: 'your-org',
repo: 'your-repo',
branch: 'main',
},
},
})
```
```bash
NUXT_STUDIO_AUTH_GITHUB_CLIENT_ID=<client-id>
NUXT_STUDIO_AUTH_GITHUB_CLIENT_SECRET=<client-secret>
```
Studio runs at `/_studio` by default. Supported CI providers can infer repository metadata, but authentication credentials remain explicit deployment secrets.
© onmax · MIT · onmax/nuxt-skills