Community이미지github.com

font-design

브랜드에 맞춰 가변 웹 폰트로 사용자 정의 디스플레이 서체를 설계, 제작 및 배포합니다. 세 번의 컨셉 페이지 라운드를 거쳐 고유한 타이포그래피를 완성합니다.

font-design란 무엇인가요?

이 스킬은 웹사이트용 맞춤형 디스플레이 서체(타입페이스)를 설계하고 제작하여 셀프 호스팅 가변 웹 폰트로 배포하는 전체 과정을 안내합니다. 운영자가 기성 폰트 대신 브랜드에 맞는 고유한 서체를 원하거나, 헤드라인, 타이틀, 히어로 폰트를 카탈로그에서 고르는 것이 아닌 직접 디자인하기를 원할 때 트리거됩니다. 이 스킬은 'Bract' 또는 'Driftwood'와 같은 서체를 만드는 방식으로, 사이트 감사, 가이드라인 도출, 세 번의 컨셉 페이지를 통한 디자인 선택, 독립적인 검토, 빌드, 실제 페이지에서의 검토, 최종 출시까지의 9단계를 거칩니다. Claude Code, Codex 등 주요 AI 에이전트 플랫폼에서 사용할 수 있으며, Node.js, Python(fonttools 등), Chrome과 같은 도구 의존성을 자체 점검하고, 각 단계마다 게이트(gate)를 두어 운영자의 승인을 받도록 설계되어 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/windaddict/font-design-skill/tree/HEAD

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

font-design은(는) 무엇을 하나요?

버전 0.2.0 — 유일한 정보 출처는 저장소 루트의 VERSION 파일입니다. 이 줄, 머리말, README 배지는 tests/test_versions_and_skill.py에 의해 이 파일과 비교 검사됩니다. 작업을 시작할 때 이 버전 번호를 말하세요. 그래야 운영자가 어떤 복사본이 응답했는지 알 수 있습니다.

이 스킬은 Bract(hopsafari.com, 2026-11-15)가 만들어진 방식과 동일하게 타입페이스를 제작합니다. 즉, 아래의 9단계를 한 번에 전부 실행합니다. 제너레이터와 많은 규칙은 이전 서체인 Driftwood(movingavg.com, 2026-11-14)에서 비롯되었습니다. Driftwood는 프로세스가 문서화되기 전에 정적 유니온 파이프라인을 통해 5개의 CFF 파일로 빌드되었으며, 그 교훈과 나중에 발견된 세 가지 버그가 이 스킬을 형성했지만 Driftwood는 이 단계들을 거치지 않았습니다. 두 서체 모두 John Knox의 디자인입니다(NOTICE.md). 작업 형태는 다음과 같습니다: 사이트 감사, 가이드라인 도출, 세 번의 컨셉 페이지 라운드를 거쳐 디자인 선택, 빌드 계획 수립 및 독립적 검토, 자체 점검을 포함한 빌드, 실제 페이지에서 빌드된 폰트를 문제가 발견되지 않을 때까지 검토, 완료된 변경 사항에 대한 독립적 검토, 출시. 이 스킬은 각 게이트(gate) 사이에서는 거의 감독 없이 실행되며 모든 게이트에서 멈춥니다.

목차

  1. 시작하기 전에
  2. 9단계 (각 단계는 게이트를 동반)
  3. 감독 최소화하며 작업하기
  4. 게시 차단 요소
  5. 도구의 역할과 각 도구가 증명하는 것
  6. 참조 색인

