사용 가이드로 건너뛰기
baseline-ui작성자 Julien Thibeaut

Baseline UI 스킬.

Claude Code 및 Codex용 디자인 검토 스킬: 간격, 계층, 타이포그래피, 작은 레이아웃 문제를 수정하여 UI 코드를 신속하게 개선합니다.

  • Design Review & Accessibility
  • UI 코드
ibelick/ui-skills · skills/baseline-ui/SKILL.mdSKILL.md
--- name: baseline-ui description: Quickly deslop UI code by fixing spacing, hierarchy, typography, and small layout issues. Use when the interface needs a fast cleanup or polish pass. --- ## How to use ## Stack ## Components ## Interaction ## Animation ## Typography
2026-09-14 업스트림 파일에서 읽은 서문 및 섹션 제목 · 전체 3,417자

01 기능

Claude Code와 Codex에서 baseline-ui 스킬이 수행하는 작업

요약, 워크플로, 산출물을 모두 해당 스킬의 SKILL.md에서 그대로 읽어 정리한 내용입니다.

SKILL.md에서2026-09-14 읽음 · 실행 기록 아님

스킬 자체의 표현으로

Baseline UI는 코드베이스에서 AI가 생성한 인터페이스의 조잡함을 막기 위해 확고한 UI 기준을 강제하는 리뷰 스킬입니다. React 프리미티브를 사용하는 Tailwind CSS 프로젝트를 대상으로 하며, 대화 내 UI 작업 전반에 적용되는 상시 제약 세트로 설치되거나, 파일 단위 리뷰 패스로 실행됩니다.

이 스킬의 특징은 사용하는 어휘의 구체성입니다. h-screen 대신 h-dvh, 헤딩에는 text-balance를 사용하는 것부터, 컴포지터 전용 애니메이션을 200ms로 제한하고 임의의 z-index 값을 금지하는 것까지, 사용하거나 피해야 할 정확한 유틸리티와 props를 명시합니다. 인터페이스를 빠르게 정리하거나 다듬어야 할 때 사용하십시오.

산출물

  • 각 위반 사항이 왜 중요한지 한 문장으로 설명합니다.
  • 각 발견 사항에 대한 구체적인 코드 수준의 수정안입니다.
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    대화 전체에 적용되는 제약 조건 집합으로 호출하기

    별도의 대상 없이 명령을 실행하면 해당 대화에서 수행되는 모든 UI 작업에 이 파일의 모든 제약 조건이 적용되며, 단일 파일에만 적용되지 않습니다.

  2. 02
    또는 단일 파일을 지정하기

    파일 대상을 전달하면 스킬이 리뷰 모드로 전환되어 해당 파일을 아래에 나열된 모든 제약 조건과 비교하여 검사합니다.

  3. 03
    세 부분으로 구성된 위반 보고서를 반환하기

    각 발견 사항은 문제가 되는 코드 조각을 인용하고, 왜 중요한지 한 문장으로 설명하며, 코드 수준의 수정안을 제안합니다.

  4. 04
    제약 조건 그룹을 순서대로 처리하기

    이 파일은 규칙을 Stack, Components, Interaction, Animation, Typography, Layout, Performance, Design으로 구성하며, 각 그룹은 MUST, SHOULD, NEVER 항목을 혼합하여 포함합니다.

02 적합성 확인

baseline-ui 스킬을 사용하는 경우

이러한 종류의 디자인 검토 작업에는 Claude Code 또는 Codex에서 baseline-ui 스킬을 사용하십시오. 아래 적합성과 제한사항은 스킬 자체 파일에서 가져온 것입니다.

적합한 경우

  • 일관된 기준선에서 벗어난 인터페이스에 대한 빠른 정리 또는 다듬기 작업입니다.
  • 간격, 계층 구조, 타이포그래피 및 작은 레이아웃 문제에 대해 특정 파일 하나를 리뷰하는 것입니다.

한계 인지하기

  • 그래디언트, 커스텀 이징 커브 또는 커스텀 자간에 의존하는 디자인 작업으로, 이는 모두 명시적 요청이 있어야 허용됩니다.
  • 키보드 또는 포커스 동작을 직접 구현하는 것으로, 명시적으로 요청되지 않는 한 허용되지 않습니다.

제공할 사항

  • 리뷰할 파일선택 사항입니다. 파일을 지정하면 스킬이 해당 파일에 대해서만 위반 사항을 보고하는 리뷰 패스로 전환됩니다.

03 스킬 내부

baseline-ui 스킬이 Claude Code와 Codex에 부여하는 규칙

