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

ai-ui-generation — скилл для Claude Code: что делает и как установить

Скилл ai-ui-generation для Claude Code и Codex задаёт правила генерации, аудита и встраивания интерфейсных компонентов из нейросетей. Включается при сборке UI и подготовке визуального вывода MCP.

MIT 123 установок ★ 305 обновлён 2026-11-14

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

Что делает ai-ui-generation

Скилл координирует генерацию интерфейсов через json-render, v0.app, Google Stitch, Bolt Cloud и Cursor. Он распределяет сценарии: для типобезопасных каталогов и визуального вывода MCP первым выбирается json-render, для прототипов с бэкендом — Bolt Cloud, а для точечных правок в текущей кодовой базе — Cursor.

Внутрь заложены 8 правил по пяти категориям: шаблоны промптов с ограничениями по токенам и доступности, чеклист аудита из 10 пунктов и проверки для CI. Для генерации экранов через Google Stitch требуются MCP-инструменты generate_screen_from_text и get_screen, а также версия Claude Code не ниже 2.1.277+.

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

  • выбрать инструмент генерации интерфейса под конкретный сценарий
  • составить промпт для компонента с проверкой доступности и токенов
  • заменить сгенерированные hex-цвета на системные токены и компоненты
  • проверить сгенерированный фронтенд по чек-листу перед мержем в CI

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

  • Сгенерируй форму входа на React 19 с Tailwind v4 и токенами нашей дизайн-системы
  • Проверь сгенерированный компонент карточки по чеклисту доступности и токенов
  • Подготовь спецификацию json-render для вывода интерфейса через MCP

Как установить ai-ui-generation

1Через Skills CLI (Vercel)

npx skills add yonatangross/orchestkit --skill ai-ui-generation -a claude-code

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

~/.claude/skills/ai-ui-generation/SKILL.md

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

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

Вопросы об ai-ui-generation

Как установить ai-ui-generation в Claude Code?

Выполните команду npx skills add yonatangross/orchestkit --skill ai-ui-generation -a claude-code.

Что делает скилл ai-ui-generation?

Задаёт инженерные регламенты создания UI: формулирует промпты с учётом дизайн-системы, проверяет разметку на доступность и заменяет хардкод на токены.

Что нужно для работы со Stitch через этот скилл?

Платформа Claude Code версии 2.1.277+ и настроенный MCP-сервер Stitch с вызовами generate_screen_from_text и get_screen.

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

SKILL.md · MIT
---
name: ai-ui-generation
license: MIT
compatibility: "Claude Code 2.1.277+."
description: "AI UI generation with json-render, v0.app, Stitch, Bolt, and Cursor: prompt engineering, review checklists, design system conformance, CI gates. Use when generating UI components with AI tools, reviewing AI-generated code, or rendering MCP visual output."
user-invocable: false
metadata:
  owner-agent: "frontend-ui-developer"
  category: document-asset-creation
  version: "1.1.0"
  author: "OrchestKit"
  complexity: "medium"
  tags: "ai-ui, json-render, v0, v0-app, stitch, bolt, bolt-cloud, cursor, prompt-engineering, code-generation, design-tokens, component-generation, ai-review, shadcn-ui"
allowed-tools: "Read Glob Grep WebFetch WebSearch mcp__stitch__generate_screen_from_text mcp__plugin_hq-ext_stitch__generate_screen_from_text mcp__stitch__get_screen mcp__plugin_hq-ext_stitch__get_screen"
  # Stitch: body names generate_screen_from_text and get_screen.
  # Grant BOTH prefixes: standalone stitch (mcp__stitch__*) and hq-ext plugin
  # (mcp__plugin_hq-ext_stitch__*). See https://code.claude.com/docs/en/mcp-servers
---

# AI UI Generation

Patterns for generating, reviewing, and integrating UI components produced by AI tools (json-render, v0.app, Google Stitch, Bolt Cloud, Cursor). **json-render is the first choice** for multi-surface, MCP visual output, and type-safe catalog workflows. AI-generated UI is **80% boilerplate, 20% custom** — the human reviews, refactors, and owns the output. These rules ensure AI output meets design system, accessibility, and quality standards before shipping.

