사용 가이드로 건너뛰기
Building Components작성자 vercel

Building Components 스킬.

접근성과 배포를 고려한 재사용 가능한 UI 컴포넌트 API를 설계하세요.

  • 컴포넌트 API
  • 접근성
소스 검토 · building-componentsSKILL.md
작업 접근성과 배포를 고려한 재사용 가능한 UI 컴포넌트 API를 설계하세요. 결과물 구현 요청에는 명시적인 조합 및 상태 모델을 가진 컴포넌트. 시작 전 확인 짧은 SKILL.md는 구체적인 구현 지침을 제공하는 함께 포함된 참고 자료에 의존합니다.
편집 요약 · 소스 검토일 2026-11-02 · 생성된 예제가 아닙니다

01 기능 소개

접근성과 배포를 고려한 재사용 가능한 UI 컴포넌트 API를 설계하세요

Vercel의 Building Components 스킬로 접근성 있는 컴포넌트 API, 제어 상태, 스타일, 토큰과 배포를 계획하세요.

소스 기반 워크플로실행 벤치마크 아님

작업 방식

Building Components는 재사용 가능한 UI 라이브러리를 만드는 엔지니어링 판단을 안내합니다. 조합, 키보드 동작, 상태 관리, TypeScript 인터페이스, 스타일에 관한 전용 참고 자료로 에이전트를 연결합니다. 진입 문서는 프리미티브, 컴포넌트, 블록, 템플릿을 다뤄 실제 결과물에 맞는 추상화 수준을 선택할 수 있습니다.

한 화면이 아니라 여러 사용처를 지원해야 하는 컴포넌트에 유용합니다. API 형태, 접근성, 배포를 함께 검토합니다. 소스는 주로 참고 자료 색인이므로 연결된 파일도 스킬의 일부로서 진입 파일과 함께 있어야 합니다.

예상 산출물

  • 구현 요청에는 명시적인 조합 및 상태 모델을 가진 컴포넌트.
  • 문서화 요청에는 컴포넌트 API와 관련 동작을 설명하는 사용 안내.
  • 요청에 배포가 포함된 경우 적합한 패키징 또는 레지스트리 계획.
예시 브리프 보기

브리프에서 검토까지

  1. 01
    컴포넌트 계약 정의

    대상이 프리미티브, 컴포넌트, 블록, 템플릿 중 무엇인지 정합니다. 공개 인터페이스와 호출 측에서 조합할 맥락을 설정합니다.

  2. 02
    관련 엔지니어링 지침 읽기

    제어/비제어 동작은 state.mdx, 공개 조합 모델은 composition.mdx, 키보드와 포커스 요건은 accessibility.mdx를 읽습니다. 구현에는 types.mdx와 styling.mdx를 참고합니다. 호출 측에 해당 API 패턴이 필요할 때만 polymorphism 또는 as-child 참고 자료를 추가합니다.

  3. 03
    API 구현과 문서화

    선택한 API로 상태와 표현을 연결합니다. 의도한 사용법을 설명하고 필요한 경우에만 npm, 레지스트리 또는 문서화된 다른 배포 경로를 선택합니다.

02 활용 상황

언제 사용하면 좋을까요

짧은 SKILL.md는 구체적인 구현 지침을 제공하는 함께 포함된 참고 자료에 의존합니다.

적합한 경우

  • 공유 컴포넌트 API여러 팀이 채택하기 전에 공유 컴포넌트의 공개 API를 신중하게 설계해야 할 때 적합합니다.
  • 라이브러리 엔지니어링UI 라이브러리에 일관된 접근성, 테마, 문서화 관행이 필요할 때 적합합니다.

확인할 한계

  • 함께 포함된 참고 자료짧은 SKILL.md는 구체적인 구현 지침을 제공하는 함께 포함된 참고 자료에 의존합니다.
  • 검증 범위진입 파일은 컴포넌트 접근성을 인증하거나 모든 프레임워크와의 호환성을 보장하지 않습니다.

준비할 입력

  • 예상 사용처컴포넌트의 예상 사용처와 사용 예시.
  • 리포지터리 관례리포지터리의 컴포넌트 스택, 토큰 시스템, TypeScript 관례.
  • 동작과 배포필수 키보드 동작, 상태 소유 주체, 배포 대상.

03 핵심 결정

중요한 판단 기준

  1. 명확한 상태 소유권

    제어 상태와 비제어 상태를 의도적인 API 선택으로 다룹니다.

  2. 조합 방식 선택

    공개 컴포넌트 API를 조합하기 위한 slots(슬롯), render props, as-child 패턴을 참고 자료에서 다룹니다.

  3. 배포 계획

    구현과 함께 배포 및 문서화를 고려합니다.

