Communitygithub.com

매뉴얼-데-마르카 (브랜드 매뉴얼)

승인된 로고 SVG와 브랜딩 제안서를 기반으로 슬라이드 덱 형태의 브랜드 매뉴얼(브랜드북)을 생성합니다. 로고 버전, 그리드 시스템, 보호 영역, 최소 크기, CMYK/팬톤 색상, 라이선스가 적용된 타이포그래피, 로고 .zip 파일을 포함합니다. 브랜드북, 브랜드 매뉴얼, 아이덴티티 매뉴얼, 로고 사용 가이드 또는 브랜드 규정을 요청할 때 사용하세요. 전략 수립(propuesta-branding)이나 브랜드 보드(brand-board) 제작에는 사용하지 마세요.

매뉴얼-데-마르카 (브랜드 매뉴얼)란 무엇인가요?

이 스킬은 디자이너가 직접 설명하지 않아도 고객, 팀, 공급업체가 브랜드를 일관되게 사용할 수 있도록 하는 규범적인 브랜드 매뉴얼(브랜드북)을 제작하는 전문 AI 에이전트입니다. 승인된 로고 SVG와 기존 브랜딩 제안서를 입력으로 받아, 로고 버전(색상 변형, 재구성, 잠금 업), 그리드 및 보호 영역, 최소 크기, CMYK/팬톤 색상 시스템, 라이선스가 적용된 타이포그래피, 잘못된 사용 예시 등을 슬라이드 덱 형식으로 문서화합니다. '한 번에 하나의 질문, 항상 추천과 이유를 제시'하는 대화형 인터뷰를 통해 결정을 내리고, 내장된 Python 스크립트(svg_inspect.py, logo_variants.py, compose.py, color_system.py 등)를 사용하여 SVG를 분석하고, 색상 변형을 생성하며, 그리드와 최소 크기를 계산하고, Pantone 근사치를 산출합니다. 주요 기능으로는 로고의 동적 아이덴티티 지원(변경 가능한 부분과 고정 부분 그룹화), FOGRA39 CMYK 프로파일을 사용한 인쇄 색상 시뮬레이션, ΔE2000 기반 Pantone 참조, Google Slides API를 통한 덱 생성, 승인된 SVG만 포함된 최종 파일 패키지(.zip) 제공이 포함됩니다. 각 결정은 구체적이고 측정 가능하게 문서화되며(예: '24mm / 90px 너비'), 계산된 Pantone 값은 공식으로 제시되지 않고 물리적 가이드로 검증하도록 표시됩니다. 이 스킬은 로고를 재그리거나 개선하지 않으며, 명시적인 승인 없이 새 버전을 생성하지 않고, 전략이나 라이선스를 임의로 만들지 않습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/albdanyb22/skills-branding/tree/HEAD/manual-de-marca

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

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

문서

브랜드 매뉴얼

이미 결정된 아이덴티티(로고 + 전략)를 규범적인 매뉴얼로 변환합니다. 매뉴얼은 디자이너가 없어도 고객, 팀, 공급업체가 브랜드를 올바르게 사용할 수 있도록 안내하는 문서입니다. 매뉴얼은 결정을 문서화할 뿐, 스스로 결정을 내리지 않습니다. 따라서 이 스킬은 많은 질문을 하고 승인 없이 거의 생성하지 않습니다. 매뉴얼이 기술하는 모든 사항은 고객 앞에서 방어할 수 있어야 합니다.

이 스킬의 전체 진행 방식: 한 번에 하나의 질문, 항상 추천과 이유를 제시합니다. 상대가 이의 없이 수락하면, 그 의미(비용)를 한 문장으로 설명하고 계속 진행합니다. 진행 상황을 큰 소리로 알립니다("6블록 중 3 — 색상"). PPT, SVG, 라이선스 웹사이트 등을 보고 알 수 있는 것은 질문 대신 직접 확인합니다.

도구

