개요
Hallmark는 Claude Code·Codex CLI·Cursor·OpenCode가 웹페이지를 만들 때 “AI가 만든 티”가 나지 않게 하는 디자인 스킬이다. Together AI가 만들고 MIT로 공개했다. 2026-10-27 기준 스타 38,011개, 포크 1,978개다. 이 위키는 7월에 PyTorchKR 소개글로 v1을 정리했다(2026-07-25-pytorchkr-topic-11348-hallmark-ai). 이 노트는 GitHub 저장소 원문 기준으로 v2(SKILL.md version: 2.0.0)를 다시 정리한 것이다.
접근 방식은 두 겹이다. 먼저 모델이 습관처럼 빠지는 기본값을 하드 플로어로 막는다. 그 위에서는 테마를 무작위로 배정해 연속된 빌드가 같은 모양으로 수렴하지 않게 한다. 결과물은 자체 완결형 HTML·CSS이고, CSS 첫 줄에 이번 빌드가 내린 결정이 스탬프로 남는다.
v1(7월 소개글) 대비 달라진 점
| 항목 | 7월 소개글(v1) | v2 저장소 원문 |
|---|---|---|
| 테마 | 20개 | 48개. 테마마다 완성 페이지 그림(.jpg) 1장과 8KB 이하 .md 1개 |
| 검증 | 57개 슬롭 테스트 + 자체 비평 | Floor·Reflex·Finish 3단 게이트 + sloplint --render 브라우저 검사 + 새 맥락 리뷰어 |
| 동사 | 생성·audit·redesign·study | README와 argument-hint에는 생성·redesign·audit만 있다 |
| 하네스 | Claude Code·Cursor·Codex | OpenCode 추가, Claude Code 플러그인 마켓플레이스 설치 경로 추가 |
| 이미지 | — | Wikimedia Commons의 공개 라이선스 사진 755장 목록(photos.json), 사용한 사진은 페이지에 출처 표기 |
v1의 study가 없어졌는지는 확인하지 못했다. flow.md·redesign.md는 읽지 않았다.
게이트 3단
- Floor: 절대 넘어가면 안 되는 바닥선. 대비, 포커스, reduced motion, 지어낸 사실, 깨진 모바일 레이아웃 등이 여기에 속하고 면제가 없다.
SKILL.md의 Floor는 16개 항목이다. 대표 항목:- 모든 색과 폰트는
:root토큰을 거친다 transition: all금지,width·height·top·left애니메이션 금지- 로마체 제목 안에 이탤릭 단어 하나를 섞지 않는다
- 지어낸 지표·추천사·로고 월·사례 수 금지
- 아이브로(제목 위 작은 라벨)와 자간 넓힌 대문자 라벨 금지
- 보라→파랑 그라디언트, 카드 속 카드, 이모지 아이콘, 손으로 그린 브라우저 창 금지
- 1280×800에서 스크롤 없이 히어로의 헤드라인·한 문장·주 액션이 다 보여야 한다
- 한 화면에 약 80단어
- 모든 색과 폰트는
- Reflex: 모델이 반사적으로 빠지는 기본값. 이유가 있으면 기록을 남기고 면제할 수 있다.
- Finish: 마감 디테일. 답은 해야 하지만 출시를 막지는 않는다.
괄호 안 번호(48, 10a, 38i, 85 등)는 gates.md의 게이트 ID다. 개수를 뜻하지 않으며, 전체 게이트 수는 확인하지 않았다.
빌드 흐름
- Pre-flight: 프로젝트를 먼저 읽는다(
design.md, 폰트, 팔레트, 프레임워크, Tailwind 설정). 실제 브랜드 이름이 나오면 기억으로 테마를 입히지 않고brand-truth.md절차를 따른다. - 한 번만 묻기: 소재(스크린샷·사진·실제 숫자·이름 붙은 인용), 대상 독자, 페이지가 이끌 행동 하나, 톤을 묻는다. 건너뛴 항목은 추론한다. 다만 숫자·인용·로고 같은 사실은 추론하지 않고, 받지 못하면 비워 둔다.
- Shape: 방문자가 하러 온 일(구독, 예약, 구매 등)을 정한다.
anatomy.md로 그 분야 실제 사이트가 행동 버튼을 어디에 두는지 확인하고, 21개 매크로구조 중 하나로 시작한다.theme.mjs draw가 셰입·히어로 자세·내비·푸터를 배정한다. - Direction:
theme.mjs deal이 프롬프트에 맞는 테마 3개를 뽑는다. 최근 로그와 겹치는 테마는 빼고 뽑는다. 사용자가 “custom”이라고 하면 테마 없이direction.md만 보고 설계하고, Floor와 게이트는 그대로 적용된다. - Picks 블록: 셰입·테마·히어로·시그니처·섹션·소재를 한 번 공표한다. 사용자가 방향을 바꿀 수 있는 지점이다.
- Build:
theme.mjs scaffold가tokens.css·base.css를 써 준다. 히어로만 먼저 만들고,sloplint --stage hero와 새 맥락 리뷰를 통과한 뒤에 나머지 섹션을 짓는다. 페이지는 섹션 6~9개, 보이는 단어 450개 이하로 한다. - Sweep:
sloplint --render로 FAIL을 0까지 줄이고, 판정형 게이트를 확인하고, 새 맥락의 서브에이전트가 마감 리뷰를 한다. 리뷰어의 첫 단어(recapture·rebuild·fix·ship)대로 처리한다.
재설계는 이름을 불렀을 때만 한다(/hallmark redesign <path>). 기존 디자인을 Hallmark가 알아서 손대는 일은 없다. 재설계 전에는 sloplint --before로 링크·폼 필드·핸들러·헤딩을 기록해 두고, 하나라도 사라지면 --kept가 실패시킨다. 깊이는 polish·restyle·full 세 가지다.
sloplint
의존성 없는 Node 린터다. HTML·CSS·프레임워크 컴포넌트·Tailwind 클래스를 읽는다. --render를 켜면 Chrome으로 페이지를 띄워 직접 잰다.
- 세 폭에서 첫 화면 경계(fold)
- 텍스트 뒤 실제 픽셀과의 대비
- Tab으로 찾은 포커스 링
- 섹션 리듬과 사진이 차지하는 비율
- 상자에 끼거나 다른 요소에 깔린 텍스트
README 기준으로 8개 폭을 검사한다. --render에는 puppeteer-core와 Chrome이 필요하고, 없으면 정적 검사만 돈다.
설치
npx skills add nutlope/hallmark -g # 전 프로젝트, Node 18+
# Claude Code 플러그인으로
/plugin marketplace add nutlope/hallmark
/plugin install hallmark@hallmark
# 아무 페이지나 린트
node skills/hallmark/scripts/sloplint.mjs <file-or-dir> --renderinstall-hook.mjs를 쓰면 Claude Code에 편집 시점 Floor 검사 훅이 붙는다(현재 옵트인).
저자들의 평가 결과
eval/README.md의 2026-07-23 실행 결과다. 저자들이 직접 잰 것이고, v2 이전 실행일 수 있다. 대부분 오픈 모델(GLM, Kimi K2.7-Code)을 API로 직접 호출한 Tier B 결과다.
- Floor만 넣은 팩은 GLM이 FAIL 96건, 전체 스킬 팩은 11건이었다. 11건은 sloplint 결과를 되먹인 수리 1회로 모두 해소됐다. 저자들은 Floor만으로는 대체가 안 되니 오픈 모델에도 스킬 전체를 넣으라고 결론 내린다.
- 지표를 지어내도록 유도한 브리프(b4)에서 지어낸 지표는 모든 모델에서 0건이었다.
- 한 모델의 6개 브리프 안에서 같은 매크로구조가 세 번 이상 반복되지 않았다.
- 지금은 오픈 모델을 개발 대상에서 뺐다. 실제
claude -p,codex exec, OpenCode를 돌리는 Tier A 적합성 검사로 방향을 옮겼다.
로드맵
- Now: 크림·오프화이트 종이, 알약형 버튼, 검정+산성 포인트 한 색, 헤어라인 신문 스타일이 이제 “생성된 룩”으로 읽힌다고 보고 테마를 어떻게 정리할지 정한다. 세 하네스 적합성 검사, 빌드 1회의 시간·토큰 측정도 이 단계에 있다.
- Next: 테마별 모션 토큰,
design.md로 여러 페이지를 한 사이트처럼 묶기, 브랜드 우선 흐름, 편집 시점 훅 기본 활성화, 앱 화면 전용 검사. - Later: Gemini CLI·Copilot 지원, 라이브 프리뷰 MCP 서버.
의미와 한계
2026-03-24-impeccable이 디자인 어휘·명령과 결정론적 안티패턴 검사를 준다면, Hallmark v2는 테마 배정과 실제 렌더링 측정에 무게를 둔다. 같은 브리프를 두 번 지어도 다른 페이지가 나오게 하고, 대비·폴드·포커스를 픽셀로 잰다. 2026-07-10-agents-with-taste에서 말한 “취향을 설명 가능한 규칙으로 옮기기”를 린터와 게이트 ID로 기계화한 사례로 볼 수 있다.
- “지어낸 사실 금지”가 Floor에 들어 있다. 디자인 스킬이 카피의 사실성까지 막는다는 점이 특징이다.
- 품질 개선 근거는 저자 자체 평가뿐이고, 독립 벤치마크는 없다. 미감 점수도 저자가 정한 vision judge(claude-fable-5 또는 운영자 채점) 루브릭에 기댄다.
- 흐름이 7단계에 서브에이전트 리뷰 2회라 한 페이지 빌드 비용이 크다. 저자들도 로드맵에서 토큰 측정을 숙제로 남겼다. 빠른 경로로
--fast가 있다.
관련 노트
- 2026-07-25-pytorchkr-topic-11348-hallmark-ai — 7월 PyTorchKR 소개글(v1 기준)
- 2026-03-24-impeccable — 결정론적 안티패턴 검사를 갖춘 다른 프론트엔드 디자인 스킬
- 2026-07-10-emilkowalski-skills-for-design-engineers — 디자인 엔지니어 취향·애니메이션 규칙 스킬
- 2026-10-02-github-cathrynlavery-diagram-design — 같은 계열의 다이어그램 전용 디자인 스킬
- moc-ai-coding-catalog