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

ai-elements · existential-birds — скилл для Claude Code: React-компоненты для ИИ-интерфейсов

Скилл ai-elements для Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode: помогает собирать интерфейсы чата, очереди задач, отображение инструментов и подтверждений.

Apache-2.0 211 установок ★ 89 обновлён 2026-09-15

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

Что делает ai-elements

Агент знает библиотеку из 30+ React-компонентов для вывода сообщений, прикреплённых файлов, ввода с автозаполнением, визуализации работы инструментов и очередей задач. Компоненты устроены как композиция примитивов: Tool собирается из ToolHeader, ToolInput и ToolOutput; Queue — из QueueSection, QueueItem и индикаторов. Импорты идут из отдельных файлов под @/components/ai-elements/, общего бочкового файла нет.

Часть компонентов зависит от версии Vercel AI SDK: состояния approval-requested и approval-responded есть только в SDK v6. Для PromptInput доступна загрузка файлов с drag-and-drop, ограничениями по типу, размеру и числу вложений. Conversation включает авто-прокрутку к новым сообщениям и паузу при ручной прокрутке вверх.

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

  • собрать чат-интерфейс с сообщениями и прикреплёнными файлами
  • показать очередь задач с состоянием выполнения и группировкой
  • вывести выполнение инструментов с коллапсом и состояниями (input-streaming, output-available, output-error)
  • добавить поле ввода с автозаполнением, drag-and-drop файлов и ограничениями
  • визуализировать граф workflow через ReactFlow с кастомными узлами

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

  • Добавь компонент Conversation для вывода списка сообщений с авто-прокруткой
  • Подключи PromptInput с ограничением на 3 файла размером до 5 МБ и типом .png
  • Выведи компонент Tool в состоянии output-available для результата выполнения поиска

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

1Через Skills CLI (Vercel)

npx skills add existential-birds/beagle --skill ai-elements -a claude-code

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

~/.claude/skills/ai-elements/SKILL.md

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

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

Вопросы об ai-elements

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

Выполни npx skills add existential-birds/beagle --skill ai-elements -a claude-code. Скилл появится в файле ~/.claude/skills/ai-elements/SKILL.md.

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

Предоставляет агенту знания о 30+ React-компонентах для чат-интерфейсов, вывода инструментов, очередей задач и ввода с вложениями. Компоненты строятся композицией примитивов и работают со светлой и тёмной темами shadcn/ui.

Что нужно для работы ai-elements?

Установленные компоненты через npx shadcn@latest add https://ai-elements.vercel.app/r/[имя-компонента]. Для компонентов Tool и Confirmation с состояниями подтверждения понадобится Vercel AI SDK v6.

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

SKILL.md · Apache-2.0
---
name: ai-elements
description: Vercel AI Elements for workflow UI components. Use when building chat interfaces, displaying tool execution, showing reasoning/thinking, or creating job queues. Triggers on ai-elements, Queue, Confirmation, Tool, Reasoning, Shimmer, Loader, Message, Conversation, PromptInput.
---

# AI Elements

AI Elements is a comprehensive React component library for building AI-powered user interfaces. The library provides 30+ components specifically designed for chat interfaces, tool execution visualization, reasoning displays, and workflow management.

## Installation

Install via shadcn registry:

```bash
npx shadcn@latest add https://ai-elements.vercel.app/r/[component-name]
```

**Import Pattern**: Components are imported from individual files, not a barrel export:

```tsx
// Correct - import from specific files
import { Conversation } from "@/components/ai-elements/conversation";
import { Message } from "@/components/ai-elements/message";
import { PromptInput } from "@/components/ai-elements/prompt-input";

// Incorrect - no barrel export
import { Conversation, Message } from "@/components/ai-elements";
```

## Gates (before relying on examples)

Use this sequence when adding or wiring AI Elements so setup is checkable, not assumed.

1. **Install each component** — Run `npx shadcn@latest add https://ai-elements.vercel.app/r/[component-name]` for every component you need.
   - **Pass:** The command completes successfully and a file for that component exists under your project’s `components/ai-elements/` (or the directory `components.json` uses for those additions).

2. **Align import paths** — Every `import … from "@/components/ai-elements/..."` must match your repo’s actual alias and folder layout.
   - **Pass:** Each import resolves to a file on disk (IDE navigation or build/`tsc` shows no “cannot find module” for those paths).

3. **Match `Tool` / `Confirmation` states to your AI SDK** — State strings (including approval-related states) depend on the installed `ai` package major/version.
   - **Pass:** The states you pass to `ToolHeader`, `Tool`, or `Confirmation` are listed in the AI SDK version you have installed (docs or exported types), not copied from memory alone.

