pbakaus/impeccable은 코딩 에이전트에게 디자인 어휘를 주는 스킬입니다. Apache-2.0 라이선스이고 2026년 11월 7일 기준 깃허브 스타 104,798개입니다. Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI 등 20개 가까운 도구에서 씁니다.
AI 티란
README는 아무 지시 없이 에이전트에게 페이지를 맡기면 모델과 프로젝트를 가리지 않고 같은 것들이 나온다고 적습니다.
- 모든 글자에 Inter
- 보라에서 파랑으로 가는 그라데이션
- 카드 안에 또 카드
- 색 배경 위 회색 글자
- 제목마다 위에 붙은 둥근 사각형 아이콘
Impeccable의 검사기는 이런 신호와 좁은 여백, 건너뛴 제목 단계 같은 품질 문제를 규칙 62개로 잡습니다. 규칙은 결정적이라 LLM도 API 키도 쓰지 않습니다.
같은 모델, 같은 요청
README의 비교는 같은 모델(Fable 5.1)에 같은 요청(리구리아 해안의 방 14개짜리 가족 민박)을 준 결과입니다. Impeccable 없이 만든 페이지는 크림색 바탕, 얇은 세리프, 이탤릭 강조, 알약 버튼이 나왔습니다. Impeccable을 켠 페이지는 물에서 본 밤의 집 그림 한 장을 중심으로 섰습니다.
설치
npx impeccable install설치기가 쓰는 코딩 도구를 찾아 프로젝트용인지 전체용인지 묻고, 도구가 지원하면 디자인 훅을 권합니다. 훅을 켜면 에이전트가 고친 UI 파일을 매번 검사해 일을 끝내기 전에 결과를 돌려줍니다. README는 훅을 켜라고 권합니다. 훅이 없으면 누군가 기억해서 돌릴 때만 검사가 됩니다.
Claude Code 플러그인으로는 /plugin marketplace add pbakaus/impeccable 뒤 /plugin에서 설치합니다.
쓰는 법
프로젝트마다 한 번 /impeccable init을 돌리면 코드를 읽고, 추론할 수 없는 것(누구를 위한 제품인지, 무엇을 해야 하는지)만 물어 PRODUCT.md를 씁니다. 그다음 명령과 대상을 말합니다.
/impeccable critique the pricing cards
/impeccable quieter the landing page
/impeccable polish settings명령은 24개이고, 묶음은 이렇습니다.
| 묶음 | 명령 예 |
|---|---|
| 방향 바꾸기 | bolder 과감하게, quieter 차분하게, distill 덜어내기, colorize, typeset, layout, animate |
| 검토 | critique 사용성 점수와 고칠 순서, audit 접근성·성능·반응형 기술 점검(P0~P3) |
| 마무리 | polish, harden(오류·다국어·넘침), clarify(문구), adapt, optimize, onboard |
| 브라우저에서 | live 요소를 골라 변형을 바꿔 보기, generate |
| 계획 | shape, init, document(DESIGN.md), extract |
README는 페이지 전체보다 한 섹션을 좁게 볼 때 결과가 좋다고 적었습니다.
에이전트 없이 검사기만
npx impeccable detect src/ # 폴더 검사
npx impeccable detect http://localhost:5173 # 렌더된 페이지 검사
npx impeccable detect --github src/ # GitHub Actions 주석JSX, TSX 같은 소스 파일은 패턴 규칙만 봅니다. 낮은 대비나 너무 작은 글자처럼 화면이 있어야 보이는 규칙은 URL을 줄 때 돕니다. 브랜드 글꼴이 Inter라면 ignores add-value로 예외를 둡니다. Chrome 확장으로 아무 페이지에나 결과를 겹쳐 볼 수도 있습니다.
live 모드는 로컬 작업본에서만 쓰라고 README가 경고합니다. 배포된 사이트에 넣거나 보안 정책을 풀지 말고, 낯선 저장소에서는 실행되는 스크립트를 먼저 읽어 보세요.
비슷한 스킬, Hallmark
Nutlope/hallmark(MIT, 스타 약 5만)도 “AI가 만든 티가 나지 않는” 디자인 스킬입니다. 재질 테마 50개 중 세 개를 골라 페이지를 짓고 실제 브라우저에서 검사합니다. 기존 페이지는 /hallmark redesign으로 다시 짓거나 /hallmark audit로 점검만 합니다. 설치는 npx skills add nutlope/hallmark -g입니다. 새 페이지를 테마로 빨리 세우려면 Hallmark, 이미 있는 화면을 다듬으려면 Impeccable이 README 설명에 더 맞습니다.
오늘 할 일
내 사이트에서 섹션 하나를 골라 /impeccable critique부터 돌려 보세요. 점수와 함께 무엇부터 고칠지 순서가 나옵니다.
쇼츠로 보기
이 글은 비치콤버스 쇼츠 No.45의 짝 글입니다. 짧은 주소 beachcombers.co.kr/s/45.