카피가 브랜드 보이스에서 벗어날 때, writer와 AI assistant가 일관되게 적용할 수 있는 브랜드 보이스 문서를 만듭니다. — Claude Skill
Claude Code용 Claude 스킬 · 제공: Rampstack · 실행: /brand-voice (Claude 내)·업데이트: 2026년 6월 14일
모든 writer가 on-voice로 유지되도록 브랜드의 말투를 정의합니다.
- drift를 막기 위해 voice attribute를 '무엇이 아닌지'와 짝지어 정의합니다(confident, not arrogant)
- onboarding, error, pricing, cancellation 등 8-15개 context별 tone shift를 mapping합니다
- vocabulary preference와 grammar rule(contraction, pronoun, sentence length default)을 정합니다
- writer가 실제로 쓰는 bad-vs-good copy sample 15-25개 paired-example library를 만듭니다
- sign-off 전에 실제 brief를 문서에 다시 적용하는 stress-test step을 실행합니다
대상
기능
마케팅 리드에게 문서화된 voice가 전혀 없습니다. 한 번의 작업 세션에서 4-layer voice doc을 만들고 다음 날 아침 freelance writer 3명에게 배포합니다.
웹, 이메일, 제품 UX 전반의 실제 문구 샘플 40개를 목록화하고 브랜드 보이스에서 벗어난 패턴 12개를 식별하며, 일주일 안에 대응 예시 25개를 다시 씁니다.
Voice doc을 system prompt에 바로 연결합니다. 다음 draft 20개에서 editor rewrite cycle을 3회에서 1회로 줄입니다.
새 freelancer가 voice attribute, tone-shift table, paired example을 읽고, 4차 round 대신 같은 날 첫 on-voice draft를 발송합니다.
작동 방식
웹, 제품, 이메일 전반의 기존 문구를 점검해 브랜드 보이스에 맞는 항목과 벗어난 항목을 매핑합니다
we-are-X-not-Y framing으로 5-8개 voice attribute 후보를 만들고 3-5개 keeper로 좁힙니다
hero, error, pricing, cancellation, 404 등 8-15개 writing context를 mapping하고 각 tone shift를 문서화합니다
vocabulary preference, grammar default, bad-vs-good rewrite 15-25개 paired-example library를 확정합니다
새 writing brief에 문서를 stress-test합니다. output이 off-voice이면 배포 전 문서를 한 번 더 다듬습니다
예시
셀프서비스 SaaS를 출시하는 개발자 도구 스타트업 Rampstack의 브랜드 보이스를 정의합니다. 대상: 20-200명 팀의 백엔드 엔지니어. 기존 랜딩 페이지 8개와 일관성이 부족한 제품 문구 문자열 30개가 있습니다. 참고 브랜드: Linear, Stripe, Vercel.
자신감 있지만 거만하지 않음. 직접적이지만 무뚝뚝하지 않음. 실용적이지만 건조하지 않음. 호기심 있지만 산만하지 않음.
Hero: signature voice를 완전히 적용. Error message: 차분하고 사실 중심, 과한 사과 없음. Cancellation flow: 조용하고 존중하며 농담 없음.
축약형을 사용합니다. 제목은 문장형 대소문자를 씁니다. 능동태를 기본으로 둡니다. 금지어 목록은 문서에 있으며 작성자는 게시 전에 참조합니다.
Off: 매끄러운 배포의 미래에 오신 것을 환영합니다. On: 모든 push마다 배포하세요. staging dance는 없습니다.
새 공지 브리프에 문서를 적용했습니다. 첫 초안이 편집자 검토를 한 번에 통과했습니다.
개선되는 지표
지원 도구
기존 copy sample을 cataloguing하고 audit step에서 on-voice/off-voice 여부를 tracking합니다.
voice doc을 배포하고 writer/reviewer와 voice-question poll을 실행합니다.
UI string이 문서를 상속하도록 design system copy component 안에 voice attribute를 mirror합니다.
writer, designer, AI prompt가 inline으로 참조할 수 있도록 voice document를 호스팅합니다.
브랜드 보이스을(를) 사용해 보시겠어요?
시작 방법을 선택하세요.
이 스킬을 컴퓨터에 로컬로 설치하고 실행합니다.
컴퓨터에서 터미널을 열고 이 명령을 붙여넣으세요:
이 명령은 스킬과 모든 파일을 컴퓨터에 다운로드합니다:
모든 프로젝트에서 사용하려면 끝에 -g를 추가하세요.
Claude Code를 시작한 다음 명령을 입력하세요:
브랜드 보이스
브랜드가 글에서 어떻게 들리는지 정의합니다. writer, designer, founder, AI assistant 누구나 일관되게 적용할 수 있는 방식으로 문서화합니다.
이 스킬은 brand style guide 안에 들어가거나 그 입력으로 쓰일 수 있는 standalone voice document를 만듭니다.
언제 사용할지
- 처음으로 브랜드 보이스를 정의할 때
- 기존 copy의 voice consistency를 audit할 때
- 팀, freelancer, AI assistant를 브랜드 보이스에 맞게 training할 때
- 이미 voice는 있지만 application 전반에서 일관성이 없을 때
- brand가 진화해 voice를 조정해야 할 때(new audience, new positioning)
사용하지 말아야 할 때
- 특정 copy 작성(
content-and-copy사용) - brand visual identity 작업(
brand-identity사용) - 완전한 brand system 문서화(voice를 포함하는
brand-style-guide사용) - 초기 brand exploration(
brand-ideation사용)
필수 입력
- 브랜드와 positioning
- audience와 그들이 들어야 하는 것
- 기존 brand writing example 5-10개(있다면)
- 이 brand가 가야 할 방향과 공명하는 reference brand 3-5개
- brief에 이미 지정된 voice attribute
프레임워크: 4개 layer
Voice에는 네 개 layer가 쌓여 있습니다. 각 layer는 아래 layer를 제한합니다.
Layer 1: Voice attributes
상수입니다. 모든 context에서 brand가 어떻게 들리는지 정의하는 personality trait입니다.
attribute 3-5개를 고릅니다. 각각을 그것이 아닌 것(과도해질 때의 failure mode)과 짝지으세요.
흔한 attribute pairing(메뉴가 아닙니다. 직접 생성하세요):
- Confident, not arrogant
- Direct, not blunt
- Warm, not saccharine
- Witty, not sarcastic
- Smart, not academic
- Honest, not harsh
- Playful, not silly
- Practical, not boring
- Bold, not loud
- Curious, not unfocused
"not" half가 writer가 overshoot하지 않도록 막습니다. "Confident"만 있으면 swagger가 됩니다. "Confident, not arrogant"는 writer에게 선이 어디인지 알려줍니다.
Layer 2: Tone shifts
Voice는 일정합니다. Tone은 context에 맞게 적응합니다.
brand가 글을 쓰는 주요 context를 mapping합니다. 각 context마다 voice가 어떻게 다르게 표현되는지 문서화합니다.
흔한 context:
| Context | Tone shift |
|---|---|
| Onboarding | 더 따뜻하고, 더 enthusiastic하며, 약간 느린 pace |
| Hero / marketing | confident, signature voice fully on |
| Product copy / UX | direct, helpful, brief |
| Error messages | calm, matter-of-fact, no apology theater |
| Success states | brief celebration, next action으로 redirect |
| Empty states | helpful, slightly playful, action 제안 |
| 404 / not found | self-aware, light, home으로 안내 |
| Account deletion / cancellation | quiet, respectful, joke 없음 |
| Pricing | direct, transparent, confidence-inspiring |
| Legal / TOS | legal version 옆에 plain language version |
| Support / help center | patient, thorough, condescension 없음 |
| Crisis communication | calm, factual, accountable |
| Product announcements | excited but not breathless |
| Email subject lines | specific, click-bait 금지 |
Voice는 모든 context에서 일관됩니다. 바뀌는 것은 tone입니다.
Layer 3: Vocabulary and grammar
세밀한 dial setting입니다.
Vocabulary preferences:
- brand가 사용하는 word와 phrase
- brand가 피하는 word와 phrase
- brand가 재정의한 word(있다면). 예: SaaS product가 feature를 "meetings" 대신 "huddles"라고 부름
- Industry jargon: 유지할지(expertise signal), 제거할지(approachability signal)
- Sentence-opening preference(어떤 brand는 imperative, 어떤 brand는 question, 어떤 brand는 statement를 선호)
Grammar and style:
- Contractions(사용 = casual, 피함 = formal)
- Sentence length default(short = punchy, medium = considered, long = literary)
- 선호하거나 피하는 punctuation mark(em dash는 유명하게 polarizing합니다)
- Pronouns("we" / "you" / "I")
- Capitalization style(title case, sentence case, 의도적 all-lowercase)
- Number formatting(10 미만은 spell out 또는 항상 digit)
- Oxford comma(사용 또는 생략)
- Active vs passive voice(대부분의 brand는 active 선호)
Layer 4: Examples and patterns
Voice는 rule이 아니라 example로 가르칩니다. Library를 만드세요.
각 주요 content type마다 보여줍니다:
- Bad example(off-voice)
- Good example(on-voice)
- 무엇이 바뀌었는지에 대한 짧은 note
다룰 흔한 content type:
- Headline
- Subheadline
- Hero CTA
- Feature description
- Testimonial intro
- Email subject line
- Email opening
- Push notification
- Error message
- Success message
- About page paragraph
- Social post
- Sales page paragraph
paired example 15-25개를 목표로 하세요. 실제로 voice doc에서 가장 많이 쓰이는 부분입니다.
워크플로
- 기존 copy audit가 있다면 수행합니다. 무엇이 on-brand인지, 무엇이 off인지, 어떤 pattern이 반복되는지 식별합니다.
- Layer 1: Voice attributes. "we are X, not Y" framing으로 후보 5-8개를 생성합니다. 3-5개를 고릅니다.
- Layer 2: Tone shifts. brand가 글을 쓰는 context 8-15개를 나열합니다. 각 tone shift를 기록합니다.
- Layer 3: Vocabulary and grammar. preference를 정의합니다. brand를 실제로 구분하지 않는 default rule은 생략합니다.
- Layer 4: Examples. paired-example library를 만듭니다. 최소 15-25개.
- Stress-test. 새 writing brief를 하나 고르고 voice doc을 적용합니다. on-voice copy가 나오나요? 그렇지 않다면 doc이 불완전합니다.
- Document.
references/voice-document-template.md의 template을 사용합니다. - Distribute. Voice doc은 사용될 때만 작동합니다. inline으로 reference하기 쉽게 만드세요(CMS template, brief template, AI assistant prompt에서 link).
실패 패턴
- Generic attributes("friendly, professional, approachable"). 모든 brand가 이렇게 말합니다. 아무 의미가 없습니다. 진짜로 구분되는 attribute를 고르세요.
- "we are NOT" pairing 없음. 거절선이 없으면 attribute는 extreme으로 drift합니다.
- example 없는 voice doc. example 없는 rule은 적용할 수 없습니다.
- 나쁜 example과 좋은 example이 너무 뻔함. 실제 voice work는 cartoonish before/after가 아니라 nuanced shift를 보여줍니다.
- tone shift 생략. voice를 one-size-fits-all로 다루면 error state나 legal context에서 brand가 어색하게 들립니다.
- aspirational voice 문서화. brand가 오늘 실제로 그렇게 들리지 않고 전환 plan도 없다면 doc은 fiction입니다.
- distribution 없는 voice. 아무도 참조하지 않는 완벽한 doc은 가치가 없습니다.
출력 형식
기본 출력은 brand folder의 voice.md markdown document입니다. 섹션:
- Voice attributes(with we-are-not pairings)
- Tone shifts by context
- Vocabulary preferences
- Grammar and style rules
- Paired examples library(가장 많이 쓰이는 section)
- Anti-patterns(피해야 할 특정 phrase 또는 construction)
- References(영감을 받은 brand와 writer)
이 doc은 standalone으로 쓰이거나 brand-style-guide에 들어갈 수 있습니다.
참고 파일
references/voice-document-template.md- 채워 넣을 수 있는 template.references/voice-frameworks.md- Nielsen Norman 4 dimensions, Jung archetypes, "we are X not Y" approach에 대한 detailed walkthrough.