
브랜드 아이덴티티가 하는 일
brand-identity는 하나의 연결된 시스템으로 브랜드 아이덴티티를 설계하는 Claude Code 스킬입니다. 로고, 서체, 색상 팔레트를 각각 독립적으로 선택하는 대신, 모든 방향을 세 요소에 영향을 주는 하나의 아이디어 또는 메커니즘을 중심으로 구성합니다.
이 스킬은 세 가지, 경우에 따라 네 가지 아이덴티티 세트를 만듭니다. 각 세트를 아이덴티티 카드로 나란히 보여 주고, 중요한 기술적 속성을 측정한 뒤 방향을 선택할 수 있도록 멈춥니다. 세트를 선택하거나 여러 세트의 요소를 조합하면 브랜드 가이드라인 키트를 생성합니다.

주요 기능
- 조정된 아이덴티티 세트: 각 세트는 하나의 중심 메커니즘을 통해 심볼, 타이포그래피, 팔레트를 연결합니다.
- 측정에 기반한 결정: 이 스킬은 WCAG 2 및 APCA 대비, 색각 이상 시뮬레이션, 글리프 지원 범위, 글꼴 라이선스, 표 형식 숫자, 16픽셀 및 32픽셀에서의 로고 렌더링을 확인합니다.
- 품질 게이트: 측정에 실패하면 문제가 해결될 때까지 해당 세트를 중단합니다. 휴리스틱은 경고로 표시하고, 주관적인 선택은 판단이 필요한 항목으로 구분합니다.
- 브랜드 가이드라인 키트: 표준 키트에는 8페이지 PDF, 로고 파일, CSS·SCSS·Tailwind·DTCG JSON 형식의 디자인 토큰, 삽입 코드가 포함된 글꼴 시트가 들어 있습니다.
--full옵션을 사용하면 그리드, 다크 모드, 접근성, 아이코노그래피, 이미지 섹션이 추가되어 13페이지가 됩니다. - 웹사이트 스타일 변경: URL을 제공하면 기존 페이지에서 각 방향을 미리 볼 수 있습니다. 일부 요소는 유지하고 다른 요소는 새롭게 바꿀 수 있습니다.
- 집중 작업: 로고, 타입 시스템, 팔레트만 요청하거나 기존 아이덴티티에 대한 비평만 요청할 수 있습니다.
스킬 설치
권장: Claude Code 플러그인으로 설치
Claude Code에서 마켓플레이스를 추가하고 플러그인을 설치합니다.
/plugin marketplace add fatihaydost/brand-identity-skill
/plugin install brand-identity@brand-identity-skill일반 스킬로 설치
최신 릴리스에서 brand-identity.zip을 다운로드하고, 압축을 ~/.claude/skills/에 풀면 Claude Code가 해당 위치에서 스킬을 불러옵니다.

저장소를 클론한 뒤 심볼릭 링크를 만들 수도 있습니다.
git clone https://github.com/fatihaydost/brand-identity
mkdir -p ~/.claude/skills
ln -s "$PWD/brand-identity-skill/skills/brand-identity" ~/.claude/skills/brand-identity요구 사항 확인
이 프로젝트에는 Python 3.10 이상과 Chrome, Chromium, Edge, Brave 같은 Chromium 기반 브라우저가 필요합니다. 스크립트가 처음 실행될 때 Python 패키지를 캐시된 환경에 설치하므로 uv 사용을 권장합니다.
내장 확인 명령을 실행하면 누락된 종속 항목을 확인할 수 있습니다.
python3 skills/brand-identity/scripts/brand.py checkuv를 사용하면 일반적으로 fonttools, uharfbuzz, skia-pathops를 수동으로 설치할 필요가 없습니다. 권장 호스트는 Claude Code입니다. claude.ai 채팅에서는 기본적으로 샌드박스가 Google Fonts를 허용하지 않으므로 글꼴 측정과 렌더링이 실패할 수 있습니다.
첫 아이덴티티 프로젝트 실행
1. 일상적인 언어로 브리프 작성
원하는 결과를 Claude Code에 요청합니다. 예를 들면 다음과 같습니다.
리스본의 스페셜티 커피 로스터리를 위한 로고, 글꼴, 색상.
요청 범위를 좁힐 수도 있습니다.
https://example.com의 새로운 타입과 팔레트를 만들되 로고는 유지해 주세요.뉴스레터에 사용할 타입 시스템만 만들어 주세요.우리 브랜드 아이덴티티를 비평해 주세요.2. 질문에 답하기
이 스킬은 무엇을 만들지, 몇 개의 세트를 생성할지, 브랜드가 사용할 언어, 관련 경쟁사에 대해 한 차례 질문합니다. 가능하면 대상 고객, 분위기, 시장, 적용 분야, 제약 조건을 구체적으로 알려 주세요.
3. 아이덴티티 보드 검토
이 스킬은 제안된 방향을 만들고 비교 보드에 표시합니다. 각 방향에는 메커니즘, 심볼, 타입 선택, 팔레트, 측정 결과가 포함됩니다. 여섯 개 브리프의 측정 결과를 기준으로 하면 보드까지 전체 실행에는 약 40회의 에이전트 턴이 필요하며, 청구되는 입력 기준 토큰은 약 0.9백만 개입니다.
이 스킬은 방향을 대신 선택하지 않습니다. 콘셉트, 브리프에 대한 적합성, 필요한 게이트를 통과하는 측정 결과를 비교하세요.
4. 요소 선택 또는 조합
보드를 검토한 뒤 하나의 세트를 선택하거나, 세트 A의 로고와 세트 B의 팔레트를 조합하는 식으로 조합을 요청할 수 있습니다. 그러면 스킬이 선택한 키트를 만듭니다.


