Communitygithub.com

브랜드 스킬 빌더

회사의 브랜드 북으로부터 보이스 스킬, 형식별 스킬(PDF, Word, PowerPoint, 소셜 이미지, HTML, 모션), 그리고 에셋 검사 감사 스킬을 포함한 브랜드 스킬 라이브러리를 구축합니다. 브랜드 북을 구조화된 기반(팔레트, 타이포그래피, 구조 시스템, 접근성, 보이스)으로 변환하고, 각 스킬을 다이제스트 검증 컨텍스트 스냅샷, 사전 점검, 플랫폼 테스트 및 패키저로 구성하여, 인테이크부터 QA, 릴리스까지 빌드 과정을 안내합니다. 결과물은 하나의 zip 파일로 Claude와 ChatGPT에서 실행됩니다.

브랜드 스킬 빌더란 무엇인가요?

Brand Skill Builder는 기업의 브랜드 북을 기반으로 완전한 브랜드 스킬 라이브러리를 구축하는 AI 에이전트용 스킬입니다. 이 스킬은 색상 팔레트, 타이포그래피, 구조 시스템, 접근성, 보이스 태그와 같은 구조화된 기반을 생성하고, 각 형식(보이스, PDF, Word, PowerPoint, 소셜 이미지, HTML, 모션)에 대한 개별 스킬을 자동으로 스캐폴딩합니다. 각 스킬에는 다이제스트 검증 컨텍스트 스냅샷, 사전 점검, 플랫폼 테스트, 패키저가 포함되어 Claude와 ChatGPT 모두에서 일관되게 작동합니다. 이 스킬은 인테이크, QA, 릴리스의 전체 빌드 과정을 안내하며, 브랜드 값을 발명하지 않고 사용자가 제공한 소스에서만 가져옵니다. 새로운 라이브러리 생성, 기존 라이브러리에 스킬 추가, 기존 라이브러리 검토 세 가지 모드를 지원합니다.

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

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

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

문서

Brand Skill Builder

이 스킬은 브랜드 스킬 라이브러리를 구축하고 유지 관리하는 데 도움을 줍니다. 라이브러리는 모든 모델이 하나의 회사를 위해 브랜드에 맞는 작업을 생성할 수 있게 하는 작은 스킬 집합입니다. 이 스킬은 프로덕션 라이브러리의 아키텍처, 템플릿, 스크립트 및 교훈을 담고 있지만, 자체 브랜드는 가지고 있지 않습니다. 모든 브랜드 값은 사용자의 소스에서 비롯됩니다.

어떤 모드든 시작하기 전에 references/architecture.md를 읽으십시오. 아래 단계에서 참조 파일이 명시된 경우 다른 참조 파일도 읽으십시오.

폴더. 모든 명령어에서 SKILL_DIR은 이 파일이 있는 폴더이고, LIB는 사용자가 선택한 라이브러리 폴더입니다. 모든 명령어에서 둘 다 전체 경로로 작성하십시오. 셸 변수로 설정하지 마십시오 (일부 플랫폼에서는 한 명령어에서 설정한 변수가 다음 명령어에서 사라집니다).

모드 선택

사용자가 원하는 것모드
아직 브랜드 스킬이 없는 브랜드를 위한 브랜드 스킬A. 새 라이브러리
기존 라이브러리에 스킬 하나 더 추가B. 스킬 추가
기존 브랜드 스킬 또는 라이브러리 검토C. 검토
구축 전 접근 방식 이해references/architecture.md에서 설명하고 중단

요청에서 지정하지 않은 경우에만 어떤 모드인지 물어보십시오.