1. 시작하기 전에

  1. 버전 명시(위) 및 변경 사항 분류. 사이트 전체 디스플레이 서체는 중요한 변경입니다. 공개 페이지에 영향을 미치고 일단 링크되고 캐시되면 되돌리기 어렵습니다. 전체 순서를 따르세요: 계획 → 독립적 검토 → 빌드 → 독립적 검토. 이미 검토된 컨셉 내에서의 매개변수 조정은 일상적인 작업입니다: 빌드, 테스트, 한 번의 디자인 라운드.
  2. 도구를 확인하고 어떤 도구가 있는지 말하세요. 확인을 실행하고, 추측하지 마세요:
    • node --version (≥ 20); 스킬 자체의 venv (<skill dir>/.venv, python3 -m venv .venv && .venv/bin/pip install -r requirements.txt 명령어로 스킬 디렉토리에 생성, fonttools 4.68.x, brotli, skia-pathops, pillow, uharfbuzz, unicodedata2 포함); Chrome ($CHROME 또는 OS별 기본 경로를 scripts/shoot.py가 검색); Impasse 스킬 (~/.claude/skills/impasse); frontend-design 플러그인; 그리고 Agent 도구가 제공하는 가장 강력한 모델 (이 저장소 기록에서는 "Fable"이라고 명명; 사용하는 환경에서 가장 강력한 모델을 사용하세요).
    • 이 스킬의 모든 Python 명령어는 해당 venv의 인터프리터에서 실행되며, 명령어는 이를 명시적으로 표기합니다. .venv/bin/python3 scripts/<tool>.py ...와 같이 작성하고, python이나 python3만 단독으로 사용하지 마세요. Homebrew Mac에서는 이것이 fonttools가 없는 다른 인터프리터입니다. 어떤 명령어도 이전 Bash 호출에서 설정된 변수나 디렉토리에 의존해서는 안 됩니다: 대부분의 호스트에서 한 번의 호출은 이전 호출을 기억하지 못합니다. 아래의 "스킬 폴더 찾기"에서는 짧은 형식을 임의의 디렉토리에서 실행할 수 있는 명령어로 바꾸는 방법을 설명합니다.
    • 먼저 .venv/bin/python3 scripts/check-env.py를 실행하세요. 플랫폼, Python ≥ 3.10, 고정된 버전의 네 가지 요구 사항, Node ≥ 20, Chrome 및 bash의 존재 여부를 나열하고, 각각 누락된 항목에 대한 정확한 수정 명령어를 출력하며, 하나라도 누락되면 종료 코드 1을 반환합니다. (venv가 존재하기 전에는 모든 Python 3로 동일한 스크립트를 실행하세요: 표준 라이브러리만 사용하며 venv 명령어를 출력합니다.) macOS와 Linux가 지원됩니다. 네이티브 Windows는 지원되지 않습니다(bash 스크립트, POSIX venv 경로). Windows에서는 전체 스킬을 WSL 내에서 실행하세요.
    • 머신에서 스킬을 처음 사용하기 전과 스킬 업데이트 후 매번 bash scripts/smoke.sh를 실행하세요. 프로젝트를 시작하기 전에 세 가지 fixture를 빌드하고, 테스트 스위트와 변형(mutations)을 실행하며, FontBakery 게이트를 실행하고(FontBakery가 설치되지 않은 경우 건너뛰고 그렇게 말함), 컨셉 페이지를 빌드합니다(--full은 브라우저 단계와 환경 확인을 추가합니다).
    • 누락된 항목에 대해서는 계속 진행하기 전에 references/fallbacks.md를 읽으세요. 절대 게이트를 조용히 건너뛰지 말고, 빌더 자신의 컨텍스트가 리뷰어가 되도록 절대 두지 마세요.
  3. 시작 질문을 하세요. 한 번의 메시지로 질문하고, 답변을 계획에 그대로 기록하세요: 운영자의 말로 표현된 목표(이 문장은 모든 리뷰어에게 인용됨); 어떤 사이트와 어떤 페이지; 함께 사용될 본문 서체; 브랜드 출처(마크, 색상, 재료, 역사); 원하는 굵기와 이탤릭 여부; 이름 후보; 이름 테이블 소유자 및 라이선스(기본값 없음 — 매번 물어보세요) 및 폰트의 임베딩 권한, names.fs_type(기본값 없음: 독점 서체의 경우 일반적으로 4, 미리보기 및 인쇄, 오픈 서체의 경우 0, 설치 가능; 2, 제한됨, 일부 도구가 폰트를 거부하게 함; 브라우저는 웹 폰트의 경우 이 필드를 무시함); 크기 예산; 컨셉 페이지가 claude.ai 아티팩트로 게시될 수 있는지 여부; 아티팩트를 Impasse(타사 제공자)에 보내는 것에 대한 동의; 누가 언제 배포할지. 프로젝트 파일이 위치할 곳을 결정합니다(관례는 사이트 저장소의 tools/<face>/입니다). 하지만 아직 아무것도 생성하지 마세요: 각 파일은 해당 입력을 생성하는 단계에서 만들어집니다 — requirements.json은 2단계, concepts.js는 3단계, font.json과 scripts/의 복사본은 7단계(6단계의 계획이 마스터와 축을 확정한 후). 프로젝트 중에는 설치된 스킬 폴더에 아무것도 기록되지 않습니다: 임시 파일(계획의 내보내기, 문자 집합 사전 확인, 측정값)은 프로젝트의 tools/<face>/work/ 아래에 위치하며, 사이트의 .gitignore에 이름이 지정됩니다.