생성된 결과물 이해하기
선택한 아이덴티티는 표지, 아이디어, 로고, 변형, 색상 위 로고 사용법, 해당 심볼에 맞춘 잘못된 사용 예, 색상, 타이포그래피, 적용 사례를 다루는 8페이지 가이드라인 PDF를 생성합니다. 그리드, 다크 모드, 접근성, 아이코노그래피, 이미지 가이드도 필요하다면 --full을 사용하세요.
이 키트에는 풀 컬러, 단색, 반전, 앱 아이콘, 파비콘 버전을 포함한 SVG 및 PNG 형식의 로고 내보내기 파일도 들어 있습니다. CSS, SCSS, Tailwind, DTCG JSON용 디자인 토큰을 제공합니다. 글꼴 시트에는 선택한 서체와 임베드 코드가 정리되어 있습니다.

워크플로 작동 방식
이 프로세스는 크리에이티브 방향 설정과 기술 검증을 분리합니다.
- 질문: Claude Code가 브리프, 언어 요구 사항, 경쟁사 정보, 원하는 세트 수를 수집합니다.
- 세트 생성: 메커니즘, 마크, 서체 선택, 팔레트 시드를 포함한
sets.json을 생성합니다. - 로고 검토: 로고를 16픽셀과 32픽셀 크기의 콘택트 시트로 렌더링하고, 반복 검토를 통해 결함을 수정합니다.
- 빌드 및 감사: 스크립트가 팔레트 역할, 아이덴티티 카드, 감사 결과, 비교 보드를 생성합니다.
- 게이트 처리: 대비, 글꼴 라이선스, 글리프 지원 범위, 파일 유효성, 렌더링 실패가 발생하면 해당 세트를 수정 단계로 되돌립니다.
- 선택 및 키트 생성: 선택을 완료하면 스킬이 PDF, 로고 파일, 토큰, 글꼴 시트를 내보냅니다.
더 나은 결과를 위한 고급 팁
언어 요구 사항을 명확히 지정하기
브랜드가 지원해야 하는 모든 언어를 Claude Code에 알려 주세요. 이 스킬은 브랜드가 사용하는 언어를 기준으로 글리프 지원 범위를 확인하므로, 이 정보가 서체 선택과 검증에 영향을 줍니다.
접근성을 디자인 제약 조건으로 삼기
대비를 최종 시각 점검으로만 취급하지 마세요. 이 프로젝트는 WCAG 2 및 APCA 측정, 색각 이상 시뮬레이션, 로고 크기 검사를 게이트로 사용합니다. 생성된 팔레트를 실제 맥락에서 평가할 수 있도록 브리프에 사용할 배경과 용도를 포함하세요.

웹사이트 미리 보기 요청하기
사이트 URL을 제공하면 스킬이 현재 로고, 서체, 색상을 읽고 각 아이덴티티 방향을 페이지에 미리 표시합니다. 유지해야 하는 요소에는 keep을, 발전시킬 부분에는 refresh를 사용하세요.
익숙한 AI 기본값에 도전하기
Brand-identity는 크림색, 테라코타, 골드, Fraunces, Inter 또는 원 안에 숨긴 글자와 같은 조합으로 자동 수렴하는 것을 피하도록 설계되었습니다. 어떤 방향이 익숙한 패턴을 사용하면 스킬은 브리프에 근거한 이유를 요구하며, 실행마다 최소 한 세트는 이러한 기본값을 전혀 사용하지 않습니다.

라이선스 및 네트워크 액세스 검토하기
이 스킬은 Google Fonts와 google/fonts 저장소에서 글꼴과 메타데이터를 다운로드합니다. uv는 Python 패키지를 위해 PyPI에 연결하며, 브라우저는 사이트 URL 또는 이름이 지정된 경쟁사 사이트의 URL을 제공한 경우에만 해당 사이트를 엽니다.
텔레메트리는 없으며 어떤 정보도 업로드되지 않습니다. 글꼴은 서브셋으로 만들거나 재배포하지 않고, 글꼴 링크와 임베드 코드를 제공합니다. 글꼴 라이선스는 패밀리별로 확인하며, 기본적으로 OFL을 사용하고 Fontshare 또는 상용 서체에 대해서는 추가 메모를 제공합니다.
로컬에서 개발 및 테스트하기
저장소에 기여하거나 검증하려면 개발 요구 사항을 설치하고 다음 테스트 명령을 실행하세요.
pip install -r requirements-dev.txt
python3 -m unittest discover -s tests
python3 tools/smoke_test.py
python3 tools/package_skill.py저장소에는 skills/brand-identity/의 스킬, tools/의 개발 도구, tests/의 단위 테스트, evals/의 평가 픽스처, docs/의 아키텍처 및 테스트 문서가 포함되어 있습니다.
결론
brand-identity는 자연어 브리프를 서로 연결된 여러 아이덴티티 방향으로 변환한 다음, 창의적인 탐색과 측정 가능한 기술 검사를 결합합니다. Claude Code에 설치하고 브랜드와 제약 조건을 설명한 뒤, 생성된 세트를 비교하고 브리프에 가장 잘 맞는 요소를 선택하거나 조합하세요. 그 결과는 고립된 로고 콘셉트가 아니라 실용적인 가이드라인 키트입니다.
이 프로젝트는 MIT 라이선스로 공개됩니다. 구현 세부 정보는 저장소의 GitHub 프로젝트를 참조하세요.
