본문으로 건너뛰기
Codex DesignBETA

Codex용 shadcn 스킬.

shadcn 스킬은 Codex가 메인테이너들이 의도한 방식대로 shadcn/ui를 쓰도록 가르칩니다. 직접 마크업을 짜기 전에 레지스트리를 검색하고, 완성된 컴포넌트를 조합하고, 원시 색상값 대신 시맨틱 토큰으로 스타일링합니다. OpenAI의 Build Web Apps 플러그인에 들어 있습니다.

2026년 11월 12일 업데이트 · 3분 분량

한눈에 보기

스킬 이름shadcn
제공OpenAI의 Build Web Apps 플러그인
설치codex plugin add build-web-apps@openai-curated, 또는 Codex에서 /plugins
Codex가 쓰는 때components.json 파일이 있는 프로젝트에서, 또는 shadcn/ui, 레지스트리, --preset 코드를 언급할 때
출처GitHub의 openai/plugins

하는 일

시작하기 전에 스킬이 npx shadcn@latest info --json을 실행해, Codex가 프로젝트 설정과 이미 설치된 컴포넌트를 파악하게 합니다. 그다음 네 가지 원칙을 따릅니다. 기존 컴포넌트를 먼저 쓰고, 새로 만들기보다 조합하고, 커스텀 스타일보다 내장 variant를 먼저 쓰고, 시맨틱 색상을 씁니다.

구체적인 규칙도 지키게 하며, 규칙마다 잘못된 코드와 올바른 코드가 담긴 참고 파일이 있습니다.

  • 스타일링: space-y-* 대신 gap-*, w-10 h-10 대신 size-10, dark: 색상을 직접 덮어쓰지 않기, 조건부 클래스에는 cn().
  • 폼: 레이아웃에는 FieldGroup과 Field, 유효성 검사에는 data-invalid와 aria-invalid, 선택지가 적을 때는 ToggleGroup.
  • 구조: 모든 dialog, sheet, drawer에는 제목을 넣고, 카드는 구성 요소를 모두 쓰고, 아바타에는 항상 fallback을 둡니다.
  • 마크업보다 컴포넌트: 콜아웃에는 Alert, 빈 상태에는 Empty, 로딩에는 Skeleton, 스타일을 입힌 span 대신 Badge, 토스트에는 sonner.

언제 쓰나요

프로젝트에서 shadcn/ui를 쓰거나 Codex에게 새로 시작하게 하고 싶다면 설치하세요. AI가 쓴 shadcn 코드에서 가장 흔한 문제를 막아 줍니다. 겉보기엔 맞지만 실제로는 원시 div와 하드코딩된 색상으로 조립되어, 다크 모드에서 깨지고 테마와 점점 어긋나는 컴포넌트입니다.

써 보기

shadcn/ui로 설정 페이지 만들기
shadcn 스킬을 사용하세요. shadcn/ui로 계정 설정 페이지를 만들어 주세요. 프로필 폼(이름, 이메일, 아바타), 알림 스위치, 확인 대화상자가 있는 위험 구역을 넣어 주세요. 기존 컴포넌트와 시맨틱 색상만 사용하세요.

Claude Code에서도 되나요?

지침이 표준 SKILL.md이므로 GitHub에서 폴더를 ~/.claude/skills로 복사하면 됩니다. 다만 Claude Code는 맨 위에서 프로젝트 컨텍스트를 넣어 주는 ! 명령을 실행하지 않으므로, 먼저 npx shadcn@latest info를 실행해 달라고 요청하세요.

더 읽어 보기

Codex용 독립 플러그인입니다. OpenAI와 제휴하거나 OpenAI의 보증을 받은 제품이 아닙니다.