## Component Categories

### Conversation Components
Components for displaying chat-style interfaces with messages, attachments, and auto-scrolling behavior.

- **Conversation**: Container with auto-scroll capabilities
- **Message**: Individual message display with role-based styling
- **MessageAttachment**: File and image attachments
- **MessageBranch**: Alternative response navigation

See [references/conversation.md](references/conversation.md) for details.

### Prompt Input Components
Advanced text input with file attachments, drag-and-drop, speech input, and state management.

- **PromptInput**: Form container with file handling
- **PromptInputTextarea**: Auto-expanding textarea
- **PromptInputSubmit**: Status-aware submit button
- **PromptInputAttachments**: File attachment display
- **PromptInputProvider**: Global state management

See [references/prompt-input.md](references/prompt-input.md) for details.

### Workflow Components
Components for displaying job queues, tool execution, and approval workflows.

- **Queue**: Job queue container
- **QueueItem**: Individual queue items with status
- **Tool**: Tool execution display with collapsible states
- **Confirmation**: Approval workflow component
- **Reasoning**: Collapsible thinking/reasoning display

See [references/workflow.md](references/workflow.md) for details.

### Visualization Components
ReactFlow-based components for workflow visualization and custom node types.

- **Canvas**: ReactFlow wrapper with aviation-specific defaults
- **Node**: Custom node component with handles
- **Edge**: Temporary and Animated edge types
- **Controls, Panel, Toolbar**: Navigation and control elements

See [references/visualization.md](references/visualization.md) for details.

## Integration with shadcn/ui

AI Elements is built on top of shadcn/ui and integrates seamlessly with its theming system:

- Uses shadcn/ui's design tokens (colors, spacing, typography)
- Respects light/dark mode via CSS variables
- Compatible with shadcn/ui components (Button, Card, Collapsible, etc.)
- Follows shadcn/ui's component composition patterns

## Key Design Patterns

### Component Composition
AI Elements follows a composition-first approach where larger components are built from smaller primitives:

```tsx
<Tool>
  <ToolHeader title="search" type="tool-call-search" state="output-available" />
  <ToolContent>
    <ToolInput input={{ query: "AI tools" }} />
    <ToolOutput output={results} errorText={undefined} />
  </ToolContent>
</Tool>
```

### Context-Based State
Many components use React Context for state management:

- `PromptInputProvider` for global input state
- `MessageBranch` for alternative response navigation
- `Confirmation` for approval workflow state
- `Reasoning` for collapsible thinking state

### Controlled vs Uncontrolled
Components support both controlled and uncontrolled patterns:

```tsx
// Uncontrolled (self-managed state)
<PromptInput onSubmit={handleSubmit} />

// Controlled (external state)
<PromptInputProvider initialInput="">
  <PromptInput onSubmit={handleSubmit} />
</PromptInputProvider>
```

## Tool State Machine

The Tool component follows the Vercel AI SDK's state machine:

1. `input-streaming`: Parameters being received
2. `input-available`: Ready to execute
3. `approval-requested`: Awaiting user approval (SDK v6)
4. `approval-responded`: User responded (SDK v6)
5. `output-available`: Execution completed
6. `output-error`: Execution failed
7. `output-denied`: Approval denied

## Queue Patterns

Queue components support hierarchical organization:

```tsx
<Queue>
  <QueueSection defaultOpen={true}>
    <QueueSectionTrigger>
      <QueueSectionLabel count={3} label="tasks" icon={<Icon />} />
    </QueueSectionTrigger>
    <QueueSectionContent>
      <QueueList>
        <QueueItem>
          <QueueItemIndicator completed={false} />
          <QueueItemContent>Task description</QueueItemContent>
        </QueueItem>
      </QueueList>
    </QueueSectionContent>
  </QueueSection>
</Queue>
```

## Auto-Scroll Behavior

The Conversation component uses the `use-stick-to-bottom` hook for intelligent auto-scrolling:

- Automatically scrolls to bottom when new messages arrive
- Pauses auto-scroll when user scrolls up
- Provides scroll-to-bottom button when not at bottom
- Supports smooth and instant scroll modes

## File Attachment Handling

PromptInput provides comprehensive file handling:

- Drag-and-drop support (local or global)
- Paste image/file support
- File type validation (accept prop)
- File size limits (maxFileSize prop)
- Maximum file count (maxFiles prop)
- Preview for images, icons for files
- Automatic blob URL to data URL conversion on submit

## Speech Input

The PromptInputSpeechButton uses the Web Speech API for voice input:

