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

components-build — скилл для Claude Code: компоненты React

Скилл components-build для Claude Code помогает создавать, проверять и перерабатывать переиспользуемые компоненты React по спецификации components.build. Он подключается к задачам об API компонентов, доступности, стилях и типах TypeScript.

MIT ★ 141 обновлён 2026-11-17

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

Что делает components-build

components-build задаёт правила проектирования компонентов React: от композиции и управления состоянием до доступности и публикации. В спецификации 16 категорий, включая клавиатурную навигацию, ARIA, полиморфизм через as, атрибуты data-state и стилизацию с Tailwind CSS и CVA.

Правила разбиты на отдельные файлы с объяснениями, примерами плохого и хорошего кода и типичными ошибками. Для общей версии руководства есть AGENTS.md; отдельные файлы находятся, например, в rules/composition/SKILL.md и rules/accessibility/SKILL.md. Скилл также охватывает документацию компонентов, реестры и публикацию в npm.

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

  • спроектировать API компонента и его типы TypeScript
  • разбить сложный компонент на составные части
  • добавить клавиатурную навигацию и ARIA
  • согласовать стили компонентов с Tailwind CSS и CVA
  • подготовить компоненты к публикации в реестре или npm

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

  • Создай составной компонент React с управляемым и внутренним состоянием.
  • Проверь клавиатурную доступность и ARIA у этих компонентов.
  • Переработай API компонента и типы его пропсов по правилам components.build.

Как установить components-build

1Через Skills CLI (Vercel)

npx skills add maxtrigify/Otto --skill components-build -a claude-code

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

~/.claude/skills/components-build/SKILL.md

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

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

Вопросы о components-build

Как установить components-build в Claude Code?

Выполни npx skills add maxtrigify/Otto --skill components-build -a claude-code. Файл скилла появится по пути ~/.claude/skills/components-build/SKILL.md.

Что делает components-build?

Скилл задаёт правила для разработки, проверки и переработки переиспользуемых компонентов React. Он охватывает композицию, доступность, состояния, типы, стилизацию и распространение компонентов.

Какие темы доступны в правилах components-build?

Среди тем — управление состоянием, полиморфные компоненты, паттерн Radix Slot, CSS-переменные для токенов и подготовка пакета к публикации в npm.

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

SKILL.md · MIT
---
name: components-build
description: Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.
license: MIT
metadata:
  author: components.build
  version: "1.0.0"
---

# Components.build Specification

Comprehensive guidelines for building modern, composable, and accessible UI components. Contains 16 rule categories covering everything from core principles to distribution, co-authored by Hayden Bleasel and shadcn.

## When to Apply

Reference these guidelines when:

- Creating new React components or component libraries
- Designing component APIs and prop interfaces
- Implementing accessibility features (keyboard, ARIA, focus management)
- Building composable component architectures
- Styling components with Tailwind CSS and CVA
- Publishing components to registries or npm

## Rule Categories by Priority

| Priority | Category | Focus | Prefix |
| --- | --- | --- | --- |
| 1 | Overview | Specification scope and goals | `overview` |
| 2 | Principles | Core design philosophy | `principles` |
| 3 | Definitions | Common terminology | `definitions` |
| 4 | Composition | Breaking down complex components | `composition` |
| 5 | Accessibility | Keyboard, screen readers, ARIA | `accessibility` |
| 6 | State | Controlled/uncontrolled patterns | `state` |
| 7 | Types | TypeScript props and interfaces | `types` |
| 8 | Polymorphism | Element switching with `as` prop | `polymorphism` |
| 9 | As-Child | Radix Slot composition pattern | `as-child` |
| 10 | Data Attributes | `data-state` and `data-slot` | `data-attributes` |
| 11 | Styling | Tailwind CSS, cn utility, CVA | `styling` |
| 12 | Design Tokens | CSS variables and theming | `design-tokens` |
| 13 | Documentation | Component documentation | `documentation` |
| 14 | Registry | Component registries | `registry` |
| 15 | NPM | Publishing to npm | `npm` |
| 16 | Marketplaces | Component marketplaces | `marketplaces` |

## Quick Reference

### 1. Overview

- `overview` - Specification scope, goals, and philosophy

### 2. Principles

- `principles` - Composability, accessibility, customization, transparency

### 3. Definitions

- `definitions` - Common terminology (primitive, compound, headless, etc.)

### 4. Composition

- `composition-root` - Root component with Context for shared state
- `composition-item` - Item wrapper components
- `composition-trigger` - Interactive trigger components
- `composition-content` - Content display components
- `composition-export` - Namespace export pattern

### 5. Accessibility

- `accessibility-semantic-html` - Use appropriate HTML elements
- `accessibility-keyboard` - Full keyboard navigation support
- `accessibility-aria` - Proper ARIA roles, states, and properties
- `accessibility-focus` - Focus management and restoration
- `accessibility-live-regions` - Screen reader announcements
- `accessibility-contrast` - Color contrast requirements

### 6. State

- `state-uncontrolled` - Internal state management
- `state-controlled` - External state delegation
- `state-controllable` - Support both patterns with useControllableState

### 7. Types

- `types-extend-html` - Extend native HTML attributes
- `types-export` - Export prop types for consumers
- `types-single-element` - One component wraps one element

### 8. Polymorphism

- `polymorphism-as-prop` - Change rendered element type
- `polymorphism-typescript` - Type-safe polymorphic components
- `polymorphism-defaults` - Semantic element defaults

### 9. As-Child

