클로드 플러그인 Brand Voice 리뷰: 우리 가게 말투 가이드 만들기, 플러그인 없이 만든 결과와 비교

가게나 회사 글을 AI에게 맡기면 매번 말투를 다시 설명해야 합니다. Brand Voice(브랜드 보이스)는 Anthropic의 업무용 플러그인 저장소(knowledge-work-plugins)에 Tribe AI가 만들어 올린 클로드 플러그인입니다. 가지고 있는 글과 자료를 읽어 “우리 말투 가이드”를 만들고, 그 가이드에 맞춰 새 글을 씁니다. 플러그인은 무료이고, 쓸 때마다 클로드 사용량이 듭니다. 가상 카페의 자료 다섯 개로 같은 일을 플러그인 없이 두 번, 플러그인만 넣고 두 번, 플러그인 명령으로 두 번 시켜 비교했습니다.

플러그인은 스킬·명령·에이전트를 한데 묶어 한 번에 설치하는 꾸러미입니다. 스킬이 처음이라면 클로드 스킬 뜻과 만드는 법을 먼저 보세요.

결과부터 보기: 같은 자료, 두 가지 말투 가이드

직접 눌러 보기: 여섯 번 만든 가이드와 공지 글 열어 보기 (클로드가 만든 파일을 손대지 않고 올림, 가게와 자료는 실험용 가상 예시)

따라 해 보기: 요청문과 실습 재료

가상 카페 “온기 로스터리”의 자료 다섯 개를 brand 폴더에 넣었습니다. 가게 소개, 지난 인스타그램 글 다섯 편, 메뉴판, 리뷰 답글, 대표가 직원에게 남긴 말투 메모입니다. 지난 글 가운데 하나는 2023년에 아르바이트생이 쓴 글로, “역대급 대박”, 불꽃 이모지, “놓치면 후회”가 들어 있습니다. 대표 메모가 금지한 말들입니다. 실습 재료(zip)에 자료 다섯 개, 요청문, 채점 기준, 여섯 번의 결과를 넣었습니다. 클로드 코드가 처음이라면 클로드 코드 설치 방법을 먼저 보세요.

플러그인 없이, 그리고 플러그인만 넣었을 때는 아래 요청을 그대로 보냈습니다.

brand 폴더에 우리 카페(온기 로스터리) 자료를 모아 뒀어. 이 자료로 우리 가게 브랜드 말투 가이드를 만들어서 파일로 저장해 줘. 그리고 그 가이드에 맞춰 가을 신메뉴 인스타그램 공지 글을 instagram-post.md로 써 줘.
신메뉴: 밤 크림 라떼, 오늘의 드립 새 원두(에티오피아 구지 샤키소 무루 농장 내추럴).
신메뉴 출시 기념으로 10월 24일부터 30일까지 두 메뉴 10% 할인.

플러그인 명령으로는 같은 내용을 두 번에 나눠 보냈습니다. 두 번째 명령은 같은 대화에서 이어 보냈습니다.

/brand-voice:generate-guidelines brand 폴더에 모아 둔 우리 카페(온기 로스터리) 자료

/brand-voice:enforce-voice 가을 신메뉴 인스타그램 공지 글을 instagram-post.md로 써 줘. 신메뉴: 밤 크림 라떼, 오늘의 드립 새 원두(에티오피아 구지 샤키소 무루 농장 내추럴). 신메뉴 출시 기념으로 10월 24일부터 30일까지 두 메뉴 10% 할인.

좋은 결과라면 가이드 파일 하나와 instagram-post.md가 생기고, 공지 글에 “대박”, “마감 임박”, “여러분”이 없고 마지막 줄이 가게의 맺음말 “오늘도 따뜻하게 내릴게요.”입니다.

Brand Voice 플러그인에 들어 있는 것

claude plugin details로 뽑은 구성입니다. 디렉터리 정보로는 클로드 코드, 코워크(Cowork), 클로드 앱에서 쓸 수 있습니다.