스킬 폴더 찾기

이 파일의 모든 scripts/, references/, templates/ 경로는 이 SKILL.md가 있는 폴더, 즉 스킬 폴더를 기준으로 합니다. Bash 호출 시마다 호스트에 따라 절대 경로를 찾으세요:

  • Claude Code: ${CLAUDE_SKILL_DIR}, Claude Code가 실행 중인 스킬에 대해 제공합니다. 값이 비어 있으면 설치 폴더 ~/.claude/skills/font-design를 사용합니다.
  • Codex: Codex가 사용 가능한 스킬 목록에 표시하는 절대 경로. 추측된 설치 폴더가 아닌 해당 경로를 사용하세요.
  • 다른 모든 호스트: 로드된 SKILL.md가 있는 디렉토리의 절대 경로. 호스트가 파일을 로드한 위치에서 읽어오고, 설치 폴더 중 존재하는 것으로 선택하지 마세요.

이 파일의 모든 명령어는 스킬 폴더에서 입력하는 짧은 형식 .venv/bin/python3 scripts/<tool>.py ...으로 작성되었습니다. 다른 디렉토리에서 실행하려면 스킬 폴더의 절대 경로를 .venv/bin/python3와 scripts/ 앞에 추가하거나, Bash 호출을 cd "<skill folder>" &&로 시작하고 프로젝트 자체 파일(font.json, 사이트 루트)은 절대 경로로 지정하세요. 프로젝트의 스크립트 복사본 tools/<face>/scripts/도 동일한 방식으로 스킬의 인터프리터를 사용하여 실행합니다: <skill folder>/.venv/bin/python3 tools/<face>/scripts/....

2. 9단계

각 단계는 참조 파일, 생성하는 결과물, 운영자가 결정하는 게이트를 명시합니다. 스스로 게이트를 통과하지 마세요.

1단계 — 먼저 사이트 감사 (references/site-audit.md)