A. 새 라이브러리

  1. 소스 수집. 브랜드 북과 브랜드를 규율하는 모든 자료(디자인 팀의 템플릿, 보이스 가이드, 메시징 문서, 상표 규칙, 스타일 가이드, 로고 파일, 글꼴 및 라이선스, 아이콘 또는 사진 라이브러리)를 요청하십시오. 브랜드를 소유한 사람(결정을 승인할 사람)이 누군지 물어보십시오. 누락된 사항을 기록하고, 채우지 마십시오.
  2. 스캐폴딩. python3 SKILL_DIR/scripts/scaffold.py library LIB --brand "<Brand>" --era <era>. era는 이 버전의 브랜드를 나타내는 짧은 레이블입니다 (예: 2027-brand). 소스는 LIB/reference/에 넣으십시오.
  3. 기반 작성 LIB/shared-context/brand-foundations/context/에 소스를 기반으로 기반을 작성합니다. references/brand-foundations.md를 따르십시오. 모든 TODO를 소스에서 채우거나 격차로 기록하십시오. 대비를 측정하고, 규칙이 있는 경우 책의 표현을 인용하며, 모든 파일에 출처를 제공하십시오. logo/ 아래에 로고 아트워크를 추가하고, 소스에서 다루는 경우 logo-policy.md, imagery-policy.md 및 chart-palette.json을 추가하십시오.
  4. 소유자와 검토. 기반을 짧은 요약(색상 모델, 타입 역할, 시그니처 요소, 선적 확인, 격차, 각 제안된 하우스 결정 및 권장 사항과 그 이유)으로 제시하십시오. 결정을 기다리고, 각 결정을 하우스 결정 테이블과 개발 로그에 기록하십시오.
  5. 보이스 스킬 구축 (모드 B, --kind voice). 작고 스냅샷, 사전 점검 및 패키징 경로를 증명합니다.
  6. 첫 번째 포맷 스킬 구축 (모드 B, --kind format), 사람들이 가장 필요로 하는 형식. 가장 작은 엔드투엔드 경로 먼저, 그 다음 파일럿 루프.
  7. 하나씩 형식 추가, 각 형식의 하우스 결정을 먼저 결정(references/process.md, "작업 순서")합니다.
  8. 감사 스킬 구축 (모드 B, --kind audit) 감사할 형식 사양이 있을 때.

B. 스킬 추가

  1. 이름 지정 <brand>-<format> (소문자, 하이픈 사용) 또는 <brand>-voice, <brand>-audit. 하나의 스킬, 하나의 작업을 확인하십시오. 요청이 기존 스킬과 중복되면 말하고 대신 해당 스킬을 확장할 것을 권장하십시오.
  2. 스캐폴딩. python3 SKILL_DIR/scripts/scaffold.py skill LIB <name> --kind format|voice|audit --format "<PDF>". 이 명령은 SKILL.md 템플릿, agents/openai.yaml, 사전 점검, 플랫폼 테스트 및 스냅샷 설정 LIB/tools/snapshot/<name>.json을 작성합니다. 포맷 스킬의 경우 LIB/shared-context/<name>/context/format-spec.md 및 format-map.json도 작성합니다.
  3. 형식의 하우스 결정 결정 코드를 작성하기 전에: structural-system.md에서 "다른 사람이 구축할 때 결정" 범위의 모든 결정에 대해 이 형식에 대한 답변을 권장하고, 소유자의 결정을 받아 기록하십시오.
  4. 형식 사양 및 맵 작성 (BOOK, RATIFIED 및 PROPOSED 태그가 있는 단어; 숫자는 역할 이름 사용, 16진수 사용 금지).
  5. 빌더 및 QA 스크립트 작성 references/format-skills.md에 따라: 모델이 JSON 사양을 계획하고 작성하며, 스크립트가 빌드하고, 스크립트가 완성된 파일을 게이트합니다. 토큰은 빌드 시간에 읽히고, 편차는 기록되며 거부하지 않습니다. 보이스 및 감사 스킬은 대신 references/voice-and-audit.md를 따릅니다.
  6. SKILL.md 채우기: 설명(트리거, 하지 않을 일, 1024자 미만), 단계, 인테이크와 룩투스펙 테이블, 사양 참조, 경고-거부 금지 섹션, 플랫폼별 전달 라인.
  7. 스냅샷 및 검증. python3 LIB/tools/snapshot/snapshot.py LIB/tools/snapshot/<name>.json, 그런 다음 --check, 그런 다음 python3 LIB/skills/<name>/scripts/verify_context.py. 글꼴, 스타일시트 및 아트워크를 설정의 bundled_assets에 추가하여 사전 점검이 이를 증명할 수 있도록 하십시오.
  8. 테스트 (references/qa-and-testing.md): 플랫폼 테스트, 두 테마에서의 픽스처 빌드, QA 검사별 변조 테스트, 토큰 스왑 테스트. 그런 다음 현실적인 프롬프트로 파일럿 루프를 수행하고, 각 수정 후 동일한 프롬프트를 다시 실행하십시오.
  9. 요청 시 패키징 (references/packaging.md): python3 LIB/tools/package/package_skill.py LIB/skills/<name> <name> <fresh scratch folder>/<name>.zip --date YYYY-MM-DD. 다른 새 폴더에 압축을 풀고 거기서 테스트를 실행한 후 zip을 LIB/finalized-skills/에 넣으십시오.
  10. 기록. 위의 모든 단계를 실행할 때마다 LIB/DEV-LOG.md에 기록하십시오.