이 스킬은 이 파일과 함께 scripts/ 및 references/ 디렉토리에 있는 자체 스크립트와 가이드를 사용합니다. 스크립트는 Python과 Playwright/Chromium, Pillow, numpy, scipy를 사용합니다. text_to_svg.py는 추가로 uharfbuzz가 필요합니다(pip install --break-system-packages uharfbuzz). 모든 스크립트는 -h 옵션을 지원합니다. 가이드:

  • references/entrevista.md: 순서대로 질문 모음, 기본 추천 포함.
  • references/nucleo.md: 기본 매뉴얼 페이지.
  • references/modulos.md: 확장 모듈(FIFA 월드컵 26 공개 매뉴얼 참조).
  • references/esqueleto-slides.md: 고정된 편집 템플릿 및 덱의 기술적 구성.

가시적인 작업 목록을 유지하세요(분석, 인터뷰, 버전, 구성, 색상, 덱, 패키지). 작업이 길어질 수 있으므로 사용자가 나갔다가 돌아올 수 있습니다.

단계 0 — 필수 입력

누락된 항목을 한 번에 요청하세요:

  1. SVG 형식의 로고(텍스트는 윤곽선 처리되어야 함). PNG/JPG만 있는 경우 중단하세요. SVG 없이는 측정하거나 신뢰할 수 있는 버전을 생성할 수 없습니다. 다른 SVG(다른 버전, 구성 그리드)도 요청하세요.
  2. 이전 브랜딩 프레젠테이션: Google Slides(propuesta-branding에서 생성), .pptx 또는 PDF. 존재하지 않으면 중단하고 propuesta-branding 실행을 제안하세요. 매뉴얼은 전략을 만들지 않습니다.

프레젠테이션을 읽으세요(.pptx의 경우 python -m markitdown 또는 python-pptx 사용; 시각적 아이덴티티 페이지의 이미지도 추출하여 확인하세요. 로고 시스템, 적용된 팔레트, 조각들이 보통 여기에 있습니다). 프로필을 만드세요: 우리는 누구인가, 미션, 비전, 가치, 성격, 톤(사용/회피), 포지셔닝, 만트라, 로고 콘셉트, 무드보드, 타입보드, 팔레트, 타이포그래피 및 암묵적 규칙(예: "이름은 항상 검은색, 접두사는 색상 변경"). 매뉴얼에 필요한 필드가 누락된 경우 해당 필드만 질문하세요. 색상에 읽을 수 있는 HEX가 없으면 이미지에서 보여주고 확인을 요청하세요.

단계 1 — SVG 분석

python scripts/svg_inspect.py logo.svg trabajo/inspeccion/

inspeccion.png를 보여주고 그룹을 제안합니다. 일반적으로 심볼/로고타입/태그라인이지만, 아이덴티티가 동적(하위 브랜드, 건물, 지사 등에 따라 한 부분의 색상이 변경되는 경우)인 경우 색상 규칙별로 그룹화하세요: 변경되는 부분, 고정 부분, 변경되는 부분을 따르는 부분. 이렇게 하면 각 변형을 하나의 명령으로 생성할 수 있습니다. 확인을 받고 trabajo/grupos.json에 저장하세요(예: {"prefijo": ["1-4"], "nombre": ["5-10"], "simbolo": [0]}). 경고(라이브 텍스트, 확장되지 않은 선, 그라데이션, 포함된 이미지)에 주의하세요.

단계 2 — 인터뷰

references/entrevista.md를 따르세요(6개 블록: 범위 → 로고 → 색상 → 타이포그래피 → 비주얼 언어 및 적용 → 문서 제어). 위험이 낮은 결정은 한 메시지에서 해결된 것으로 간주할 수 있습니다("수정하지 않으면 X로 가정합니다"); 되돌리기 어려운 결정은 따로 다룹니다.

완료 후 결과 목차(핵심 + 모듈, 페이지 번호 포함)를 제시하고 아무것도 생성하기 전에 승인을 기다리세요.

단계 3 — 로고 버전(항상 사전 승인 필요)