곧 변경될 페이지를 위해 그려진 폰트는 잘못된 페이지를 위해 그려진 것입니다. .venv/bin/python3 scripts/shoot.py OUT --serve <static dir> --pages index.html <page>.html --widths 500 1280 1600 --scales 1 2 명령어로 빌드된 사이트를 촬영합니다. Chrome headless는 최소 500px에서 레이아웃을 수행하므로 360px 읽기를 위해 scripts/narrow.html을 촬영합니다. shoot.py가 __fd/에서 제공하며 iframe 내부 페이지의 scrollWidth를 clientWidth와 비교하여 보고합니다: .venv/bin/python3 scripts/shoot.py OUT --serve <static dir> --pages __fd/narrow.html --widths 500 --scales 1 --dump-dom --no-sentinel --query url=/<page>.html --query width=360. 덤프된 .dom.html을 읽으세요: <html>이 data-fd-overflow="false" 및 data-fd-narrow-stage="fonts"를 가질 때만 페이지가 통과합니다(웹 폰트가 로드된 후 측정값; "load" 단계 측정값은 이전에 가져온 것이므로 계산하지 않음). frontend-design 플러그인이 설치된 경우 이를 사용하여 미적 검사를 실행하고, 그렇지 않으면 site-audit.md의 보정 목록을 사용하세요. "AI 징후"(제목 아래의 레이블을 반복하는 라벨, 호버 시 올라가는 박스형 카드, 장식용 규칙, 두 개의 내비게이션 또는 두 개의 날짜 형식, 반복되거나 수수께끼 같은 카피, 콘텐츠보다 큰 크롬)를 나열하고, 각각이 폰트에 대해 무엇을 변화시키는지 말하고, 폰트가 그려지기 전에 어떤 것을 수정할지 제안하세요. templates/reviewer-brief-audit.md로 감사를 기록합니다. 1단계는 감사하고 제안합니다. 게이트 전에는 아무것도 수정되지 않습니다.

게이트: 운영자가 폰트 전에 어떤 항목을 수정하고 어떤 항목을 기다릴지 선택합니다. 그런 다음 선택된 수정 사항을 브랜치에 구현하고, 각각 실패를 감시하는 테스트로 보호하며, 2단계 전에 자체 커밋으로 커밋합니다(Bract: hop-safari 2daac34, 폰트의 90a085c 이전): 이는 운영자가 이 게이트에서 판단한 사이트 디자인 변경 사항이며, 컨셉은 해당 페이지에서 평가됩니다. 폰트 변경 자체는 그 후에 시작되며 9단계까지 커밋되지 않습니다. 7단계의 "아무것도 커밋하지 않음"은 폰트 변경을 의미합니다.

2단계 — 사이트로부터 가이드라인 도출 (references/guidelines.md)