> **Tool landscape as of 2026-04:**
> - **v0.dev → v0.app** (Jan 2026 rebrand) — expanded from component scaffolding to full-stack app generation with shipping targets (Vercel, Cloudflare, Railway). v0.app MCP server (`@vercel/v0-mcp`) exposes generation as an MCP tool, so agents can call it programmatically.
> - **Google Stitch** — design-first generation via `stitch.withgoogle.com/docs/mcp`. Produces multi-screen apps (up to 5 interconnected screens) with React/HTML + PNG. Strong when input is a screenshot, URL, or DESIGN.md file.
> - **Bolt Cloud** (StackBlitz, 2026) — Bolt now runs the dev environment in the cloud (no local WebContainer). Integrates with GitHub and supports persistent databases. Best for full-stack prototypes with backend + deploy.
> - **v0.app** and **Stitch** both integrate with shadcn/ui styles; pair with the `shadcn apply <style>` CLI (v4) to reuse generated output.

## Quick Reference

| Category | Rules | Impact | When to Use |
|----------|-------|--------|-------------|
| [json-render Integration](#json-render-integration) | 1 | HIGH | Multi-surface output, MCP visual output, type-safe catalogs |
| [Prompt Engineering](#prompt-engineering) | 2 | HIGH | Writing prompts for component generation |
| [Quality Assurance](#quality-assurance) | 2 | CRITICAL/HIGH | Reviewing and gating AI-generated code |
| [Design System Integration](#design-system-integration) | 2 | HIGH | Injecting tokens, refactoring for conformance |
| [Tool Selection & Workflow](#tool-selection--workflow) | 2 | MEDIUM | Choosing the right AI tool, iterating prompts |

**Total: 8 rules across 5 categories**

## Decision Table — json-render vs v0.app vs Stitch vs Bolt Cloud vs Cursor

| Scenario | Tool | Why |
|----------|------|-----|
| Multi-surface / MCP visual output | json-render | Single catalog renders to any surface — FIRST CHOICE |
| Type-safe component catalog | json-render | Schema-driven specs with per-platform registries |
| Streaming UI from AI agents | json-render | Structured JSON specs render progressively |
| New component from scratch | v0.app | Full scaffold with shadcn/ui, Tailwind, a11y. Pair with `shadcn apply <style>` for style consistency |
| Full-stack app with deploy | v0.app | Jan 2026 expansion — routes, DB, auth, Vercel/Cloudflare deploy in one generation |
| Design-driven (screenshot/URL/DESIGN.md) | Google Stitch | `generate_screen_from_text` (once; no retry) + `get_screen(name="projects/{project}/screens/{screen}")` |
| Multi-screen flow from a visual source | Google Stitch | Strongest when grounded in an existing design |
| Full-stack prototype with persistent backend | Bolt Cloud | Cloud dev env, GitHub integration, databases |
| Incremental change in existing codebase | Cursor | Understands project context, imports, tokens |
| Refactor existing component | Cursor | Reads surrounding code, respects conventions |
| Explore visual design variations | v0.app or Stitch | v0.app for freeform, Stitch when grounded in a reference |
| Add feature to running app | Bolt Cloud | Cloud preview, full environment, persists between sessions |
| Fix bug in existing component | Cursor | Inline edits with full project awareness |

## Quick Start

### Structured Prompt Example

```
Generate a React signup form component using:
- Framework: React 19 + TypeScript
- Styling: Tailwind CSS v4 + shadcn/ui (Luma style — rounded-4xl, shadow-md elevation)
- Style: run `npx shadcn@latest apply luma` (CLI v4, Apr 2026) after generation
- Tokens: use color.primary, color.destructive, spacing.md from our design system
- A11y: ARIA labels on all inputs, error announcements via aria-live
- States: default, loading (disabled + spinner), error (inline messages), success
- Responsive: stack on mobile (<640px), 2-col on desktop
```

### Review Example — After AI Generation

```tsx
// AI generated: hardcoded hex value
<button className="bg-[#3b82f6] text-white px-4 py-2">Submit</button>

// After human review: design token applied
<Button variant="default" size="md">Submit</Button>
```

## Rule Details

### json-render Integration

json-render is the **first choice** for AI UI generation when output must render across multiple surfaces (web, mobile, CLI, MCP). Define a catalog of components once, generate JSON specs from AI, and render on any target surface. See `ork:json-render-catalog` for catalog authoring patterns.

| Rule | File | Key Pattern |
|------|------|-------------|
| json-render Patterns | `rules/json-render-patterns.md` | Catalog-first: define once, render anywhere via per-platform registries |

### Prompt Engineering

Structured prompts that specify framework, tokens, a11y, and states upfront.

| Rule | File | Key Pattern |
|------|------|-------------|
| Prompt Patterns | `rules/ai-prompt-patterns.md` | Constraint-first prompts with framework, tokens, a11y |
| Iteration Patterns | `rules/ai-iteration-patterns.md` | Multi-pass prompts for complex interactive states |

### Quality Assurance

Systematic review and CI gating for AI-generated components.

| Rule | File | Key Pattern |
|------|------|-------------|
| Review Checklist | `rules/ai-review-checklist.md` | 10-point checklist for every AI-generated component |
| CI Gate | `rules/ai-ci-gate.md` | Automated quality gates before merge |

### Design System Integration

Ensuring AI output uses design tokens and conforms to the design system.

| Rule | File | Key Pattern |
|------|------|-------------|
| Token Injection | `rules/ai-token-injection.md` | Pass token names in prompts, reject hardcoded values |
| Refactoring Conformance | `rules/ai-refactoring-conformance.md` | Steps to refactor raw AI output for design system |

### Tool Selection & Workflow

Choosing the right AI tool and iterating effectively.

| Rule | File | Key Pattern |
|------|------|-------------|
| Tool Selection | `rules/ai-tool-selection.md` | Match tool to use case: v0, Bolt, Cursor |
| Iteration Patterns | `rules/ai-iteration-patterns.md` | Iterative refinement for complex states |

## Key Principles

1. **Own the output** — AI generates a draft; the engineer reviews, refactors, and is accountable for what ships.
2. **Tokens over literals** — Never accept hardcoded colors, spacing, or typography values. Always map to design tokens.
3. **Constraint-first prompts** — Specify framework, tokens, shadcn style (Luma/Nova/etc.), a11y, and states upfront. Vague prompts produce vague output.
4. **Iterative refinement** — Complex components need 2-3 prompt passes: structure first, states second, polish third.
5. **CI is non-negotiable** — Every AI-generated component goes through the same CI pipeline as hand-written code.
6. **Accessibility by default** — Include a11y requirements in every prompt; verify with automated checks post-generation.

## Anti-Patterns (FORBIDDEN)

- **Shipping raw AI output** — Never merge AI-generated code without human review and design system refactoring.
- **Vague prompts** — "Make a nice form" produces inconsistent, non-conformant output. Always specify constraints.
- **Hardcoded hex/rgb values** — AI tools default to arbitrary colors. Replace with OKLCH design tokens.
- **Skipping CI for "simple" components** — AI-generated code has the same bug surface as hand-written code.
- **Using v0.app for incremental changes** — v0.app generates from scratch; use Cursor for changes within an existing codebase.
- **Single-pass complex components** — Multi-state components (loading, error, empty, success) need iterative prompting.
- **Trusting AI a11y claims** — AI tools add ARIA attributes inconsistently. Always verify with axe-core or Storybook a11y addon.

## Detailed Documentation

| Resource | Description |
|----------|-------------|
| [references/ai-ui-tool-comparison.md](references/ai-ui-tool-comparison.md) | json-render vs v0 vs Bolt vs Cursor vs Copilot comparison |
| [references/prompt-templates-library.md](references/prompt-templates-library.md) | Copy-paste prompt templates for common components |
| [references/ai-ui-failure-modes.md](references/ai-ui-failure-modes.md) | Top 10 failure modes and fixes |

## Related Skills

- `ork:json-render-catalog` — json-render catalog authoring, schema validation, and registry patterns
- `ork:mcp-visual-output` — MCP visual output rendering with json-render specs
- `ork:multi-surface-render` — Cross-platform rendering from a single component catalog
- `ork-extras:ui-components` — shadcn/ui component patterns and CVA variants
- `ork-extras:accessibility` — WCAG compliance, ARIA patterns, screen reader support
- `ork-extras:animation-motion-design` — Motion library animation patterns
- `ork-extras:responsive-patterns` — Responsive layout and container query patterns
- `ork:design-system-tokens` — Design token architecture and theming

© OrchestKit · MIT · yonatangross/orchestkit

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

Все скиллы по теме «Фронтенд и UI» →
w-v0 blockmatic-icebox Скилл w-v0 для Claude Code готовит промпт для v0.dev по текущему файлу, выделенному фрагменту и стеку проекта. Ссылка открывается только после команды OPEN. CX Codex +1 647установок design-md официальный google-labs-code Скилл выгружает экраны из Google Stitch через MCP-сервер и собирает файл DESIGN.md с описанием дизайн-системы, цветов и компонентов. CX Codex +1 67 200установок enhance-prompt официальный google-labs-code Скилл enhance-prompt для Claude Code превращает расплывчатую идею интерфейса в структурированный промпт для Stitch. Запускается, когда нужно уточнить запрос или исправить результат генерации. CX Codex +1 60 600установок brand-landingpage Travis D. Elliott Скилл brand-landingpage для Claude Code проводит интервью о продукте и визуальном стиле, затем помогает создать лендинг через Stitch. Создаёт лендинг для проекта без готового дизайна. CX Codex +1 39 476установок codegen vercel-labs Скилл codegen для Claude Code генерирует код из json-render UI-деревьев. Помогает создавать кастомные экспортеры для Next.js, Remix и других фреймворков, обходить спеки и сериализовать пропсы. CX Codex +1 8 900установок design-loop jezweb Скилл design-loop ведёт цикл: читает задачу из файла-эстафеты, генерирует страницу в HTML/Tailwind, встраивает её в сайт и пишет следующую задачу. CX Codex +1 1 000установок

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

Весь набор →
prioritization Скилл prioritization для ранжирования задач бэклога методами RICE, WSJF, ICE, MoSCoW и анализом альтернативных издержек. Агент подсчитывает баллы, строит сравнительные таблицы и обосновывает выбор между конкурирующими фичами. CX Codex +1 125установок competitive-analysis Скилл competitive-analysis формирует анализ рынка по пяти силам Портера, SWOT-матрицы, профили конкурентов и карты позиционирования. Включается при оценке ниши или подготовке сейлз-батлкард. CX Codex +1 125установок visualize-plan Скилл visualize-plan показывает план изменений в виде схемы «до и после», карты рисков и порядка выполнения. Запускается при разборе плана или изменений в текущей ветке. CX Codex +1 124установок market-sizing Скилл market-sizing считает TAM, SAM и SOM двумя методами — top-down и bottom-up — и сверяет их. Запускается при подготовке слайдов для питча или оценке размера рынка. CX Codex +1 124установок product-analytics Скилл product-analytics разбирает A/B-тесты, удержание когорт и воронки, чтобы принять решение по эксперименту или найти провал конверсии. CX Codex +1 120установок testing-perf Скилл testing-perf для Claude Code выполняет нагрузочные тесты через k6 и Locust и распараллеливает pytest с xdist. Включается при написании load-тестов или ускорении прогона набора тестов. CX Codex +1 120установок chain-patterns Скилл chain-patterns собирает паттерны для многофазных пайплайнов: обнаружение MCP, handoff-файлы, возобновление после сбоя и изолированные worktree-агенты. CX Codex +1 118установок design-to-code Скилл design-to-code для Claude Code преобразует скриншоты, текстовые описания и URL страниц в компоненты React. Запускается при вёрстке интерфейсов по макетам с повторным использованием готовых блоков проекта. CX Codex +1 116установок

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

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