구성	이름	하는 일
명령 1	/brand-voice:discover-brand	연결된 노션·구글 드라이브·컨플루언스·공(Gong) 같은 도구를 뒤져 브랜드 자료를 찾고 순위를 매긴 보고서를 만듭니다
명령 2	/brand-voice:generate-guidelines	문서·대화 기록·위 보고서로 말투 가이드를 만들어 .claude/brand-voice-guidelines.md에 저장합니다
명령 3	/brand-voice:enforce-voice	저장된 가이드를 불러 새 글을 쓰고, 어떤 규칙을 적용했는지 설명합니다
스킬 3	discover-brand, guideline-generation, brand-voice-enforcement	위 명령이 따르는 작업 설명서. 가이드 틀, 확신도 매기는 법, 고치기 전후 예시가 딸려 있습니다
에이전트 5	document-analysis, conversation-analysis, content-generation, discover-brand, quality-assurance	문서 분석, 통화 기록 분석, 글쓰기, 자료 찾기, 품질 점검을 나눠 맡는 보조 일꾼. 품질 점검만 Haiku, 나머지는 Sonnet으로 정해져 있습니다
MCP 서버 6	notion, atlassian, box, figma, gong, granola	회사 도구에 접속하는 연결. 쓰려면 각 서비스에 로그인해야 합니다

플러그인을 켜 두면 스킬·명령·에이전트 설명이 대화마다 약 2,600토큰 붙습니다. 실제로 불리면 스킬 하나에 1,600~2,200토큰이 더 듭니다(claude plugin details 추정치).

이번에는 연결 도구 없이 폴더의 파일만 썼습니다. 그래서 MCP 서버 여섯 개를 끄고 돌렸고, /brand-voice:discover-brand는 시험하지 않았습니다. 이 명령의 설명은 공식 README 기준입니다.

1단계. 설치하기 (약 1분)

이 단계에서는 저장소를 등록하고 플러그인을 설치합니다. 공식 README의 방법이고, 터미널에서 실행합니다.

claude plugin marketplace add anthropics/knowledge-work-plugins
claude plugin install brand-voice@knowledge-work-plugins

실제 실행 기록 · macOS 26.1 · 분리한 설정 폴더

$ claude plugin marketplace add anthropics/knowledge-work-plugins
Adding marketplace…SSH not configured, cloning via HTTPS: https://github.com/anthropics/knowledge-work-plugins.git
Refreshing marketplace cache (timeout: 120s)…
Cloning repository (timeout: 120s): https://github.com/anthropics/knowledge-work-plugins.git
Clone complete, validating marketplace…
Cleaning up old marketplace cache…
✔ Successfully added marketplace: knowledge-work-plugins (declared in user settings)

$ claude plugin install brand-voice@knowledge-work-plugins
Installing plugin "brand-voice@knowledge-work-plugins"...✔ Successfully installed plugin: brand-voice@knowledge-work-plugins (scope: user)

$ claude plugin list
Installed plugins:

  ❯ brand-voice@knowledge-work-plugins
    Version: 1.1.0
    Scope: user
    Status: ✔ enabled

이렇게 나오면 성공 claude plugin list에 brand-voice@knowledge-work-plugins, Status: ✔ enabled(켜짐)가 보입니다.

• 클로드 코드 안에서 하려면: 대화창에 /plugin marketplace add anthropics/knowledge-work-plugins를 친 뒤 /plugin install brand-voice@knowledge-work-plugins를 칩니다.
• Plugin "brand-voice" not found in marketplace(저장소에서 플러그인을 못 찾음)가 나오면: 첫 줄의 저장소 등록을 건너뛰었을 때 나온 오류입니다. 첫 줄부터 다시 실행하고, 그래도 나오면 claude plugin marketplace update knowledge-work-plugins로 목록을 새로 받습니다.
• 클로드 앱이나 코워크에서는: 플러그인 디렉터리에서 Brand Voice를 찾아 설치합니다. 찾는 법은 클로드 스킬·플러그인 디렉터리 사용법에 있습니다.

필요 없어지면 터미널에서 아래 명령으로 지웁니다.

claude plugin uninstall brand-voice@knowledge-work-plugins

2단계. 말투 가이드 만들기 (약 5분)

이 단계에서는 자료 폴더를 읽혀 가이드를 만듭니다. 자료가 있는 폴더에서 클로드 코드를 열고 위의 첫 번째 명령을 보냅니다. 두 번 모두 클로드는 guideline-generation 스킬을 먼저 불렀고, 파일 다섯 개를 읽어 가이드를 쓴 뒤 품질 점검 에이전트에게 검토를 맡겼습니다. 5분 남짓 걸렸습니다.

