임페커블(Impeccable) 스킬이란: 설치와 명령어 사용법
임페커블(Impeccable)은 AI 코딩 에이전트가 만든 화면의 디자인을 다듬는 오픈소스 스킬이에요. ‘더 과감하게’, ‘검토해 줘’ 같은 요청을 명령어 24개로 정리했고, AI가 만든 티가 나는 패턴을 규칙으로 찾아 줘요. 이 글은 설치, 처음 할 일, 자주 쓰는 명령, 탐지기 사용법을 안내해요.

이 글에서 다루는 내용
임페커블은 어떤 스킬인가요?
임페커블은 Paul Bakaus가 만든 디자인 스킬이에요. 저장소는 스스로를 ‘코딩 에이전트를 위한 디자인 어휘’라고 소개해요. Anthropic의 frontend-design 스킬에서 출발했고, Apache 2.0 라이선스로 공개돼 있어요. 2026년 11월 기준 GitHub 별이 10만 개를 넘었어요.
Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode를 비롯한 여러 코딩 도구에서 쓸 수 있어요. 공식 문서는 impeccable.style에 있어요.
README는 임페커블이 이미 만들어진 화면을 고칠 때 가장 강하다고 설명해요. 페이지나 컴포넌트 하나를 가리키고 반복해서 다듬는 방식이에요. 새 페이지를 만드는 데도 쓸 수 있어요.
왜 디자인 스킬이 필요한가요?
아무 안내 없이 에이전트에게 페이지를 만들어 달라고 하면 비슷한 화면이 반복해서 나와요. README는 그 예로 모든 글자에 쓰인 Inter 글꼴, 보라에서 파랑으로 이어지는 그라디언트, 카드 안에 들어간 카드, 색 배경 위의 회색 글씨, 제목마다 올라간 둥근 사각형 아이콘을 들어요.
임페커블은 이 문제를 세 가지로 풀어요. 원하는 방향을 말할 어휘, 디자인을 검토하는 명령, 그리고 흔한 패턴을 규칙으로 찾아내는 탐지기예요.
임페커블은 어떻게 설치하나요?
프로젝트 폴더에서 ‘npx impeccable install’을 실행해요. 설치 프로그램이 쓰고 있는 코딩 도구를 찾아내고, 이 프로젝트에만 설치할지 전체에 설치할지 물어봐요. 설치가 끝나면 코딩 도구를 다시 불러온 다음 ‘/impeccable init’을 실행해요. Codex에서는 ‘$impeccable init’이에요.
Claude Code에서는 플러그인으로 설치할 수도 있어요. ‘/plugin marketplace add pbakaus/impeccable’을 입력한 다음 ‘/plugin’ 화면에서 Impeccable을 설치해요. 이미 설치했다면 ‘npx impeccable update’로 새 버전을 받아요.
설치 프로그램은 디자인 훅도 함께 설치할지 물어봐요. 훅은 에이전트가 화면 파일을 고칠 때마다 탐지기를 돌리고, 결과를 에이전트에게 돌려줘요. README는 Claude Code에서 훅이 모델의 명령 승인과 별개로 실행된다고 안내해요. 자리를 비운 채 에이전트를 돌리기 전에는 설치된 훅을 한 번 확인해 주세요.
설치하고 처음 할 일은 무엇인가요?
프로젝트마다 ‘/impeccable init’을 한 번 실행해요. 코드를 읽고, 코드만으로 알 수 없는 것만 물어봐요. 누구를 위한 제품인지, 무엇을 해야 하는지, 어떤 제약이 있는지예요. 답한 내용은 PRODUCT.md 파일로 저장되고, 이후 모든 명령이 이 파일을 읽어요.
이미 디자인이 있는 프로젝트라면 ‘/impeccable document’를 실행해 보세요. 지금 쓰고 있는 색, 글꼴, 간격 규칙을 DESIGN.md 파일로 정리해요. 이 파일이 있으면 화면을 고쳐도 기존 브랜드에서 벗어나지 않아요. PRODUCT.md와 DESIGN.md는 저장소에 함께 커밋해 두면 팀원도 같은 기준으로 작업할 수 있어요.
명령어 24개는 어떻게 나뉘나요?
명령어는 쓰는 시점에 따라 다섯 묶음으로 나뉘어요. 전부 외울 필요는 없어요. 입력창에 ‘/impeccable’만 입력하면 목록이 나와요. 24번째인 craft는 더 이상 권장하지 않는 별칭이에요.
| 묶음 | 명령 | 쓰는 때 |
|---|---|---|
| 방향 잡기 | bolder, quieter, distill, colorize, typeset, layout, animate, delight, overdrive | 디자인을 더 과감하게, 더 차분하게, 더 단순하게 바꿀 때 |
| 검토 | critique, audit | 고칠 곳과 우선순위를 알고 싶을 때 |
| 마무리 | polish, harden, clarify, adapt, optimize, onboard | 출시 전에 오류 상황, 문구, 화면 크기, 성능을 챙길 때 |
| 브라우저에서 반복 | live, generate | 실행 중인 화면에서 요소를 고르고 시안을 바꿔 볼 때 |
| 계획과 준비 | shape, init, document, extract | 코드를 쓰기 전에 계획하거나 프로젝트 정보를 정리할 때 |
명령은 어떻게 요청하나요?
명령 이름 뒤에 고칠 대상을 적어요. README의 예시는 ‘/impeccable critique the onboarding flow’, ‘/impeccable quieter the landing page’, ‘/impeccable polish settings’예요. 명령 이름 없이 ‘/impeccable redo this hero section’처럼 원하는 것을 설명해도 돼요.
대상은 좁게 잡을수록 결과가 좋아요. README는 페이지 전체를 훑는 것보다 섹션 하나를 꼼꼼히 검토하는 편이 낫다고 안내해요. 처음이라면 가격표나 가입 화면처럼 컴포넌트 하나를 골라 critique부터 실행해 보세요.
자주 쓰는 명령은 ‘/impeccable pin audit’처럼 고정해 둘 수 있어요. 그러면 ‘/audit’만 입력해도 실행돼요.
critique와 audit은 무엇이 다른가요?
둘 다 검토 명령이지만 보는 곳이 달라요. critique는 디자인을 사용성 기준으로 평가하고, audit은 기술 품질을 점검해요. 화면이 어색해 보일 때는 critique를, 출시 전 점검에는 audit을 실행해 보세요.
- 사용성 휴리스틱으로 디자인에 점수를 매겨요
- 무엇부터 고칠지 순서를 정해 줘요
- 화면이 어색한 이유를 알고 싶을 때 써요
- 접근성, 성능, 테마, 반응형 동작을 점검해요
- 발견한 문제를 P0(막는 문제)부터 P3(다듬기)까지 나눠요
- 출시 전에 빠진 것을 확인할 때 써요
탐지기는 어디서 실행하나요?
탐지기는 세 곳에서 실행할 수 있어요. 에이전트 안에서는 디자인 훅이 자동으로 실행해요. 터미널이나 CI에서는 ‘npx impeccable detect src/’처럼 폴더를 지정하고, 주소를 넣으면 렌더된 페이지를 검사해요. 브라우저에서는 크롬 확장 프로그램이 같은 결과를 페이지 위에 표시해요.
JSX나 TSX 같은 소스 파일에서는 패턴 규칙만 적용돼요. 낮은 대비나 너무 작은 글씨처럼 렌더된 화면이 필요한 규칙은 주소를 검사할 때 실행돼요. 그래서 README는 개발 서버 주소도 함께 검사하라고 권해요.
CI에서 쓴다면 종료 코드를 알아 두세요. 2는 문제를 발견했다는 뜻이고, 1은 대상을 검사하지 못했다는 뜻이에요. 브랜드 글꼴처럼 일부러 쓰는 것은 예외로 등록할 수 있어요.
| 실행하는 곳 | 방법 | 알아 둘 점 |
|---|---|---|
| 에이전트 | 디자인 훅이 자동 실행 | 에이전트가 화면 파일을 고칠 때마다 검사해요 |
| 터미널과 CI | npx impeccable detect src/ | 에이전트 없이 실행돼요 |
| 브라우저 | 크롬 확장 프로그램 | 열려 있는 페이지 위에 결과를 표시해요 |
쓰기 전에 무엇을 알아 둘까요?
‘/impeccable live’는 실행 중인 개발 서버 위에 오버레이를 띄워요. 요소를 고르고 방향을 정하면 시안을 그 자리에서 바꿔 보여 주고, 고른 시안은 소스 코드에 반영해요. README는 라이브 모드를 로컬 작업 폴더에서만 쓰고, 배포된 사이트에는 넣지 말라고 안내해요.
새 디자인을 시작할 때 스킬은 impeccable.style에서 시각 방향 목록을 받아 와요. 어떤 방향이 표시됐고 무엇을 골랐는지에 대한 익명 기록은 ‘npx impeccable telemetry off’로 끌 수 있어요. README는 프로젝트 이름, 파일, 코드, PRODUCT.md는 보내지 않는다고 밝혀요.
설정이 꼬였을 때는 ‘/impeccable doctor’를 실행해 보세요. 오래된 컨텍스트 파일, 쓰지 않는 설정, 망가진 훅을 찾아 줘요.
자주 묻는 질문
임페커블은 무료인가요?
Apache 2.0 라이선스로 공개된 오픈소스라 무료로 설치할 수 있어요. 프로젝트 폴더에서 ‘npx impeccable install’을 실행하면 돼요. 탐지기는 LLM이나 API 키 없이 동작해요.
임페커블은 Claude Code에서만 쓸 수 있나요?
아니에요. Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode를 비롯한 여러 코딩 도구를 지원해요. Codex에서는 슬래시 명령 대신 ‘$impeccable’을 입력해요.
임페커블 명령어 중 무엇부터 써 보면 좋나요?
컴포넌트 하나를 골라 critique부터 실행해 보세요. 고칠 곳과 우선순위를 알려 줘요. 그다음 bolder나 quieter 같은 방향 명령으로 한 가지씩 바꾸고, 출시 전에 polish로 마무리해요.