- Browser-based speech recognition
- Continuous recognition mode
- Interim results support
- Automatic text insertion into textarea
- Visual feedback during recording

## Reasoning Auto-Collapse

The Reasoning component provides auto-collapse behavior:

- Opens automatically when streaming starts
- Closes 1 second after streaming ends
- Tracks thinking duration in seconds
- Displays "Thinking..." with shimmer effect during streaming
- Shows "Thought for N seconds" when complete

## TypeScript Types

All components are fully typed with TypeScript:

```typescript
import type { ToolUIPart, FileUIPart, UIMessage } from "ai";

type ToolProps = ComponentProps<typeof Collapsible>;
type QueueItemProps = ComponentProps<"li">;
type MessageAttachmentProps = HTMLAttributes<HTMLDivElement> & {
  data: FileUIPart;
  onRemove?: () => void;
};
```

## Common Use Cases

### Chat Interface
Combine Conversation, Message, and PromptInput for a complete chat UI:

```tsx
import { Conversation, ConversationContent, ConversationScrollButton } from "@/components/ai-elements/conversation";
import { Message, MessageContent, MessageResponse } from "@/components/ai-elements/message";
import {
  PromptInput,
  PromptInputTextarea,
  PromptInputFooter,
  PromptInputTools,
  PromptInputButton,
  PromptInputSubmit
} from "@/components/ai-elements/prompt-input";

<div className="flex flex-col h-screen">
  <Conversation>
    <ConversationContent>
      {messages.map(msg => (
        <Message key={msg.id} from={msg.role}>
          <MessageContent>
            <MessageResponse>{msg.content}</MessageResponse>
          </MessageContent>
        </Message>
      ))}
    </ConversationContent>
    <ConversationScrollButton />
  </Conversation>

  <PromptInput onSubmit={handleSubmit}>
    <PromptInputTextarea />
    <PromptInputFooter>
      <PromptInputTools>
        <PromptInputButton onClick={() => attachments.openFileDialog()}>
          <PaperclipIcon />
        </PromptInputButton>
      </PromptInputTools>
      <PromptInputSubmit status={chatStatus} />
    </PromptInputFooter>
  </PromptInput>
</div>
```

### Tool Execution Display
Show tool execution with expandable details:

```tsx
import { Tool, ToolHeader, ToolContent, ToolInput, ToolOutput } from "@/components/ai-elements/tool";

{toolInvocations.map(tool => (
  <Tool key={tool.id}>
    <ToolHeader
      title={tool.toolName}
      type={`tool-call-${tool.toolName}`}
      state={tool.state}
    />
    <ToolContent>
      <ToolInput input={tool.args} />
      {tool.result && (
        <ToolOutput output={tool.result} errorText={tool.error} />
      )}
    </ToolContent>
  </Tool>
))}
```

### Approval Workflow
Request user confirmation before executing actions:

```tsx
import {
  Confirmation,
  ConfirmationTitle,
  ConfirmationRequest,
  ConfirmationActions,
  ConfirmationAction,
  ConfirmationAccepted,
  ConfirmationRejected
} from "@/components/ai-elements/confirmation";

<Confirmation approval={tool.approval} state={tool.state}>
  <ConfirmationTitle>
    Approve deletion of {resource}?
  </ConfirmationTitle>

  <ConfirmationRequest>
    <ConfirmationActions>
      <ConfirmationAction onClick={approve} variant="default">
        Approve
      </ConfirmationAction>
      <ConfirmationAction onClick={reject} variant="outline">
        Reject
      </ConfirmationAction>
    </ConfirmationActions>
  </ConfirmationRequest>

  <ConfirmationAccepted>
    Action approved and executed.
  </ConfirmationAccepted>

  <ConfirmationRejected>
    Action rejected.
  </ConfirmationRejected>
</Confirmation>
```

### Job Queue Management
Display task lists with completion status:

```tsx
import {
  Queue,
  QueueSection,
  QueueSectionTrigger,
  QueueSectionLabel,
  QueueSectionContent,
  QueueList,
  QueueItem,
  QueueItemIndicator,
  QueueItemContent,
  QueueItemDescription
} from "@/components/ai-elements/queue";

<Queue>
  <QueueSection>
    <QueueSectionTrigger>
      <QueueSectionLabel count={todos.length} label="todos" />
    </QueueSectionTrigger>
    <QueueSectionContent>
      <QueueList>
        {todos.map(todo => (
          <QueueItem key={todo.id}>
            <QueueItemIndicator completed={todo.status === 'completed'} />
            <QueueItemContent completed={todo.status === 'completed'}>
              {todo.title}
            </QueueItemContent>
            {todo.description && (
              <QueueItemDescription completed={todo.status === 'completed'}>
                {todo.description}
              </QueueItemDescription>
            )}
          </QueueItem>
        ))}
      </QueueList>
    </QueueSectionContent>
  </QueueSection>
</Queue>
```