SKILL.md가 에이전트에게 설정하는 8가지 구체적인 지시, 기본값, 제한 — 결과를 바꾸는 파일의 부분입니다.

  1. Tailwind CSS 기본값 유지하기

    커스텀 값은 이미 프로젝트에 존재하거나 명시적으로 요청된 경우에만 허용되며, 그렇지 않으면 에이전트는 Tailwind의 기본값을 사용해야 합니다.

  2. 요청이 없으면 애니메이션 없음

    애니메이션은 기본적으로 꺼져 있습니다. 명시적으로 요청된 경우에도 컴포지터 속성만 애니메이션할 수 있으며, width, height, top, left, margin, padding은 절대 애니메이션할 수 없습니다.

  3. 인터랙션 피드백은 200ms로 제한하기

    등장 애니메이션은 ease-out을 사용해야 하며, 반복 애니메이션은 화면 밖으로 나가면 일시 정지해야 하고, prefers-reduced-motion을 준수해야 합니다.

  4. 프리미티브 시스템을 절대 혼용하지 않기

    키보드 또는 포커스 동작이 있는 모든 요소는 Base UI, React Aria 또는 Radix의 접근성 프리미티브가 필요하며, 기존 프로젝트 프리미티브가 우선하고, 명시적으로 요청되지 않는 한 키보드 또는 포커스 동작을 직접 다시 구현하는 것은 금지됩니다.

  5. h-screen이 아닌 h-dvh를 사용하기

    인터랙션 섹션에서는 고정 요소가 safe-area-inset을 준수하고, 오류가 해당 동작이 발생하는 위치 옆에 표시되도록 요구합니다.

  6. 고정 z-index 스케일 사용

    임의의 z- 값은 허용되지 않으며, 정사각형 요소에는 짝을 이루는 w-와 h- 유틸리티 대신 size-를 사용해야 합니다.

  7. 타이포그래피 유틸리티는 그대로 유지

    제목에는 text-balance, 본문에는 text-pretty, 데이터에는 tabular-nums를 사용하며, letter-spacing은 명시적으로 요청되지 않는 한 변경하지 않아야 합니다.

  8. 기본적으로 그라디언트나 글로우 효과 사용 금지

    그라디언트는 명시적인 요청이 있어야 하며, 퍼플 및 멀티컬러 그라디언트는 전혀 사용할 수 없고, 글로우 효과는 주된 어포던스로 사용될 수 없습니다.

04 활용하기

Claude Code 또는 Codex에 baseline-ui 설치

npx skills add 명령 한 번 실행 후, 에이전트에서 첫 번째 작업을 수행하고 결과 체크리스트를 확인합니다.

Claude Code, Codex 또는 사용 중인 에이전트에 baseline-ui 추가

프로젝트에서 실행합니다. 설치 프로그램이 어떤 에이전트에 추가할지 묻습니다.

Terminal
npx skills add https://github.com/ibelick/ui-skills --skill baseline-ui

skills/baseline-ui/SKILL.md에 대한 일반적인 skills CLI 형식입니다. 저장소에서 자체 경로를 문서화할 수도 있습니다.

스킬에 첫 번째 디자인 리뷰 작업 부여

스킬 자체의 용어로 작성되었습니다. 대괄호 부분은 각자의 자료로 교체합니다.

Starter prompt
Review [src/components/SettingsDialog.tsx] against the baseline UI constraints. We generated this dialog quickly and the spacing, hierarchy and layout feel off, so report the violations with the exact lines, why they matter, and the code-level fix for each.

출처: 스킬 자체의 용어로 SKILL.md에서 작성했습니다.

첫 번째 결과 확인

SKILL.md 자체가 올바른 결과의 모습으로 제시하는 내용:

  • transform과 opacity 외의 속성이 애니메이션되지 않는지 확인합니다.
  • 아이콘 전용 버튼에 aria-label이 있고, 파괴적 작업이 AlertDialog 뒤에 위치하는지 확인합니다.

OpenDesign에서는 baseline-ui를 해당 SKILL.md 링크에서 가져옵니다: Plugins → Add → Skill → Import from link, 그런 다음 상단 바에서 선택합니다.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

이 페이지의 사실이 어디에서 왔으며 언제 마지막으로 확인되었는지 안내합니다.

Repository
github.com/ibelick/ui-skills 브랜치 main
스킬 파일
skills/baseline-ui/SKILL.md 검증 시 콘텐츠 체크섬 기록됨; 커밋 79081ab
License
MIT LICENSE에서 확인
리포지토리 스타
8,402 2026-09-14 기준 ibelick/ui-skills 저장소 전체의 GitHub 스냅샷이며, 이 카탈로그에는 5개의 스킬이 포함되어 있습니다. baseline-ui에 대한 평가나 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 스타 수가 확인되었습니다. OpenDesign 메인에 번들로 포함되지 않음(2026-08-28 확인); 이 페이지에 실제 실행 기록이 없습니다.