- `as-child-slot` - Radix Slot for prop merging
- `as-child-composition` - Compose with child components

### 10. Data Attributes

- `data-attributes-state` - Use `data-state` for styling states
- `data-attributes-slot` - Use `data-slot` for targeting sub-components

### 11. Styling

- `styling-cn-utility` - Combine clsx and tailwind-merge
- `styling-order` - Base → Variants → Conditionals → User overrides
- `styling-cva` - Class Variance Authority for variants
- `styling-css-variables` - Dynamic values with CSS variables

### 12. Design Tokens

- `design-tokens-css-variables` - Define tokens as CSS variables
- `design-tokens-theming` - Support light/dark modes and themes

### 13. Documentation

- `documentation-props` - Document all props with JSDoc
- `documentation-examples` - Provide usage examples

### 14. Registry

- `registry-structure` - Registry file structure
- `registry-schema` - Component metadata schema

### 15. NPM

- `npm-package-json` - Package configuration
- `npm-exports` - Module exports

### 16. Marketplaces

- `marketplaces-distribution` - Component distribution strategies

## How to Use

Read individual rule files for detailed explanations and code examples:

```
rules/composition/SKILL.md
rules/accessibility/SKILL.md
rules/styling/SKILL.md
```

Each rule file contains:

- Brief explanation of why it matters
- Incorrect code example with explanation
- Correct code example with explanation
- Best practices and common pitfalls

## Full Compiled Document

For the complete guide with all rules expanded: `AGENTS.md`

## Key Principles

1. **Composition over Configuration** - Break components into composable sub-components
2. **Accessibility by Default** - Not an afterthought, but a requirement
3. **Single Element Wrapping** - Each component wraps one HTML element
4. **Extend HTML Attributes** - Always extend native element props
5. **Export Types** - Make prop types available to consumers
6. **Support Both State Patterns** - Controlled and uncontrolled
7. **Intelligent Class Merging** - Use `cn()` utility with tailwind-merge

## Authors

Co-authored by:

- **Hayden Bleasel** ([@haydenbleasel](https://x.com/haydenbleasel))
- **shadcn** ([@shadcn](https://x.com/shadcn))

Adapted as an AI skill by:

- **Jordan Gilliam** ([@nolansym](https://x.com/nolansym))

Based on the [components.build](https://components.build) specification.

© components.build · MIT · maxtrigify/Otto

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

Все скиллы по теме «Фронтенд и UI» →
building-components vercel Скилл building-components помогает проектировать доступные UI-компоненты, их API, темы и документацию. CX Codex +1 15 400установок ui-design-system platform-team Скилл ui-design-system задаёт единые правила для UI в React/TypeScript: токены, отступы, типографику и доступность. Нужен при создании и ревью компонентов. CX Codex +1 124установок sort-components rerun-build Скилл sort-components для Claude Code распределяет UI-компоненты по папкам по их назначению. Активируется при добавлении компонента или пересортировке apps/ui/components/. CX Codex +1 ★ 1 120звёзд репо design-system-compound-components alexj11324 Правило design-system-compound-components для Claude Code запрещает передавать строки в невизуальные узлы без текстовой обёртки. Направляет агента делить интерфейс на составные элементы вроде ButtonText. CX Codex +1 ★ 88звёзд репо architecture-compound-components tech-leads-club Правило architecture-compound-components предлагает собирать сложные компоненты из частей с общим контекстом. Оно пригодится, когда монолитный компонент обрастает условиями и render props. CX Codex +1 ★ 7 191звёзд репо frontend-developer qdhenry Субагент frontend-developer создаёт и рефакторит React-компоненты на TypeScript, учитывая доступность, тесты и структуру проекта. Подключайте его для UI-задач. CX Codex ★ 1 357звёзд репо

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

Весь набор →
as-child Правило as-child для Claude Code объединяет свойства и обработчики компонента с дочерним элементом без лишней DOM-обёртки. Подключается при создании составных React-компонентов и trigger-элементов. CX Codex +1 ★ 141звёзд репо documentation Правило documentation для Claude Code задаёт единый стандарт описания компонентов интерфейса. Ассистент оформляет справку со свойствами, примерами и требованиями доступности. CX Codex +1 ★ 141звёзд репо state Правило state для Claude Code задаёт паттерны управляемого и неуправляемого состояния React-компонентов. Оно включается при проектировании API компонентов. CX Codex +1 ★ 141звёзд репо accessibility Правило accessibility для Claude Code задаёт стандарты доступности интерфейсов. Включается при верстке компонентов, форм и навигационных меню по WCAG. CX Codex +1 ★ 141звёзд репо polymorphism Правило polymorphism для Claude Code задаёт полиморфные React-компоненты с единым стилем и поведением. HTML-элемент меняется через проп as. CX Codex +1 ★ 141звёзд репо styling Правило styling для Claude Code задаёт стандарты вёрстки компонентов на Tailwind CSS. Направляет агента объединять классы через tailwind-merge, clsx и CVA. CX Codex +1 ★ 141звёзд репо definitions Правило definitions для Claude Code классифицирует UI-артефакты и задаёт точные названия для компонентов, блоков, шаблонов и паттернов. CX Codex +1 ★ 141звёзд репо otto-design Скилл otto-design для Claude Code задаёт процесс проектирования интерфейсов Otto в Paper перед сборкой в SwiftUI. Включается при запросах на мокапы, редизайн или изменение экранов и карточек приложения. CX Codex +1 ★ 141звёзд репо

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

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