04 예시 브리프

목적을 좁힌 요청으로 시작하세요

아래 예시 브리프는 테스트되지 않았습니다. 사용하기 전에 스킬의 설정을 확인하세요.

소스와 설정 확인

컴포넌트의 예상 사용처와 사용 예시.

업스트림 소스 파일
https://github.com/vercel/components.build/blob/ba727450437385af662810329fa19896215f76d5/skills/building-components/SKILL.md

아래 참고 링크에서 원본 사용 지침을 확인할 수 있습니다. 사용 전에 리포지터리의 설정 요건을 확인하세요. 설치 명령어가 아닙니다.

결과물 하나부터 시작

스킬을 실행하기 전에 이 브리프의 범위, 소스 자료, 제약 조건을 상황에 맞게 조정하세요.

예시 브리프
building-components를 사용해 React 컴포넌트 라이브러리의 재사용 가능한 펼침/접힘 컴포넌트를 설계해주세요. 먼저 기존 프리미티브, 토큰, TypeScript 패턴을 살펴보세요. 구현 전에 제어 및 비제어 상태를 포함한 공개 API를 제안하세요. 조합, 접근성, 상태 관련 참고 자료를 읽으세요. 키보드 인터랙션과 포커스 동작을 다루고 트리거와 콘텐츠 조합 예시를 제공하며 기존 토큰을 사용하는 스타일을 문서화하세요. 현재 작업에 릴리스가 명시적으로 포함되지 않았다면 레지스트리 또는 npm 배포는 별도 제안으로 남겨두세요.

결과 확인

실제 출력을 다음의 관찰 가능한 기준과 비교해 확인하세요.

  • 사용 예시는 비공개 내부 구현이 아니라 문서화된 공개 API를 사용합니다.
  • 키보드, 포커스, 상태 동작에 대한 명확한 검증 결과가 있습니다.
  • 패키징 지침은 의도한 배포 채널과 일치합니다.

OpenDesign은 코딩 에이전트를 위한 로컬 디자인 작업 공간을 제공합니다. 이 목록은 스킬이 번들로 포함되어 있거나 외부 도구, 자격 증명, 소프트웨어 의존성이 포함되어 있다는 뜻이 아닙니다.

05 출처 및 라이선스

소스와 라이선스

이 페이지는 아래에 링크된 고정 소스 리비전을 설명합니다. 업스트림의 동작과 요구 사항은 바뀔 수 있습니다.

소스 소유자
vercel
스킬 파일
SKILL.md
라이선스
Not confirmed
검토한 스냅샷
2026-11-02 · ba7274504373

읽기 참고

  1. 라이선스 범위같은 고정 리비전에서 원본의 라이선스 선언이 충돌합니다. 루트 LICENSE는 Apache License 2.0을 명시하지만 README.md의 License 섹션은 MIT라고 하며 해당 파일로 연결합니다. skills/building-components 아래에는 별도의 재정의가 없습니다. 조건 없는 MIT 라벨을 표시하지 마세요. 충돌을 해결하려면 원본 작성자의 설명이 필요합니다.
편집 소스 요약
접근성과 배포를 고려한 재사용 가능한 UI 컴포넌트 API를 설계하세요.

링크된 소스를 바탕으로 OpenDesign이 작성한 원본 요약입니다. 저장소 스타 수는 특정 시점의 인기 지표일 뿐 스킬 사용량이나 품질 점수가 아닙니다.

06 시작 전 질문

시작 전 궁금한 점

바로 쓸 수 있는 시각적 테마를 제공하나요?

진입 문서는 컴포넌트 엔지니어링에 집중하고 토큰 및 스타일 참고 자료로 연결합니다. 시각적 요구사항은 제품 측에서 제공해야 합니다.

모든 컴포넌트에 다형성이 필요한가요?

아니요. polymorphism과 as-child는 API에 필요할 때 선택할 수 있는 참고 주제입니다.

레지스트리 배포도 도와주나요?

네. 레지스트리 배포, npm 게시, 컴포넌트 마켓플레이스에는 각각 전용 참고 자료가 연결되어 있습니다.

OpenDesign

작업 요청과 디자인 결과물을 한곳에 모으세요.

브리프, 소스 자료, 디자인 작업을 로컬 작업 공간에 함께 보관하세요. 워크플로에 추가하기 전에 스킬 자체의 설정을 확인하세요.

업스트림 소스 파일
https://github.com/vercel/components.build/blob/ba727450437385af662810329fa19896215f76d5/skills/building-components/SKILL.md