Claude Code 디자인 스킬 Hallmark, 규칙 위반을 어디까지 막을까
Claude Code 디자인 스킬 Hallmark는 문서 지시와 실제 검사를 한 폴더에 묶었지만, 규칙 위반을 전부 막지는 않는다. 로컬 린터가 종료 코드 1을 내는 경우는 FAIL이나 미해결 REFLEX가 남았을 때다. 2026-11-09에 커밋 407fa689 기준으로 공식 문서를 읽고 격리 사본에서 직접 실행해 확인했다.
Floor 등급 항목도 판정이 WARN이면 종료 코드를 바꾸지 않는다.
Claude Code 디자인 스킬은 어디까지 코드로 막는가
스킬 파일을 폴더에 넣어도 저장이나 배포가 자동으로 잠기지는 않는다. 그래서 모델에게 읽히는 지시와 스크립트가 잡는 항목부터 나눠 봐야 한다.
Hallmark 공식 README(2026-11-09 확인)는 Claude Code, Codex, Cursor, OpenCode용 디자인 스킬이라고 소개한다. 사전 확인, 테마 선택, 히어로 우선 제작, 렌더 린트, 별도 검토가 문서에 적힌 작업 순서다.
규칙 문서 gates.md(2026-11-09 확인)는 심각도와 검사 방식을 따로 나눈다. 심각도는 면제 불가인 Floor, 근거를 적으면 면제되는 Reflex, 미세 완성도인 Finish, 별도 장부인 Ledger다. 검사 방식은 정적(M), 렌더(R), 판단(J)과 그 조합이다.
따라서 Floor는 스크립트, Finish는 사람이라고 짝지으면 틀린다. 같은 Floor 안에도 sloplint.mjs가 잡는 항목, sloplint-render.mjs가 재는 항목, 모델에게 내리는 지시가 섞여 있다.
그림의 네 단계 중 스크립트로 도는 것은 정적 검사와 렌더 검사뿐이고, 나머지는 문서 지시로 남는다.
정적 검사와 렌더 검사는 무엇을 잡았나
스킬 폴더를 샌드박스 프로젝트의 .claude/skills/hallmark로 복사해 직접 실행해 봤다. 모델 호출은 0회다. 환경은 Node v26.10.0, Chrome 157.0.8103.38, puppeteer-core@25.16.0이다.
시험용 HTML은 두 개다. 위반형에는 보라·파랑 그라데이션, transition: all, 포커스 스타일 누락, 제목 안 em, 가상 지표 12,345, 요청 없이 성공 문장을 찍는 폼을 넣었다. 비교형에는 이런 패턴을 빼고 색·폰트 토큰과 포커스 스타일을 넣었다.
node .claude/skills/hallmark/scripts/refcheck.mjs --errors
# 출력: refcheck: clean across 101 reference files
node .claude/skills/hallmark/scripts/sloplint.mjs pages/tells/index.html --genre editorial --json
node .claude/skills/hallmark/scripts/sloplint.mjs --url http://127.0.0.1:47831/tells/ --genre editorial --json
비교형은 tells를 plain으로 바꿔 같은 명령으로 돌렸다. 위반형 정적 실행이 남긴 탐지 근거 일부는 다음과 같다.
purple-to-blue gradient on .hero
transition: all on a
no :focus-visible styling anywhere
<em>/<i> inside <h1>
| 실행 구분 | FAIL | REFLEX | WARN | files / render | 종료 코드 |
|---|---|---|---|---|---|
| 위반형 정적 | 8 | 2 | 4 | 1 / off | 1 |
| 위반형 렌더 | 2 | 3 | 1 | 0 / ran | 1 |
| 비교형 초기 정적 | 0 | 0 | 2 | 1 / off | 0 |
| 비교형 초기 렌더 | 1 | 2 | 1 | 0 / ran | 1 |
| 비교형 최종 정적 | 0 | 0 | 2 | 1 / off | 0 |
| 비교형 최종 렌더 | 0 | 0 | 1 | 0 / ran | 0 |
비교형 초기 파일은 정적 검사에서 FAIL이 없었지만 렌더 검사에서 게이트 58, 77, 79에 걸렸다. 검사기는 고치지 않고 HTML 배치와 표만 한 번 수정해 다시 쟀다.
URL만 넘긴 렌더 실행은 files: 0이다. 소스 파일 검사를 대신하지 못하므로 정적 실행과 렌더 실행을 각각 돌려야 한다. 최종 비교형에도 WARN이 남았다. 종료 코드 0은 무경고라는 뜻이 아니다.
Floor 항목인데 왜 종료 코드를 바꾸지 못하나
종료 코드는 규칙 등급(tier)이 아니라 개별 발견의 판정(grade)을 본다. sloplint.mjs 소스에서는 --before가 아닐 때 fails > 0 또는 reflex > 0이어야 1을 반환한다.
위반형 정적 실행의 게이트 46a와 70이 그 예다. 둘 다 Floor 등급이지만 판정은 WARN이었다.
metric "Trusted by 12,345": verify the user supplied this number
a script prints success ("Thanks for sending") with no request behind it
프로그램이 숫자의 진위나 실제 전송 여부를 입증하지 못해 경고로 남긴 설계로 본다. --tier floor 옵션도 Floor이면서 FAIL인 항목만 남기므로 이런 경고는 출력에서 빠진다.
반대 예외도 있다. Finish는 문서상 전달을 막지 않지만, 가짜 인물 아바타 핫링크 항목은 문서와 코드 모두 FAIL로 처리한다. 소스로 확인했고 이 입력을 직접 실행하지는 않았다.
후처리 훅 lint-hook.mjs도 차단기가 되지 못한다. 스크립트에 아래 JSON을 직접 넣어 실행했다.
node .claude/skills/hallmark/scripts/lint-hook.mjs
{"tool_input":{"file_path":"<폴더>/pages/tells/index.html"}}
출력 JSON의 additionalContext는 Hallmark Floor check on index.html: 8 FAILs.로 시작했고 종료 코드는 0이었다. install-hook.mjs도 조언만 하며 막지 않는다고 적어 뒀다. 수정이 일어난 뒤 모델에게 알려 주는 장치다.
내 프로젝트에는 어떤 순서로 붙이나
전역 설정을 건드리지 않고 아래 순서로 확인하면 된다.
- Node 버전부터 맞춘다. README는 Node 18 이상을 안내하지만
puppeteer-core@25.16.0메타데이터는>=22.12.0을 요구한다. - 스킬을
.claude/skills/hallmark에 두고refcheck.mjs --errors로 참조 파일을 점검한다. - 파일 경로를 넣어
sloplint.mjs <경로> --genre <장르> --json으로 정적 검사를 돌린다. npm install --save-exact puppeteer-core@25.16.0으로 의존성을 넣고,HALLMARK_PUPPETEER와CHROME_PATH를 지정하고--url로 렌더 검사를 따로 돌린다.- 종료 코드와 함께
summary.render가ran인지, WARN에 지표 날조(46a)나 가짜 동작(70)이 남았는지 본다.
다섯째 단계를 빼면 안 된다. 소스 기준으로 렌더 의존성이 없어 summary.render가 not run: ...으로 남아도 그것만으로 종료 코드는 1이 되지 않는다. 이 경로는 직접 실행하지 않았다.
이번 실험이 확인하지 않은 것
네 도구의 자동 호출과 모델의 규칙 준수는 시험하지 않았다. 측정한 것은 로컬 HTML 두 개에 대한 스크립트 탐지 동작이다. 이 결과로 더 좋은 디자인이 나온다고 말할 수는 없다.
한국어 본문도 검증하지 않았다. 게이트 58과 면제 사유 검사는 영문 단어 패턴을 쓰고, 이번 HTML 본문은 영어였다.
npx skills add, 플러그인 설치, install.mjs, 실제 Claude 세션의 훅 발화도 실행하지 않았다. 코드는 MIT지만 photos.json의 사진은 개별 라이선스를 따른다고 README에 적혀 있다.
지시문과 검사를 나누는 기준은 컨텍스트 엔지니어링 새 규칙 — "지워라"가 통하는 규칙, 안 통하는 게이트에서 다뤘다. 훅 등록과 실제 차단의 차이는 Claude Code 훅이 안 막는 이유 — 로컬 적용 범위와 deny 점검에 정리했다.
결론
Hallmark는 작업 지시와 정적·렌더 린터를 함께 주지만 규칙 위반을 전부 막지는 않는다. 결국 기준은 등급 이름이 아니라 종료 코드, summary.render, 남은 WARN이다. 도입한다면 스킬을 복사한 뒤 정적 검사와 --url 렌더 검사를 각각 돌려 JSON 요약부터 확인하자.

댓글
댓글 쓰기