색상 변형. 제안을 생성하여 시트로 표시한 후, 변형 그룹 · 해결 방법 · 용도, 그리고 내린 결정이 포함된 표를 제시하세요. 다음은 단계 5의 대비 표를 통해 제기하거나 해결해야 할 일반적인 의문 사항입니다:

  • 네거티브에서 색상을 유지합니까, 아니면 흰색으로 변경됩니까? 색상 네거티브는 해당 색상이 어두운 배경과 대비되는 경우(≥ 3:1)에만 존재합니다. 그렇지 않으면 모노크롬 흰색입니다.
  • 팔레트 색상인 배경 위에서 로고는 단일 잉크(검정 또는 흰색)로 표시되며, 팔레트의 다른 색상으로 표시되지 않습니다.
  • 단색에서 내부 디테일이 뒤의 모양과 합쳐집니까? 컷아웃("calar")을 제안하세요.
  • 동적 아이덴티티에서: 함께 제공되는 요소(예: 심볼)가 다른 색상을 취할 수 있습니까? 그렇지 않다고 권장하세요(한 요소 = 한 색상)하고 비용을 언급하세요.
python scripts/logo_variants.py logo.svg trabajo/variantes.json trabajo/versiones/ --version apilada

재구성(가로 ↔ 세로, 심볼 단독, 아바타, 잠금 업):

  1. SVG가 이미 존재하는지 질문하고, 있으면 사용하세요.
  2. 없으면 compose.py로 구성하세요: 기존 요소만 재배치, 크기 조정, 분리하며 절대 다시 그리지 않습니다. 두 줄을 한 줄로 바꾸려면 각 그룹의 기준선(descender가 없는 글자의 하단) 과 단어 내 글자 간격과 동일한 간격을 사용하여 "alinear": "base"를 사용하세요. 하나의 단어로 읽히도록 합니다.
  3. 미리보기(아바타의 경우 _circulo.png, 파비콘의 경우 32px 및 16px 테스트)를 표시하고 하나씩 승인을 기다리세요.
  4. 승인된 후, 승인된 각 색상 변형을 반복하여 변형을 생성합니다(주 버전의 SVG 파일을 반복).

텍스트 잠금 업(슬로건, 하위 브랜드 또는 건물 이름): 텍스트를 브랜드 서체의 윤곽선으로 변환하고(설치된 글꼴에 의존하지 않음) 외부 요소로 추가하세요:

python scripts/text_to_svg.py "연결합니다. 살아갑니다. 소속됩니다." fuente.woff trabajo/slogan.svg --color "#1D1D1B"

(Google Fonts는 npm i @fontsource/<family>로 가져옵니다. .woff를 사용하세요.) compose.py에서 "externos": {"slogan": "trabajo/slogan.svg"} 및 "ancho": {"slogan": "logo"}를 사용하여 로고와 너비를 동일하게 만듭니다. 이름이 정의되지 않은 하위 브랜드의 경우 "[이름]"과 같은 마커를 남기고 구조를 정규화합니다. 잠금 업 텍스트는 로고의 고정 부분 잉크로 표시되며, 가변 색상으로 표시되지 않습니다.

잘못된 사용 예시(실제 로고 사용, --fondo-malo: 주 버전에 대한 대비가 가장 낮은 팔레트 색상):

python scripts/incorrect_uses.py trabajo/versiones/<principal>.svg trabajo/incorrectos/ --grupos g.json --nombre "<marca>" --fondo-malo "#2B57E2"

(g.json은 심볼이 포함된 isotipo 그룹과 나머지가 logotipo 그룹이어야 합니다.)

단계 4 — 그리드, 보호 영역 및 최소 크기

  1. 구성 그리드가 있는지 질문하고 해당 SVG를 요청하세요. 있으면 그대로 사용하십시오. 없으면:
  2. python scripts/construction.py candidates logo.svg trabajo/constructivo/ --grupos trabajo/grupos.json 를 실행하고 한 장의 시트에 후보들을 보여주세요. 대개 두 가지를 결합하는 것이 좋습니다: 선 두께를 평면의 모듈로(glyph의 세로 획에 적용)하고 심볼 너비를 보호 영역의 측정값으로 사용합니다. ("심볼 하나의 공간을 비워두세요" — 모든 공급업체가 이해하기 쉬움). 공동 브랜딩: 두 배.
  3. 각 버전에 대해 python scripts/construction.py plano <version>.svg trabajo/constructivo/<version> --modulo <u> --proteccion <modules>
  4. python scripts/min_size.py <version>.svg trabajo/minimos/<version> --grupos g.json (g.json에 logotipo가 있고 tagline이 있으면 포함). 세로선이 얇은 경우(심볼의 십자가) 스크립트는 두 가지 임계값을 제공합니다: [완전] 모든 것이 읽힘 / [읽을 수 있음] 이름이 읽히고 심볼은 점으로 보임. 각 버전을 여러 크기(실제 및 확대)로 테스트 시트를 만들어 사용자가 선택하도록 하세요. 일반적으로 공식 최소 크기는 [읽을 수 있음]이며, 작은 형식(서명, 사원증)에서는 심볼을 별도로 크게 표시합니다.

