개요

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·studyREADME와 argument-hint에는 생성·redesign·audit만 있다
하네스Claude Code·Cursor·CodexOpenCode 추가, 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다. 개수를 뜻하지 않으며, 전체 게이트 수는 확인하지 않았다.

빌드 흐름

  1. Pre-flight: 프로젝트를 먼저 읽는다(design.md, 폰트, 팔레트, 프레임워크, Tailwind 설정). 실제 브랜드 이름이 나오면 기억으로 테마를 입히지 않고 brand-truth.md 절차를 따른다.
  2. 한 번만 묻기: 소재(스크린샷·사진·실제 숫자·이름 붙은 인용), 대상 독자, 페이지가 이끌 행동 하나, 톤을 묻는다. 건너뛴 항목은 추론한다. 다만 숫자·인용·로고 같은 사실은 추론하지 않고, 받지 못하면 비워 둔다.
  3. Shape: 방문자가 하러 온 일(구독, 예약, 구매 등)을 정한다. anatomy.md로 그 분야 실제 사이트가 행동 버튼을 어디에 두는지 확인하고, 21개 매크로구조 중 하나로 시작한다. theme.mjs draw가 셰입·히어로 자세·내비·푸터를 배정한다.
  4. Direction: theme.mjs deal이 프롬프트에 맞는 테마 3개를 뽑는다. 최근 로그와 겹치는 테마는 빼고 뽑는다. 사용자가 “custom”이라고 하면 테마 없이 direction.md만 보고 설계하고, Floor와 게이트는 그대로 적용된다.
  5. Picks 블록: 셰입·테마·히어로·시그니처·섹션·소재를 한 번 공표한다. 사용자가 방향을 바꿀 수 있는 지점이다.
  6. Build: theme.mjs scaffold가 tokens.css·base.css를 써 준다. 히어로만 먼저 만들고, sloplint --stage hero와 새 맥락 리뷰를 통과한 뒤에 나머지 섹션을 짓는다. 페이지는 섹션 6~9개, 보이는 단어 450개 이하로 한다.
  7. 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> --render

install-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가 있다.

관련 노트