마이닝 전에 디스플레이 서체가 설정하는 모든 요소를 찾으세요. 두 도구 모두에 --family <오늘날 사용 중인 디스플레이 패밀리>를 제공합니다(mine-sizes.py <css> --family 'Bodoni Moda'; mine-charset.py --html <built pages dir> --css <css> --family 'Bodoni Moda'): font-family가 그것을 먼저 명명하는 각 규칙은 해당 선택자, @media 블록을 포함하여 제공하며, 목록이 출력됩니다. fixture 사이트에 수동으로 입력된 h1,h2,.plate-title은 .frontis-title, .wordmark 및 15.2px .num을 놓쳐서 하한선이 44.6에서 49.3 유닛으로 이동했습니다. 한계: body에서 서체를 상속하는 선택자(헤딩과 본문이 하나의 패밀리를 공유하는 사이트)는 발견되지 않으며, font: 단축 속성이나 사용자 정의 속성을 통해 설정된 패밀리는 읽히지 않습니다. 그런 다음 템플릿에서 선택자를 수동으로 지정하고, 패밀리 규칙이 놓친 요소에 대해 --selectors를 추가하세요. .venv/bin/python3 scripts/mine-sizes.py <css> --family <오늘날의 디스플레이 패밀리> --root 100 150을 실행하여 16px 기준 및 확대된 기준에서 서체가 견뎌야 할 크기와 가는 선 하한선(가장 작은 크기에서 1 CSS px는 1000/크기 유닛; 가는 선은 약 0.75px, --floor-px로 유지되어야 함)을 구하고, .venv/bin/python3 scripts/mine-charset.py --html <built pages dir> --css <css> --family <오늘날의 디스플레이 패밀리>를 실행하여 빌드된 페이지에서 해당 선택자가 설정한 텍스트의 문자 집합과 함정들(제목의 줄 바꿈 없는 공백, ASCII '로 입력된 아포스트로피, #, +, *, 악센트 문자, 그리고 text-transform 규칙이 브라우저가 그리도록 만드는 대문자)을 찾으세요. --css만 볼 수 있으므로 보지 못하는 것들은: 인라인 스타일, 스크립트 또는 읽을 수 없는 선택자( references/guidelines.md 섹션 6에 나열)에 의해 서체로 설정된 텍스트입니다. 이들은 수동으로 지정하세요. --titles <file>은 빌드된 페이지 대신 한 줄에 하나의 제목을 읽고, 어느 쪽이든 --json은 기계 판독 가능한 형태를 제공합니다. 가이드라인을 작성하세요: 크기, 하한선, 본문 서체와의 대비 두 축, 굵기, 대소문자, 문자 집합, 선례 교훈.

templates/requirements.example.json에서 지금 requirements.json을 생성하세요. 이것은 테스트가 폰트와 비교하는 검토된 기대치이며, 운영자와만 변경됩니다(docs/plan.md에서 F002 찾기). 각 필드의 출처와 시기는 다음과 같습니다:

필드출처시기
required_characters, titlesmine-charset.py --json: required_characters 그대로; 가장 긴 제목 보고서와 사이트의 실제 제목에서 가져온 제목들지금
cmap템플릿의 값: 생성기의 글리프 집합과 빌더의 따옴표 및 공백 글리프를 더한 것으로, 모든 프로젝트에 대해 동일함; extra-glyphs.js에 추가된 글리프는 여기에도 추가됨지금, 글리프가 추가될 때만 편집
names시작 질문(섹션 1, 항목 3): 소유자, 라이선스, 공급업체지금; 운영자가 답변하지 않은 경우 필드는 템플릿의 플레이스홀더로 남아 있으며 7단계를 시작할 수 없음(font.json names는 동일한 답변으로 채워짐)
groups.*.axes, masters, instances, avar, interpolated_check6단계 계획6단계, font.json이 존재하기 전
groups.*.hairline_floors7단계의 첫 번째 export.js 실행(마스터당 minStrokeWidth, 내림), 가장 작은 디스플레이 크기를 제공하는 각 마스터는 대상 mine-sizes.py가 출력한 값(1000 × 0.75 / smallest px) 이상으로 측정되어야 함; 그 목표 아래의 측정 최소값은 디자인 발견 사항(thin을 두껍게 하거나 가장 작은 요소를 본문 서체로 이동, 게이트 결정 3)이며 기록할 하한선이 아님. Bract의 15.2px 숫자는 0.75 목표에 대해 0.70px로 측정되었으며 해당 기록은 통과가 아닌 미해결 항목으로 보유합니다. 템플릿의 숫자는 가상의 Example 서체의 것입니다.7단계, 첫 번째 내보내기
groups.*.word_space, hand_kerns동일한 첫 번째 내보내기(마스터당 단어 간격)와 계획의 수동 켤레7단계
size_budget_bytes, fold_units, gasp시작 질문(예산) 및 템플릿의 값지금
names.fs_type, tables (code_page_range1, prep_hex, mac_names)시작 질문(임베딩 권한) 및 템플릿의 값지금
groups.*.vertical_metrics (ascender, descender, line_gap)첫 번째 빌드의 vertical metrics written 자체 점검 라인, 이후 검토됨: 플랫폼이 hhea 또는 typo를 읽는 곳에서 서체의 line-height: normal입니다(win 메트릭은 포함되지 않음)7단계, 첫 번째 빌드
accepted_qa_findings ([{id, reason, codes?}]; codes는 허용된 메시지 코드를 제한함)FontBakery 게이트의 첫 번째 실행, 각 항목은 허용되기 전에 읽혀짐; 그때까지는 []7단계

sizes 키는 없습니다: 크기는 가이드라인과 font.json review.sizes에 있습니다.

게이트: 가이드라인이 작성되고 표시되며, 세 가지 결정이 명시적으로 질문되고(각각 하나의 질문), 컨셉이 그려지기 전에 가이드라인과 requirements.json에 기록됩니다:

  1. 제너레이터가 놓친 각 문자

...

관련 스킬