단계 5 — 색상 시스템

  1. trabajo/colores.json을 만드세요: 색상별 HEX 소스, 역할, 원본 자료에서 가져온 RGB/CMYK/팬톤, 검증용.
  2. 사용자에게 검증된 팬톤이 없으면 작업을 제공하세요: python scripts/pantone_ref.py trabajo/colores.json trabajo/pantone_ref.json (ΔE 2000에 따른 가장 가까운 Pantone C 및 섬유 TCX). 결과를 colores.json에 복사하고 ΔE와 함께 표로 제시하세요: < 2 거의 동일, 2–5 유사, > 5 눈에 띔, > 10 대체 불가.
  3. python scripts/color_system.py trabajo/colores.json trabajo/color/: FOGRA39 프로파일(있는 경우)을 사용하여 CMYK로 변환하고, 색역 외 색상(인쇄 시 어떻게 보일지)에 대해 경고하고, RGB/HEX를 검증하고, 50–950 스케일과 대비 매트릭스를 계산합니다.
  4. 디자인하기 전에 경고를 제시하세요. CMYK에서 탁하게 나오는 색상과 직접 팬톤(스티커, 표지판)이 적합한 곳을 설명하세요. 계산된 모든 팬톤/TCX는 "참고용이며, 실제 가이드 및 색상 테스트로 검증 필요"라고 매뉴얼에 표시하세요. 공식으로 제시하지 마세요. 검정색의 경우, 농후 검정(큰 면적)과 0/0/0/100(텍스트)을 구분하세요.
  5. 대비 매트릭스는 각 배경 위의 텍스트 잉크와 로고 잉크를 결정합니다. PPT가 "X는 항상 검정"이라고 말하고 특정 배경에서 대비가 불가능한 경우, 이를 알리고 수정된 규칙("X는 대비되는 잉크로")을 제안하세요.

단계 6 — 타이포그래피 및 라이선스

질문하기 전에 웹에서 각 글꼴의 라이선스를 찾아보세요:

  • Google Fonts / OFL: 문제 없음.
  • "개인용 무료": 상업적 로고에는 적용되지 않습니다. 출처를 물어보세요.
  • Envato Elements: 로고를 포함하지만, 구독이 활성화된 상태에서 해당 프로젝트에 글꼴을 등록하고 인증서 PDF를 보관해야 합니다. 등록하지 않은 경우 가장 중요한 미결 사항입니다. 매뉴얼에 라이선스 코드 마커를 넣으세요.
  • 특정 시스템으로 제한됨(예: SF Pro): 경고하고 무료 대안을 제안하세요.

로고타입의 글꼴이 윤곽선으로 제공되는 경우 "로고 아트에만 사용되며 설치되지 않음"으로 선언하세요. 대체 글꼴(Google Docs/Canva 및 Word용)과 브랜드 음성으로 작성된 예제가 포함된 계층 구조를 정의하세요.

타사 일러스트레이션(스톡, Figma 커뮤니티): 해당 라이선스도 확인하세요 (Streamline Free의 경우 저작자 표시 필요, 프로젝트당 25개 허용, 재배포 금지). 타사에 전달할 수 없는 경우 매뉴얼에서는 크레딧과 함께 참조 스타일로 표시하고 .zip에 포함하지 않습니다. Figma에서 가져오려면 공식 커넥터(create_session → get_metadata → base64로 get_screenshot, 파일은 디스크에 저장됨)를 사용하세요. Starter 플랜에서는 호출이 제한되므로 다운로드 전에 위치를 파악하고 선택하세요. 로컬 Figma 커넥터가 "Token expired"를 반환하면 앱 설정(또는 설정 → 확장)에서 토큰을 변경하세요(파일에서 변경하지 않음). 그동안 공식 커넥터를 사용하거나 내보내기를 요청하세요.

