hallmark
무엇인가
Hallmark는 AI 코딩 에이전트가 웹 페이지 마크업과 CSS를 생성할 때 그 결과가 LLM 학습 분포의 기본값으로 수렴하지 않도록 디자인 결정 절차를 강제하는 스킬이다. 규율 대상은 팔레트·타이포그래피·레이아웃·페이지 구조의 선택이며, 코드 로직이나 백엔드 구현은 다루지 않는다.
어떻게 동작하나
규칙은 SKILL.md와 references/ 디렉터리에 나뉘어 들어가고, 카탈로그 밖 브리프를 위한 프로토콜은 custom-theme.md에 별도로 있다. 동작 순서는 브리프를 읽어 매크로구조를 하나 고르고, 21개 테마 중 맞는 것을 입힌 뒤, 57개 슬롭 테스트 게이트와 출력 직전 자기비평(pre-emit self-critique)을 통과시키는 것이다. 산출물은 자기완결적 HTML+CSS 한 벌이며, 선택된 매크로구조가 CSS 주석으로 표기된다. 카탈로그 테마로 커버되지 않는 창작 의도가 브리프에 실렸을 때만 Custom 분기가 발동해 팔레트·타이포·레이아웃을 처음부터 설계한다.
무엇과 다른가
프롬프트에 "AI처럼 보이지 말라"고 직접 쓰거나 일반 규칙 파일 한 장을 두는 방식과 달리, 테마 카탈로그·매크로구조 선택 규칙·게이트 목록이 파일로 고정되어 있어 브리프가 다르면 결과의 구조 자체가 달라진다. 같은 템플릿의 색상 변주가 나오지 않게 하는 것이 이 스킬의 구조적 차이다. Custom 분기는 일반 브리프에서는 발동하지 않는 조용한 경로로 분리되어 있다.
어떻게 쓰나
설치는 npx skills add nutlope/hallmark 한 줄이며, 재실행하면 갱신된다. 수동으로는 SKILL.md와 references/를 Claude Code의 ~/.claude/skills/hallmark/, Codex의 ~/.codex/skills/hallmark/(개인) 또는 .codex/skills/hallmark/(프로젝트), Cursor의 .cursor/rules/hallmark.mdc에 복사한다. Cursor에서는 SKILL.md 본문만 쓰고 frontmatter는 제거한다. 작업 예시는 docs/recipes.md와 docs/study-examples.md에 있다.
전제와 한계
Claude Code, Cursor, Codex에서 동작한다. 대상 산출물이 웹 페이지의 HTML+CSS이므로 그 밖의 도메인 디자인이나 코드 생성 규칙은 포함하지 않는다. 테마와 게이트 수는 저장소에 정의된 범위이고, 브리프가 카탈로그 밖 창작 의도를 담지 않으면 Custom 분기는 쓰이지 않는다. 라이선스는 MIT다.