가이드 앞쪽 요약(Executive Summary) 바로 아래에 이 표가 옵니다. 담백하다↔과장한다, 느긋하다↔조급하게 만든다처럼 여섯 쌍입니다. 그 아래에 상황별 말투 표가 이어집니다. 인스타그램 일상 글, 신메뉴 소개, 할인 공지, 불만 리뷰 답글, 가게 소개마다 격식과 에너지를 어떻게 바꾸는지 적혀 있습니다. 가게 소개만 합니다체이고 나머지는 해요체라는 점도 짚었습니다.

항목마다 확신도가 붙습니다. 대표 메모와 지난 글이 같은 말을 하는 규칙은 높음(High)입니다. 리뷰 답글 세 개에서만 보인 습관은 중간(Medium)입니다. 할인 공지처럼 예시가 없는 상황은 1회차가 낮음(Low)으로, 2회차가 “추론”으로 표시했습니다.

가장 쓸모 있던 부분은 끝의 질문 목록입니다. 두 번 모두 1순위 질문이 같았습니다. 대표 메모는 “원두는 농장 이름까지”라고 했는데, 메뉴판의 블렌드에는 농장 이름이 없다는 것입니다. 2회차는 7월 콜드브루 글에도 농장 이름이 없다고 짚었습니다. 질문마다 “에이전트 추천”과 “사장님께 필요한 것”이 붙어 있어 정하기만 하면 됩니다. 자료를 만들 때 일부러 넣은 차이가 아니었는데 찾아냈습니다.

이렇게 나오면 성공 클로드가 “브랜드 보이스 가이드라인을 만들었습니다”라며 저장 위치, 전체 확신도, 확인할 질문 수를 알려 줍니다.

• “.claude/에 저장하지 못했다”는 말이 나오면: .claude 폴더는 클로드 코드가 따로 보호하는 곳입니다. 이번 실행처럼 그 폴더 쓰기를 허락하지 않으면 1회차는 임시 폴더에, 2회차는 작업 폴더 맨 위에 저장했습니다. 저장 허락을 묻는 창이 뜨면 허용하거나, 나중에 파일을 .claude/brand-voice-guidelines.md로 옮깁니다. 이 위치에 있어야 다음 대화에서 3단계 명령이 자동으로 찾습니다.
• 가이드 소제목이 영어로 나와도 정상입니다. 플러그인의 가이드 틀이 영어라 “Executive Summary”(요약), “Tone-by-Context Matrix”(상황별 말투 표) 같은 소제목은 영어로, 본문은 한국어로 나왔습니다.

3단계. 가이드에 맞춰 공지 쓰기 (1분 안쪽)

이 단계에서는 같은 대화에서 두 번째 명령을 보냅니다. 클로드는 방금 만든 가이드를 써서 공지 글을 저장하고, 어떤 규칙을 적용했는지 설명했습니다. 1분이 채 안 걸렸습니다.

가을 메뉴 두 가지가 새로 나왔어요.
하나는 밤 크림 라떼예요.
또 하나는 오늘의 드립 새 원두,
에티오피아 구지 샤키소 무루 농장의 내추럴이에요.
새 메뉴가 나온 걸 기념해 10월 24일부터 30일까지 두 메뉴 모두 10% 할인해 드려요.
쌀쌀해지는 날, 천천히 들러 주세요. ☕
오늘도 따뜻하게 내릴게요.
#온기로스터리 #망원동카페 #가을메뉴

명령 2회차가 쓴 공지 글입니다. 함께 붙은 설명에는 “마감 임박, 서두르세요 같은 말 없이 기간과 할인율만 알렸다”, “나라·지역·농장·가공 방식까지 적었다”, “이모지는 커피 하나, 해시태그는 세 개만”이 적혀 있었습니다. 맛 묘사는 일부러 뺐다고도 했습니다. 가게 원칙이 “마셔 보고 느낀 그대로”인데 실제 맛을 모르니, 맛을 알려 주면 한 줄씩 넣겠다는 것입니다.

이렇게 나오면 성공 instagram-post.md가 생기고, 대표 메모의 규칙(호칭, 금지 말, 이모지·해시태그 수, 맺음말)이 모두 지켜져 있습니다.

플러그인 없이 vs 명령으로, 비교 결과

채점 기준 10개는 실행 전에 고정했고 요청문에는 넣지 않았습니다. 앞의 다섯 개는 플러그인 README와 스킬 파일이 약속하는 가이드의 모양입니다. 뒤의 다섯 개는 대표 메모에 숨겨 둔 공지 글 규칙입니다.