SKILL.md 내부

  1. 사용 방법두 가지 호출 모드가 있습니다: 명령어만 실행하면 제약 조건이 적용되고, 파일 인자를 함께 주면 위반 보고서가 생성됩니다.
  2. 스택Tailwind CSS 기본값, JS 애니메이션을 위한 motion/react, tw-animate-css, cn 유틸리티.
  3. 컴포넌트접근성을 갖춘 프리미티브만 사용하며, 기존 프로젝트 프리미티브를 우선하고, 아이콘 전용 버튼에는 aria-label을 적용합니다.
  4. 인터랙션파괴적 작업에는 AlertDialog, 로딩에는 스켈레톤, h-dvh, safe-area-inset, 붙여넣기 차단 금지.
  5. 애니메이션요청이 없는 한 애니메이션을 사용하지 않으며, 컴포지터 속성만 사용하고, ease-out, 200ms 상한, reduced-motion을 준수합니다.
  6. 타이포그래피제목에는 text-balance, 본문에는 text-pretty, 데이터에는 tabular-nums를 사용하며 letter-spacing은 변경하지 않습니다.
  7. 레이아웃임의의 값 대신 고정 z-index 스케일을 사용하며, 정사각형 요소에는 size-*를 사용합니다.
  8. 성능큰 규모의 blur나 backdrop-filter 애니메이션을 피하고, will-change의 범위를 제한하며, useEffect보다 렌더 로직을 우선합니다.
  9. 디자인그라디언트나 글로우 어포던스를 사용하지 않고, 기본 shadow 스케일과 하나의 강조 색상을 사용하며, 기존 토큰을 재사용합니다.
스킬 자체 설명
"간격, 계층 구조, 타이포그래피 및 작은 레이아웃 문제를 수정하여 UI 코드를 빠르게 정리합니다. 인터페이스에 빠른 정리 또는 마무리 작업이 필요할 때 사용합니다."

SKILL.md의 프런트 매터 설명입니다. 전체 파일은 약 3,417자입니다. GitHub에서 전체 파일 읽기

06 설치하기 전에

baseline-ui 스킬에 대해 자주 묻는 질문

이 답변은 2026-09-14 기준으로 확인한 SKILL.md 내용을 근거로 하며, 실행 기록을 바탕으로 한 것이 아닙니다.

어떤 스택을 전제로 하나요?

Tailwind CSS 기본값, JavaScript 애니메이션이 필요할 때 사용하는 motion/react(구 framer-motion), 진입 및 마이크로 애니메이션을 위한 tw-animate-css, clsx와 tailwind-merge로 구성된 cn 유틸리티입니다.

더 보기 좋게 만들기 위해 애니메이션이나 그라디언트를 추가하나요?

아닙니다. 애니메이션은 명시적으로 요청하지 않는 한 절대 추가되지 않으며, 그레이디언트 또한 명시적으로 요청하지 않는 한 사용되지 않습니다. 퍼플과 멀티컬러 그레이디언트는 전면적으로 배제됩니다.

어떤 컴포넌트 라이브러리를 허용합니까?

키보드 또는 포커스 동작이 있는 모든 요소에는 Base UI, React Aria 또는 Radix를 사용하며, 프로젝트에 이미 존재하는 프리미티브를 우선합니다. 새 프리미티브를 도입할 때는 스택과 호환되는 경우 Base UI가 권장되는 선택이며, 하나의 인터랙션 표면 안에서 서로 다른 프리미티브 시스템을 섞는 것은 허용되지 않습니다.

Baseline UI

실제 디자인 리뷰 작업에서 baseline-ui를 실행합니다.

OpenDesign을 다운로드하고 SKILL.md 링크에서 baseline-ui를 가져온 다음 위의 프롬프트를 붙여넣고 결과 전에 계획을 읽으십시오.

터미널
npx skills add https://github.com/ibelick/ui-skills --skill baseline-ui

OpenDesign 데스크톱

하나의 디자인 시스템으로 모든 결과물에 브랜드 일관성을

완전한 Vibe Design Workspace에서 하나의 브랜드 규칙을 웹사이트, 슬라이드, 인터랙티브 프로토타입, 대시보드, 이미지, HTML 영상에 적용하세요. 로컬 Codex, Claude Code, Cursor 등을 연결해 무료로 제작할 수 있습니다.

  • 웹, 슬라이드, 프로토타입, 대시보드, 이미지, 영상
  • 140개+ 디자인 시스템과 전체 템플릿·스킬 라이브러리
  • 로컬 Codex 및 21개+ 코딩 에이전트 연결 · 무료
무료 다운로드

macOS, Windows 지원