## Accessibility

Components include accessibility features:

- ARIA labels and roles
- Keyboard navigation support
- Screen reader announcements
- Focus management
- Semantic HTML elements

## Animation

Many components use Framer Motion for smooth animations:

- Shimmer effect for loading states
- Collapsible content transitions
- Edge animations in Canvas
- Loader spinner rotation

## References

- [Conversation Components](references/conversation.md)
- [Prompt Input Components](references/prompt-input.md)
- [Workflow Components](references/workflow.md)
- [Visualization Components](references/visualization.md)

© existential-birds · Apache-2.0 · existential-birds/beagle

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

Все скиллы по теме «Фронтенд и UI» →

Сначала — ai-elements от других авторов.

ai-elements vercel Скилл ai-elements для Claude Code добавляет React-компоненты для сборки AI-чата: сообщения, историю диалогов, поля промптов и отображение вызовов инструментов. CX Codex +1 21 000установок agent-elements 21st-dev Собирает интерфейсы чатов и агентов на React 19 и Tailwind v4 с помощью Agent Elements. Выводит карточки вызовов инструментов, планов и подтверждений. CX Codex +1 738установок elements assistant-ui Скилл elements помогает добавлять и настраивать компоненты assistant-ui в проект. Подходит для сборки готовых интерфейсов чатов, карточек рассуждений и планов агентов. CX Codex +1 1 400установок nextjs-chatbot laguagu Скилл nextjs-chatbot помогает собрать веб-чат на Next.js: подтверждение вызовов инструментов, сохранённая история, отрисовка результатов, подсказки и встраиваемый виджет. CX Codex +1 161установок avoid-ai-design ungspirit Скилл avoid-ai-design для Claude Code находит в вёрстке следы нейросети и переписывает её вокруг одной дизайн-идеи. Убирает шаблоны, из-за которых фронтенд выглядит как у всех. CX Codex +1 998установок agent-ui 101-skills Скилл agent-ui для Claude Code добавляет готовый интерфейс ИИ-агента в React и Next.js: чат с подтверждением действий пользователя и вызовом браузерных инструментов. CX Codex +1 247установок chat-ui 101-skills Скилл chat-ui для Claude Code даёт агенту готовые блоки чата для React и Next.js: контейнер, сообщения, поле ввода и индикатор набора. Собирает интерфейс переписки с ассистентом. CX Codex +1 242установок

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

Весь набор →
sqlalchemy-code-review Скилл sqlalchemy-code-review проверяет SQLAlchemy-код на ошибки в сессиях, связях, запросах и миграциях. Нужен при ревью проектов на SQLAlchemy 2.0 и Alembic. CX Codex +1 228установок pydantic-ai-common-pitfalls Скилл pydantic-ai-common-pitfalls разбирает типичные ошибки в агентах на PydanticAI и подсказывает, что править: декораторы инструментов, зависимости, схемы вывода, стриминг. CX Codex +1 221установок agent-architecture-analysis Скилл agent-architecture-analysis проверяет кодовую базу ИИ-агента по методике 12-Factor Agents и выдаёт отчёт с оценкой каждого фактора и ссылками на файлы. CX Codex +1 220установок pydantic-ai-agent-creation Скилл pydantic-ai-agent-creation помогает создавать типобезопасных агентов на PydanticAI: со структурированным выводом, зависимостями и настройками модели. Нужен при сборке AI-агентов и чат-систем. CX Codex +1 219установок go-code-review Скилл go-code-review проверяет Go-код на идиоматичность, обработку ошибок и гонки: сначала читает go.mod, потом разбирает функции целиком. CX Codex +1 206установок shadcn-code-review Скилл shadcn-code-review проверяет React-компоненты на базе shadcn/ui, Radix и Tailwind CSS на доступность, работу с CVA и шаблоны asChild. Помогает находить ошибки в кастомной вёрстке. CX Codex +1 206установок react-router-code-review Скилл react-router-code-review для Claude Code проверяет код роутинга в React Router v6.4 и новее: лоадеры, экшены, границы ошибок и навигацию. CX Codex +1 202установок swift-testing-code-review Скилл swift-testing-code-review проверяет тесты Swift Testing: макросы, параметризованные и асинхронные сценарии, организацию наборов. Нужен при ревью .swift-файлов. CX Codex +1 196установок

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

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