C. 검토

스킬(또는 라이브러리)을 읽고 패턴과 비교하십시오. 다음 순서대로 각 항목을 파일과 줄 번호와 함께 보고하십시오:

  1. 구조: 하나의 작업, 다른 스킬에 대한 런타임 호출 없음, agents/openapi.yaml, 단일 플랫폼 경로 없음.
  2. 컨텍스트: 매니페스트와 다이제스트가 있는 번들 스냅샷, 중지 대신 경고하는 사전 점검, 브랜드 시대.
  3. 빌더: 빌드 시간에 읽는 토큰(또는 하드코딩된 값), JSON 사양, 거부 대신 편차.
  4. QA: 선적 확인에 매핑된 완성된 파일 게이트, 변조 테스트, 다시 스타일링하는 경우 다시 스타일 모드.
  5. 워크플로: 기본값이 있는 인테이크, 주장과 증거가 있는 계획, 빌드 전 승인, 경고를 앞세운 전달.
  6. 패키징: 엄격한 프론트매터, 설명 길이 및 트리거, 릴리스 기록.

영향 순서대로 수정 사항을 권장하십시오. 요청하지 않는 한 아무것도 변경하지 마십시오.

모든 모드에 대한 규칙

  • 브랜드 값을 절대 발명하지 마십시오. 색상, 글꼴, 크기, 규칙, 주장, 수치 또는 고객이 일반 지식에서 비롯되지 않습니다. 격차는 기록되고 소유자가 결정하거나 요소를 생략합니다.
  • 브랜드 북이 기록의 규칙입니다. 소유자의 디자인 파일이 침묵을 채우며, 모든 이탈은 범위, 이탈한 책의 표현, 상태 및 결정한 사람이 기록된 하우스 결정입니다.
  • 경고하고, 절대 거부하지 마십시오. 구축하는 스킬 내에서: 수리하고 보고하고, 실패한 파일에 레이블을 붙여 전달하며, 물리적 불가능의 경우에만 중단하십시오. 보이스 파일이 없는 보이스 스킬이 그 불가능입니다.
  • 권장한 후 물어보십시오. 소유자에게 속한 모든 선택에 대해. 결정 후에만 구축하십시오.
  • 측정하고, 추측하지 마십시오: 대비, 텍스트 너비, 줄 수, 렌더링.
  • 완료라고 말하기 전에 실제 렌더러에서 출력을 확인하십시오.

전달

  • Claude에서: 생성 또는 변경된 내용을 경로와 함께 요약하고, 출력 폴더에서 패키징된 zip을 공유하십시오.
  • ChatGPT에서: 생성 또는 변경된 내용을 경로와 함께 요약하고, 다운로드 가능한 패키징된 zip을 링크하십시오.

그런 다음 여전히 할 일, 소유자를 기다리는 각 격차, 각 PROPOSED 결정을 나열하십시오.

참조

파일읽을 내용
references/architecture.md스킬 유형, 워크스페이스, 스킬 폴더, 스냅샷 우선 컨텍스트, 플랫폼 중립성
references/brand-foundations.md브랜드 북을 데이터로 변환: 파일, 색상 및 타입 아키텍처, 하우스 결정, 상태 태그
references/format-skills.md포맷 스킬 내 워크플로, 경고-거부 금지, 사양, 빌더, QA 게이트, 형식별 참고 사항
references/voice-and-audit.md보이스 스킬 및 감사 스킬
references/qa-and-testing.md테스트, 렌더링, 파일럿, 상호 작용하는 규칙 디버깅
references/packaging.md엄격한 프론트매터, 설명, 릴리스 단계, 업로드 실패
references/process.md결정, 살아있는 기록, 작업 순서, 안전한 작업, Office 도구 체인 교훈

관련 스킬