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

ai-component-metadata — скилл для Claude Code: метаданные компонентов

Скилл ai-component-metadata для Claude Code описывает компоненты дизайн-системы в формате метаданных для генерации интерфейсов. Запускается при разборе компонента и помогает агенту выбрать его варианты и способы использования.

MIT ★ 107 обновлён 2026-11-08

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

Что делает ai-component-metadata

Скилл анализирует состав компонента, его слоты и дочерние элементы, варианты, состояния, типы пропсов и атрибуты доступности. Затем он формирует метаданные со сценариями использования, ограничениями композиции, поведением и подсказками для ИИ.

Для автоматической генерации скрипт scripts/generate_metadata.py читает файл компонента; запускать его нужно через python. Альтернатива — скопировать шаблон assets/metadata-template.tsx и заполнить его вручную. Готовые метаданные предлагают проверять на задачах генерации и в Storybook; примеры кода должны запускаться.

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

  • описать пропсы, варианты и состояния компонента
  • зафиксировать типовые сценарии и ошибки использования
  • указать связи компонента с другими элементами
  • сохранить сведения о доступности для генерации интерфейса

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

  • Создай метаданные для компонента Button.tsx: опиши пропсы, состояния и доступность.
  • Разбери FormField.tsx и добавь сценарии использования и анти-паттерны.
  • Составь метаданные для компонентов из дизайн-системы по шаблону.

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

1Через Skills CLI (Vercel)

npx skills add thedesignproject/agent-skills --skill ai-component-metadata -a claude-code

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

~/.claude/skills/ai-component-metadata/SKILL.md

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

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

Вопросы об ai-component-metadata

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

Выполни npx skills add thedesignproject/agent-skills --skill ai-component-metadata -a claude-code. Файл скилла находится по пути ~/.claude/skills/ai-component-metadata/SKILL.md.

Что делает ai-component-metadata?

Анализирует структуру компонента и создаёт метаданные о его назначении, использовании, поведении, составе и доступности. Эти сведения помогают ИИ корректно применять компоненты при генерации интерфейсов.

Можно ли использовать ai-component-metadata вместе с Figma MCP?

Да. Контекст дизайна из Figma MCP можно объединить с метаданными компонента, которые описывают его поведение.

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

SKILL.md · MIT
---
name: ai-component-metadata
version: 1.0.0
description: Generate AI-ready metadata for design system components to enable intelligent UI generation. Analyzes component structure and generates structured metadata that helps AI understand when and how to use components correctly. Useful for teams building AI-consumable design systems.
---

# AI Component Metadata Generator

Generate structured, AI-consumable metadata for design system components to enable intelligent UI generation and component usage.

## Quick Start

When analyzing a component, use the metadata schema template in `scripts/generate_metadata.py` or follow the manual process below:

```bash
# Automatic generation (reads component file)
python scripts/generate_metadata.py path/to/Component.tsx

# Or use the template directly
cp assets/metadata-template.tsx your-component-metadata.tsx
```

## Core Workflow

### 1. Analyze Component Structure
Identify:
- Component composition (slots, children)
- Available variants and states
- Props and their types
- Accessibility attributes

### 2. Generate Metadata
Create metadata following this schema:

```javascript
export const componentMetadata = {
  component: {
    name: "ComponentName",
    category: "atoms|molecules|organisms",
    description: "Brief description",
    type: "interactive|display|container|input|navigation"
  },
  
  usage: {
    useCases: ["primary-use", "secondary-use"],
    requiredProps: [],
    commonPatterns: [
      {
        name: "pattern-name",
        description: "When to use",
        composition: "JSX example"
      }
    ],
    antiPatterns: [
      {
        scenario: "what-not-to-do",
        reason: "why",
        alternative: "what-instead"
      }
    ]
  },
  
  composition: {
    slots: {},
    nestedComponents: [],
    commonPartners: [],
    parentConstraints: []
  },
  
  behavior: {
    states: [],
    interactions: {},
    responsive: {}
  },
  
  accessibility: {
    role: "ARIA role",
    keyboardSupport: "description",
    screenReader: "behavior",
    focusManagement: "strategy",
    wcag: "AA"
  },
  
  aiHints: {
    priority: "high|medium|low",
    keywords: [],
    context: "when to use"
  }
}
```

### 3. Validate Metadata
- Test with AI generation tasks
- Verify in Storybook
- Ensure examples are runnable

## Component Categories

- **atoms**: Basic building blocks (Button, Text, Input)
- **molecules**: Simple combinations (Card, Chip, FormField)
- **organisms**: Complex components (Header, Table, Form)

## Advanced Features

