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 스킬을 사용하세요. shadcn/ui로 계정 설정 페이지를 만들어 주세요. 프로필 폼(이름, 이메일, 아바타), 알림 스위치, 확인 대화상자가 있는 위험 구역을 넣어 주세요. 기존 컴포넌트와 시맨틱 색상만 사용하세요.
Claude Code에서도 되나요?
지침이 표준 SKILL.md이므로 GitHub에서 폴더를 ~/.claude/skills로 복사하면 됩니다. 다만 Claude Code는 맨 위에서 프로젝트 컨텍스트를 넣어 주는 ! 명령을 실행하지 않으므로, 먼저 npx shadcn@latest info를 실행해 달라고 요청하세요.