홀마크, AI 티 나는 웹 화면을 테마 48종과 브라우저 검사로 걸러낸다 — 임페커블은 탐지 규칙 62개
이번 주 GitHub 트렌딩에 디자인 스킬 두 개가 함께 올라왔다. 홀마크(hallmark)와 임페커블(impeccable)은 코딩 에이전트가 만든 화면에서 'AI 슬롭(slop, AI가 찍어낸 듯 뻔하고 조잡한 결과물)'을 걷어낸다. 둘 다 Claude Code와 Codex에 설치할 수 있어서 에이전트별 설정법을 따로 정리했다.
1. 홀마크 — 페이지를 만들고 브라우저로 직접 검사한다
- 대상 에이전트: 공통(Claude Code, Codex, Cursor, OpenCode)
- GitHub: Nutlope/hallmark — https://github.com/Nutlope/hallmark (MIT 라이선스, 약 3만 4천 스타, 오늘 트렌딩에서 하루 1,317스타)
- 하는 일: 테마 48종 가운데 요청에 맞는 3개를 제안하고, 방문자가 하러 온 일을 중심으로 페이지를 짠다. 이어서 화면 너비 8가지로 스크린샷을 찍어 AI 디자인 특유의 버릇을 린트(lint, 자동 규칙 검사)하고, 맥락 없이 새로 띄운 리뷰어가 마지막으로 점검한다.
- 설치 조건: Node 18 이상이 필요하다. 브라우저 검사까지 쓰려면 npm i -g puppeteer-core 로 퍼펫티어를 설치하고 크롬도 깔아 둔다. 둘이 없어도 정적 검사는 돌아간다.
- Claude Code에 설치: npx skills add nutlope/hallmark -g --agent claude-code
· 플러그인으로 설치하려면 /plugin marketplace add nutlope/hallmark 를 실행한 뒤 /plugin install hallmark@hallmark
· 호출: /hallmark <요청> (플러그인으로 설치했다면 /hallmark:hallmark)
- Codex에 설치: npx skills add nutlope/hallmark -g --agent codex
· 설치 위치는 ~/.agents/skills/hallmark 이고, $hallmark <요청> 으로 부른다.
- 자주 쓰는 명령: /hallmark redesign ./src/app (내용과 연결 코드는 그대로 두고 디자인만 바꾼다), /hallmark audit ./index.html (페이지는 건드리지 않고 검사만 한다)
- 활용 팁: 기존 화면을 갈아엎기 전에 audit부터 돌려 본다. 검사 결과는 세 등급으로 나뉜다. Floor(대비, 포커스, 모션 줄이기, 휴대폰 레이아웃 등) 위반은 배포를 막고, Reflex는 이유를 기록하면 넘어가며, Finish는 다듬을 거리만 알려 준다.
2. 임페커블 — 명령 24개로 화면을 단계별로 다듬는다
- 대상 에이전트: 공통(Claude Code, Codex 등)
- GitHub: pbakaus/impeccable — https://github.com/pbakaus/impeccable (Apache 2.0, 약 8만 8천 스타)
- 하는 일: 스킬 하나에 명령 24개를 담았다. 결정적 탐지 규칙(돌릴 때마다 같은 결과를 내는 규칙) 62개로 AI가 만든 프론트엔드의 흔한 결함을 잡는다.
- Claude Code에 설치: 프로젝트 루트에서 npx impeccable install 을 실행하고, 끝나면 Claude Code를 다시 불러온다.
· 설치기가 .claude/settings.local.json 에 훅(hook, 특정 시점에 자동 실행되는 스크립트)을 추가한다. 이 파일은 git에서 제외되므로 팀 저장소에는 올라가지 않는다.
· 플러그인으로 설치하려면 /plugin marketplace add pbakaus/impeccable 을 실행한 뒤 /plugin 목록에서 고른다.
· 사용법: 먼저 /impeccable init 을 실행한다. 그다음 /impeccable audit the header 처럼 명령을 붙인다.
- Codex에 설치: npx impeccable install --providers=codex
· 설치하거나 업데이트한 뒤 Codex에서 /hooks 를 열어 프로젝트 훅을 승인한다. 훅 정의가 바뀌면 다시 승인해야 할 수 있다.
· Codex에서는 /prompts: 명령 대신 스킬로 동작한다. /skills 를 열거나 $impeccable 로 부른다. 저장소 전용 설치는 .agents/skills/ 에, 사용자 전역 설치는 ~/.agents/skills/ 에 들어간다.
- 업데이트: npx impeccable update
- 활용 팁: 자주 쓰는 명령은 /impeccable pin audit 처럼 고정해 둔다. 그러면 /audit 단축 명령이 생긴다. polish(마감), harden(예외 상황 보강), typeset(타이포그래피 정리)처럼 단계별로 나눠 돌리면 변경 범위를 추적하기 쉽다.
둘 중 무엇을 고를까
- 새 페이지를 처음부터 만든다면 홀마크가 맞다. 테마 선택부터 검증까지 한 번에 처리한다.
- 이미 있는 화면을 조금씩 고친다면 임페커블이 낫다. 명령을 잘게 나눠 원하는 부분만 손본다.
- 임페커블은 설치할 때 훅을 넣고, 홀마크도 저장소를 클론해 install-hook.mjs 를 돌리면 Claude Code에 편집 시점 Floor 검사 훅을 추가한다. 둘 다 훅을 켜 두면 편집할 때마다 검사가 두 번 돈다. 설치 옵션은 바뀔 수 있으니 공식 README에서 한 번 더 확인하자.
오늘 할 일: 작업 중인 페이지 하나에 /hallmark audit 을 돌리고, Floor 등급 위반이 몇 개인지부터 세어 보자.
출처:
https://github.com/trending
https://github.com/Nutlope/hallmark
https://github.com/pbakaus/impeccable
댓글 (0)
아직 댓글이 없습니다.
댓글을 쓰려면 입장하세요.
← 목록