채점 항목	없이 1·2	플러그인만 1·2	명령 1·2
“우리는 이렇다/아니다” 대조표	✗ ✗	✗ ✓	✓ ✓
상황별 말투 표	✗ ✗	✓ ✗	✓ ✓
항목별 확신도	✗ ✗	✗ ✗	✓ ✓
함께 정할 질문 목록	✗ ✗	✗ ✗	✓ ✓
2023년 글을 따라 하지 말 예로 짚음	✓ ✓	✓ ✓	✓ ✓
공지: 금지 말 없음	✓ ✓	✓ ✓	✓ ✓
공지: 이모지 하나, 해시태그 세 개 이하	✓ ✓	✓ ✓	✓ ✓
공지: 원두를 나라·지역·농장까지	✓ ✓	✓ ✓	✓ ✓
공지: 맺음말	✓ ✓	✓ ✓	✓ ✓
공지: 할인 기간·비율 정확	✓ ✓	✓ ✓	✓ ✓
합계	6 · 6	7 · 7	10 · 10

실행 기록 · 작업 폴더 runs.tsv에서 옮김

조건(회차)              걸린 시간   달러   턴  도구 호출  불린 스킬·에이전트                     채점
none-1 플러그인 없이     1분 안쪽    0.390   5    4      없음                                   6/10
none-2 플러그인 없이     1분 안쪽    0.256  11   10      없음                                   6/10
plugin-1 플러그인만      1분 남짓    0.478   5    4      없음                                   7/10
plugin-2 플러그인만      1분 안쪽    0.270   5    4      없음                                   7/10
cmd-1 명령 두 번         6분쯤       1.501  17   24      guideline-generation, quality-assurance  10/10
cmd-2 명령 두 번         6분쯤       1.321  15   19      guideline-generation, quality-assurance  10/10

플러그인 없이: 짧고 바로 쓸 수 있는 가이드

플러그인 없이도 클로드는 자료 다섯 개를 모두 읽었습니다. 85~91줄 가이드에 “쓰지 않는 말” 표, 인스타그램 글 틀, 올리기 전 체크리스트가 들어 있었고, 2023년 글은 나쁜 예로 썼습니다.

공지 글은 플러그인 명령으로 쓴 것과 거의 구별되지 않습니다. 아래는 플러그인 없이 1회차가 쓴 글입니다. 대표 메모처럼 규칙이 분명한 자료가 있으면 글 한 편을 쓰는 데는 플러그인이 꼭 필요하지 않았습니다.

가을 메뉴가 새로 나왔어요.
밤 크림 라떼, 그리고 오늘의 드립 새 원두예요.
원두는 에티오피아 구지 샤키소 무루 농장의 내추럴이에요.
10월 24일부터 30일까지 두 메뉴를 10% 할인해 드려요.
쌀쌀해진 날, 천천히 들러 주세요. ☕
오늘도 따뜻하게 내릴게요.
#온기로스터리 #망원동카페 #핸드드립

빠진 것은 가이드의 “쓰임새”입니다. 확신도가 없어 어느 규칙이 확실하고 어느 것이 짐작인지 알 수 없습니다. 자료끼리 어긋나는 곳(블렌드 원두의 농장 이름)도 짚지 않았습니다.

플러그인만 넣었을 때: 스킬이 불리지 않음

플러그인을 넣어 두고 위와 같은 요청을 보낸 두 번은 스킬도 에이전트도 부르지 않았습니다. 도구 호출은 명령 실행 2번(파일 목록 보기, 내용 읽기)과 저장 2번으로, 플러그인 없이 1회차와 같았습니다. 7점은 우연히 표 하나가 더 들어간 차이입니다. 스킬 설명에 적힌 부르는 말이 “브랜드 가이드라인 만들어 줘”, “스타일 가이드 만들어 줘” 같은 영어 표현이라 한국어 요청과 맞지 않았을 수 있습니다. 확실하게 쓰려면 명령으로 부르는 편이 맞습니다.

플러그인 명령으로: 길고 꼼꼼한 가이드