단계 7 — 덱 구축

references/esqueleto-slides.md를 읽으세요. Slides 유형에서 덱을 만드세요 (제목: "브랜드 매뉴얼 – <브랜드>")하고 해당 파일 지침을 따르세요:

  1. 덱에 들어갈 모든 것(버전, 평면도, 최소 크기 테스트, 잘못된 사용 예, 일러스트레이션)을 투명 PNG로 렌더링하고 작업 디렉토리의 폴더에서 리소스로 업로드하세요(호출당 최대 25개).
  2. 먼저 deck.json을 만들고, 전체 order(핵심 + 모듈 + 구분선)와 faces에 브랜드 글꼴(Google Fonts)을 포함시킨 후 표지, 그다음 6–8페이지씩 배치하세요.
  3. 전략 텍스트: PPT에서 가져오고, 매뉴얼 스타일로 유지하며, 어떠한 주장도 추가하지 마세요. 누락된 내용은 대괄호("[이메일]")로 표시하고 페이지와 발표자 노트에 넣으세요.
  4. 업종 적용 예: 슬라이드에서 도형, 로고 PNG, 브랜드 음성의 예제 텍스트로 구성하세요. 사진 목업이 아닙니다.
  5. 머리글과 목차에서 브랜드 이름이 올바른지 확인하세요.

단계 8 — 파일 패키지

승인된 SVG만 <version>_<variant>.svg 이름으로 폴더에 복사하고(미리보기나 개별 요소는 제외) 다음을 실행하세요:

python scripts/package.py trabajo/entrega/ trabajo/paquete/ --marca "<브랜드>"

변형별로 SVG, 투명 PNG 500/1000/2000 px, RGB 벡터 PDF를 생성합니다. CMYK/팬톤 버전, 자수용 단순화 버전, 조정된 16px 파비콘은 "최종 아트 보류"로 남깁니다. .zip을 SendUserFile로 보내세요.

단계 9 — 전달

간결한 메시지: 덱(카드에 이미 링크가 있음), .zip 및 미결 사항 목록을 담당자별로 그룹화하여(디자이너 / 고객 / 인쇄소). 예: 글꼴 라이선스 등록, 팬톤 검증, 브랜드 담당자 이메일, 자수용 최종 아트, 일러스트레이션 라이선스. 선택 사항으로 brand-board 실행 또는 템플릿 제작을 제안하세요.

좋은 예

매뉴얼에서 결정은 이렇게 문서화됩니다: 구체적, 측정 가능, 상태 포함.

색상 · 블루
HEX #2B57E2 · RGB 43/87/226 · CMYK 85/65/0/0 (FOGRA39, 약간 탁하게 나옴)
Pantone 2728 C · ΔE 3.1 (유사). 참고: 실제 가이드 및 색상 테스트로 검증 필요.

최소 크기 · 가로 버전
너비 24mm / 90px: 이름이 읽히고 심볼은 점으로 보입니다.
더 작은 형식(서명, 사원증): 심볼을 별도로 크게 사용.

나쁜 예

공식 팬톤: 2728 C
로고를 너무 작게 사용하지 마십시오.

잘못된 이유: 계산된 팬톤을 공식으로 제시하고 ΔE가 없으며, 최소 크기에 측정값이 없어 공급업체가 준수 여부를 확인할 수 없습니다.

이 스킬이 절대 하지 않는 일

  • 로고를 다시 그리거나 "개선"하지 않습니다. 기존 요소만 재색상화, 컷아웃, 재배치, 크기 조정, 분리하며 새 텍스트는 윤곽선으로 변환합니다.
  • 사전 승인 없이 버전을 생성하지 않습니다.
  • 전략, 라이선스 또는 고객 데이터를 임의로 만들지 않으며, 계산된 팬톤을 공식으로 제시하지 않습니다.
  • 검증 없이 다른 출처의 색상 값을 혼합하지 않습니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