For complex scenarios, see:
- **Nested components**: [NESTED.md](references/NESTED.md)
- **Integration patterns**: [INTEGRATION.md](references/INTEGRATION.md)
- **Testing strategies**: [TESTING.md](references/TESTING.md)

## Working with Figma

When combining with Figma MCP:

```javascript
// Figma provides visual context
const figmaContext = await Figma.get_design_context();

// Your metadata provides behavioral context
const componentMetadata = components.Button.metadata;

// AI combines both for complete understanding
```

## Best Practices

1. **Keep examples real** - Use actual, runnable code
2. **Focus on patterns** - Document common usage patterns
3. **Include anti-patterns** - Help AI avoid mistakes
4. **Validate through usage** - Test with actual AI generation

## Success Metrics

Your metadata is effective when:
- AI uses existing components instead of recreating
- Correct variants are selected based on context
- Accessibility is maintained in generated code
- Patterns are consistent across AI outputs

© thedesignproject · MIT · thedesignproject/agent-skills

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

Все скиллы по теме «Дизайн» →
component-spec Owl-Listener Скилл component-spec для Claude Code описывает компоненты библиотеки: их свойства, состояния, варианты и требования доступности. Запускается при подготовке спецификации компонента. CX Codex +1 2 500установок design-system rampstackco Скилл design-system для Claude Code и других платформ: собирает или проверяет дизайн-систему — токены, компоненты, именование, контрибуцию и документацию. Держит стиль продуктов согласованным. CX Codex +1 369установок component-canvas ibelick Скилл component-canvas для Claude Code: собирает полноэкранный канвас с панорамированием, зумом и сравнением вариантов. Показывает компоненты дизайн-системы в их текущем состоянии. CX Codex +1 1 800установок component-family-consistency dembrandt Скилл component-family-consistency для Claude Code помогает согласовать стили кнопок, полей, бейджей и других компонентов. Подключается при работе с UI-компонентами, библиотекой компонентов и дизайн-системой. CX Codex +1 1 000установок qt-figma-component-generation qt-ai-skills Скилл qt-figma-component-generation читает компоненты Figma через MCP и пишет по ним QML-контролы на Qt Quick Controls 2. Нужен на шаге генерации компонентов в воркфлоу дизайн-системы. CX Codex +1 531установок component-inventory ShuaiMXu Скилл component-inventory для Claude Code собирает карту компонентов с путями к исходникам, вариантами и известными потребителями. Помогает оценивать повторное использование и искать расхождения. CX Codex +1 ★ 529звёзд репо

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

Весь набор →
performance-review-self-assessment Скилл performance-review-self-assessment для Claude Code помогает подготовить самооценку к квартальному ревью. Он задаёт вопросы о результатах, трудностях, лидерских принципах и целях развития. CX Codex +1 ★ 107звёзд репо performance-review-manager Скилл performance-review-manager для Claude Code ведёт менеджера через квартальную оценку сотрудника. Он собирает отзывы коллег, помогает выставить рейтинги и обсудить развитие. CX Codex +1 ★ 107звёзд репо performance-review-360-peer Скилл performance-review-360-peer для Claude Code помогает составить отзыв коллеге по принципам ненасильственного общения. Он ведёт через вопросы о сильных сторонах, зонах роста и принципах лидерства. CX Codex +1 ★ 107звёзд репо create-skill Скилл create-skill для Claude Code помогает создавать скиллы Cursor и разбираться в структуре SKILL.md. Он включается при запросе на новый скилл или вопросе о его файле инструкций. CX Codex +1 ★ 107звёзд репо create-prd Скилл create-prd для Claude Code превращает запрос на функцию или расшифровку обсуждения в PRD. Он изучает кодовую базу и может создать проект с задачами в Linear. CX Codex +1 ★ 107звёзд репо business-kickoff-workshop Скилл business-kickoff-workshop для Claude Code готовит бизнес-воркшоп по Business Model Canvas и оформляет результаты после встречи. Запускается по запросу о kickoff-встрече, вопросах для нового клиента или заполнении Canvas. CX Codex +1 ★ 107звёзд репо build-my-designer-brain Скилл build-my-designer-brain для Claude Code собирает личную базу методов, вкусовых предпочтений и уроков дизайнера. Агент запускает его для создания или обновления этой базы и применения её в работе над функцией. CX Codex +1 ★ 107звёзд репо agentic-design-systems Скилл agentic-design-systems для Claude Code помогает проектировать и проверять библиотеки компонентов, которые используют ИИ-агенты. Он включается при создании AI-читаемой дизайн-системы или аудите метаданных компонентов. CX Codex +1 ★ 107звёзд репо

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

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