명령 쪽 가이드는 356~357줄입니다. 위에서 본 표와 확신도, 질문 목록 말고도 꼭 쓸 말·피할 말 목록, 불만 리뷰에 답하는 순서(인정 → 이유 → 대안), 좋은 글과 피할 글의 예가 들어 있습니다. 2023년 글은 “Example to Avoid”(피할 예)로 넣었습니다. 2회차에서는 품질 점검 에이전트가 “모든 인스타그램 글”이라는 과장된 표현과 원문과 다르게 옮긴 인용을 찾아내, 클로드가 고친 뒤 저장했습니다. 가이드를 쓰고 점검까지 거치느라 시간과 비용이 더 들었습니다.

이런 사람에게 권합니다

• ✅ 여러 사람이 가게나 회사 글을 나눠 쓰는 곳. 직원이 바뀌어도 넘겨줄 말투 기준 문서가 생기고, 확신도와 질문 목록으로 “아직 안 정한 것”이 보입니다.
• ✅ 자료가 여기저기 흩어져 있고 서로 어긋나는 곳. 자료끼리 다른 부분을 질문으로 뽑아 주는 것이 이 플러그인의 가장 큰 차이였습니다.
• ✅ 노션·컨플루언스·구글 드라이브에 브랜드 자료가 쌓인 회사. 연결해 두면 자료 찾기부터 맡길 수 있습니다(이번에는 시험하지 않음, 공식 설명 기준).
• ❌ 이미 말투 규칙이 분명하고 글 한 편만 필요한 사람. 플러그인 없이 같은 자료를 주고 부탁해도 공지 글은 똑같이 잘 나왔고 훨씬 빨랐습니다.

한계와 주의할 점

• 가상 카페 자료 한 벌로 조건마다 두 번씩만 돌렸습니다. 자료가 많으면 시간과 비용이 더 늘 수 있습니다.
• 플러그인을 켜 두면 쓰지 않는 대화에도 설명 분량(약 2,600토큰)이 붙습니다. 가이드를 다 만든 뒤에는 꺼 두었다가 쓸 때 켜는 방법도 있습니다(claude plugin disable brand-voice@knowledge-work-plugins).
• README에는 아직 개인 단위로만 동작하고 팀 전체 적용은 준비 중이라고 적혀 있습니다. 팀원과 같은 가이드를 쓰려면 가이드 파일을 직접 나눠 줘야 합니다.

대안

방법	다른 점	이럴 때 고르세요
Brand Voice(이 글)	자료로 말투 가이드를 만들고, 확신도와 질문 목록까지	말투 기준 문서를 남기고 팀이 함께 정해야 할 때
플러그인 없이 요청	같은 자료로 짧은 가이드와 글을 1분 안팎에	규칙이 이미 분명하고 글 한 편이 급할 때
Marketing 플러그인	brand-review(브랜드 점검) 등 마케팅 스킬 8개 묶음	홍보 계획, 캠페인, SEO까지 함께 맡길 때
brand-guidelines 스킬	말투가 아니라 색·글꼴 같은 시각 규칙을 문서에 입힘	문서·슬라이드 모양을 회사 색으로 맞출 때

자주 묻는 질문

Brand Voice 플러그인은 무료인가요?

플러그인은 MIT 라이선스로 무료입니다. 다만 쓸 때 클로드 사용량이 들고, 구독 요금제라면 사용 한도에서 차감됩니다. 이번 실험의 달러 금액은 사용량을 API 단가로 바꿔 본 값입니다.

노션이나 구글 드라이브를 연결해야만 쓸 수 있나요?

아닙니다. 이번에는 폴더에 넣은 마크다운·텍스트 파일만으로 가이드를 만들었습니다. 공식 설명으로는 PDF, 파워포인트, 워드 파일도 읽습니다. 연결은 자료를 자동으로 찾는 /brand-voice:discover-brand를 쓸 때 필요합니다.

한국어 글에도 쓸 수 있나요?

네. 한국어 자료를 주니 가이드 본문과 공지 글이 한국어로 나왔고, 해요체와 합니다체를 상황별로 나눠 적었습니다. 가이드 소제목만 영어 틀 그대로입니다.

만든 가이드는 어디에 저장되나요?

기본 위치는 작업 폴더의 .claude/brand-voice-guidelines.md입니다. 이 위치에 있어야 다음 대화에서 /brand-voice:enforce-voice가 자동으로 찾습니다. 같은 이름의 파일이 이미 있으면 보관한 뒤 새로 쓰도록 되어 있습니다.

출처

Brand Voice 플러그인 폴더(README), anthropics/knowledge-work-plugins 저장소 (모두 2026-10-20 확인, 저장소 별 30,504개, 플러그인 버전 1.1.0)