FAQ, 틀린 답 한 줄이 아예 없는 것보다 손해다

작은 쇼핑몰은 같은 문의에 하루에도 몇 번씩 같은 답을 적습니다. FAQ(자주 묻는 질문) 페이지를 만들면 줄어들지만, 기준이 바뀐 뒤에도 옛 답이 그대로 남아 있으면 그 글이 오히려 항의를 부릅니다. 아래 스킬 안내문도 틀린 도움말은 글이 없는 것보다 나쁘다고 적었습니다. 앤트로픽 공식 플러그인 Customer Support(고객지원)의 kb-article 스킬은 처리한 문의를 고객이 스스로 찾아 읽는 도움말 글로 바꿔 주고, 무료이지만 클로드 유료 요금제의 사용량을 씁니다. 가상 식물 쇼핑몰의 문의 기록으로 클로드 코드(Claude Code)에 같은 요청을 스킬 없이 2번, 스킬로 2번 보냈습니다. 2026-11-14 macOS 26.1, Claude Code 2.1.299에서 직접 실행한 기록입니다.

세 줄 요약
  1. 한 달 치 문의 12건과 운영 기준을 주고 도움말 초안을 부탁하니, 4번 모두 1분이 채 안 걸려 질문 6~7개짜리 FAQ를 내놓았습니다.
  2. 4번 모두 바뀐 교환 기한(24시간 → 48시간)을 쓰고, 지금 올라가 있는 옛 도움말을 고쳐야 한다고 짚었고, 직원끼리만 보는 메모는 고객용 글에 넣지 않았습니다.
  3. 스킬 안내문 기준으로 채점하니 스킬 없이 7·7점, 스킬 10·9점이었습니다. 차이는 분류·태그 같은 게시 정보, 누가 언제 다시 볼지 적은 게시 메모, 결제 오류를 “알려진 문제” 형식으로 따로 쓴 데서 났습니다.

결과부터 보기: 같은 문의로 받은 도움말 초안 4개

실습 자료는 가상 식물 쇼핑몰 “초록창고”의 문서 3개입니다. 가게·사람·숫자는 모두 지어낸 것입니다. 작은 쇼핑몰 도움말에서 흔히 생기는 함정을 일부러 넣었습니다.

넣어 둔 것어디에
한 달 동안 들어온 문의 12건. 화분 파손 4건, 결제 오류 4건, 잎 변색 2건 등 같은 질문이 반복됨문의_모음.md
파손 교환 기한이 11월 1일부터 24시간 → 48시간으로 바뀜. 10월에는 24시간 기준으로 교환을 거절해 항의를 받음운영_기준.md, 문의 2번
3월에 쓴 지금 도움말에는 아직 “24시간 안에”가 남아 있음지금_도움말.md
결제 화면 문구 “카드사 승인 거절(051)”, 카카오페이 “결제 모듈 로딩 실패”(고치는 중)문의 4·8·9·10번
직원끼리만 보는 메모: 택배사 파손 보상, 3만 원 넘는 환불은 사장 승인, 카카오페이 복구 예상일(확정 아님)운영_기준.md 맨 아래
실습 재료 → 스킬 없이 1회차 → 스킬 1회차 · Claude Code · 소넷 5.5 · 생각 깊이 중간

직접 눌러 보기: 실습 재료 · 스킬 없이 1 · 스킬 없이 2 · 스킬 1 · 스킬 2. 결과물 “도움말_초안.md”를 고치지 않고 웹페이지로만 바꿨고, 아래쪽 노란 칸에 클로드가 남긴 답변을 붙였습니다.

조건질문 수게시 정보(분류·태그·대상)카카오페이 오류게시 메모점수
스킬 없이 16개 + 고객센터 안내없음FAQ 한 항목, 상태·대체 결제만답변에서만7
스킬 없이 26개 + 고객센터 안내없음FAQ 한 항목, 상태·대체 결제만답변에서만7
스킬 17개(4개 분류)있음상태·영향·업데이트 붙은 “알려진 문제” 형식파일 아래쪽, “지우고 올리라”는 안내10
스킬 27개 + 목차있음FAQ 한 항목, 복구 일정 미정파일 아래쪽 Publishing Notes9

직접 실행 확인한 날짜 2026-11-14

실행 환경
macOS 26.1 · Claude Code 2.1.299 · 소넷(Sonnet) 5.5 · 생각 깊이 중간 (4번 모두 같은 설정)
설치 난이도
명령 두 줄(공식 README)
비용
플러그인 무료. 한 번에 API 단가로 스킬 없이 0.24달러, 스킬 0.21달러어치
라이선스
Apache-2.0 · anthropics/knowledge-work-plugins(별 35,698개, 2026-11-14 기준)

4번 모두 지킨 것: 48시간, 오류 문구 그대로, 직원 메모 빼기

가장 걱정한 함정은 교환 기한이었습니다. 지금 도움말과 10월 문의 답변에는 24시간이 남아 있고, 운영 기준에만 48시간이 있습니다. 4번 모두 고객 안내는 48시간으로 썼고, 지금 올라가 있는 “화분이 깨져서 왔어요” 글의 24시간을 고치거나 새 글로 바꿔야 한다고 따로 알렸습니다. 스킬 없이 받은 2번은 이 말을 파일이 아니라 끝맺음 답변에 적었습니다.

결제 오류는 4번 모두 화면에 뜨는 문구를 그대로 질문 제목에 넣었습니다. 고객은 “카드사 승인 거절(051)”을 그대로 복사해 검색하니, 이 문구가 제목에 있어야 도움말 검색에 걸립니다. 질문 제목도 “화분이 깨져서 왔어요”, “잎이 노랗게 변해요”처럼 고객이 쓴 말로 지었고, 첫 문장에 바로 답을 적었습니다.

직원끼리만 보는 메모는 4번 모두 고객용 본문에 넣지 않았습니다. 택배사 보상, 3만 원 환불 승인 기준, 결제대행사 이름이 빠졌고, 카카오페이 복구 예상일(11월 20일쯤)은 확정이 아니라서 날짜 없이 “고치는 중”으로만 썼습니다.

스킬 없이 1회차 도움말 초안의 카카오페이 항목. 결제 대행사와 고치는 중이니 카드나 계좌이체를 써 달라는 안내
스킬 없이 1회차의 카카오페이 항목 · Claude Code · 소넷 5.5 · 생각 깊이 중간

스킬을 불렀을 때 달라진 것: 게시 정보와 “알려진 문제” 형식

스킬 안내문에는 도움말 글을 FAQ, 사용법, 문제 해결, 알려진 문제(Known issue) 다섯 가지로 나누고, 글마다 유형·분류·태그·대상을 붙이라는 틀이 있습니다. 스킬 2번은 모두 맨 위에 이 정보를 붙였습니다. 태그에는 “화분 깨짐·화분 파손”, “잎 노랗게·누렇게”처럼 같은 뜻의 다른 말을 함께 넣었습니다. 고객이 어느 말로 검색해도 걸리게 하라는 안내문 내용과 같습니다.

스킬 1회차는 카카오페이 오류를 다른 질문과 다르게 썼습니다. 안내문의 “알려진 문제” 틀대로 상태·영향·마지막 업데이트를 붙이고, 증상·시작 시점·임시 방법·복구 시점을 나눠 적었습니다. 고쳐지면 “해결됨”으로 바꾸고 30일쯤 뒤 정리하라는 말도 게시 메모에 남겼습니다.

스킬 1회차 도움말 초안의 카카오페이 오류 항목. 상태 해결 중, 영향, 마지막 업데이트, 증상·시작 시점·임시 방법·복구 시점 목록
스킬 1회차의 카카오페이 항목. 알려진 문제 형식 · Claude Code · 소넷 5.5 · 생각 깊이 중간

게시 메모도 스킬 쪽에만 파일 안에 있었습니다. 어느 문의 몇 번에서 나온 답인지, 사장님이 확인할 것, 다음 검토 시점(카카오페이는 복구 즉시, 나머지는 분기마다 또는 2027년 2월)이 들어 있습니다. 자료에 없는 내용은 지어내지 않고 “확인이 필요한 부분”으로 따로 뺐습니다. 스킬 1회차는 “주문 정보를 함께 보내 달라”는 문구를 자기가 덧붙였다고 스스로 밝혔습니다.

스킬 2회차 도움말 초안 아래쪽 게시 메모. 출처, 고칠 기존 글, 확인할 사람, 다음 검토 시점, 확인이 필요한 부분 목록
스킬 2회차 파일 아래쪽의 게시 메모(Publishing Notes) · Claude Code · 소넷 5.5 · 생각 깊이 중간

주의할 점도 하나 나왔습니다. 스킬 2회차의 게시 메모에는 “택배사 파손 보상, 환불 3만 원 초과 시 사장 승인은 넣지 않았다”는 설명이 들어 있습니다. 고객용 본문에는 없지만, 파일을 통째로 쇼핑몰에 붙여 넣으면 이 줄이 그대로 공개됩니다. 1회차는 이 구역 제목에 “이 아래는 지우고 올려 주세요”라고 적었고, 2회차에는 그런 안내가 없었습니다.

스킬 없이 받은 2번은 짧고 바로 올리기 좋은 FAQ였습니다. 질문과 답만 있어서 쇼핑몰 게시판에 그대로 붙여 넣어도 됩니다. 확인할 점은 끝맺음 답변에 적었습니다. 채점 항목 중 “글 유형 구분”과 “게시 정보”는 스킬 안내문의 형식이라 스킬 쪽에 유리한 항목이고, 점수 차이는 대부분 여기서 났습니다.

시간은 스킬 쪽이 두 배쯤 걸렸지만 둘 다 1분이 채 안 걸렸고, 사용량은 거의 같았습니다.

Customer Support 플러그인에 들어 있는 것

Customer Support 플러그인 1.3.0에는 스킬 5개가 들어 있습니다. 모두 슬래시 명령으로 부를 수 있고, 인터콤(Intercom)·허브스팟(HubSpot) 같은 상담 도구가 연결돼 있으면 거기서 문의 기록을 직접 읽는다고 안내문에 적혀 있습니다. 이번에는 아무것도 연결하지 않고 폴더 파일만 썼습니다.

스킬하는 일부를 때 분량
/customer-support:kb-article처리한 문의를 도움말 글로. 이 글에서 써 봄약 4.1천 토큰
/customer-support:ticket-triage문의 분류·급한 순서 정하기약 3.8천 토큰
/customer-support:draft-response고객 답장 초안. 고객지원 플러그인 리뷰에서 써 봄약 4.9천 토큰
/customer-support:customer-escalation개발·관리자에게 넘길 문제 정리약 3.8천 토큰
/customer-support:customer-research고객 배경·이전 기록 조사약 3.4천 토큰

kb-article 안내문은 글 유형마다 틀을 줍니다. FAQ는 “고객 말로 쓴 질문 → 1~3문장 답 → 관련 질문”, 문제 해결 글은 “증상 → 원인 → 해결 → 예방”, 알려진 문제는 “상태·영향 → 증상 → 임시 방법 → 고칠 일정”입니다.

복사해 쓰는 요청문과 실습 자료

아래 요청문을 그대로 썼습니다. 스킬 조건에서는 맨 앞에 /customer-support:kb-article을 붙였습니다.

우리 식물 쇼핑몰 '초록창고'에 지난 한 달 같은 문의가 계속 들어와. 이 폴더 자료를 보고 쇼핑몰 도움말(자주 묻는 질문) 페이지에 올릴 글을 도움말_초안.md로 만들어 줘. 더 물어볼 사람이 없으니 이 폴더 자료만 보고 해 줘.

좋은 답이라면 교환 기한이 48시간이고, 옛 도움말을 고치라는 말이 있고, 직원 메모가 고객용 글에 없습니다.

우리 가게에 쓸 때는 상담 기록을 한 파일로 모으고, 지금 운영 기준과 이미 올라가 있는 도움말을 함께 넣습니다. 옛 도움말을 같이 넣어야 바뀐 기준을 찾아 줍니다. 직원끼리만 보는 내용은 “고객에게 알리지 말 것”처럼 구역을 나눠 표시해 두면 이번처럼 빠집니다.

실습 자료 내려받기(claude-faq-practice.zip): 문의 모음, 운영 기준, 지금 도움말, 요청문, 채점 기준을 넣었습니다.

1단계. 플러그인 넣기 (약 2분, 공식 문서 기준)

이 단계에서는 클로드 코드가 kb-article 안내문을 읽을 수 있게 합니다. 플러그인 README에 적힌 설치 명령은 터미널에서 아래 두 줄입니다. 이 설치 명령은 이번에 실행하지 않았고, 이 부분은 공식 문서 기준입니다.

claude plugin marketplace add anthropics/knowledge-work-plugins
claude plugin install customer-support@knowledge-work-plugins

설치하지 않고 한 번만 써 보려면 저장소를 내려받아 --plugin-dir로 플러그인 폴더를 가리킵니다. 그 실행에만 붙습니다. 이번 실험은 플러그인 폴더 사본에 이 옵션을 써서 했습니다.

git clone https://github.com/anthropics/knowledge-work-plugins
claude --plugin-dir knowledge-work-plugins/customer-support

이렇게 나오면 성공 공식 문서에 따르면 설치 뒤 /customer-support:kb-article 같은 슬래시 명령을 쓸 수 있습니다. 이번 스킬 조건 2번은 세션 기록에 안내문 본문이 들어간 것을 확인했습니다.

  • command not found: claude가 나오면 터미널을 닫았다 다시 열고 claude --version을 먼저 확인합니다.
  • 플러그인에는 슬랙·인터콤·허브스팟·노션 같은 외부 연결 설정이 함께 들어 있습니다. 이번에는 사본에서 이 설정 파일을 빼고 썼습니다. 공식 설치로 넣으면 이 연결 설정이 함께 들어오니, 쓰지 않을 연결은 켜지 않습니다.
  • 필요 없어지면 claude plugin uninstall customer-support@knowledge-work-plugins로 지웁니다.

2단계. 문의 폴더에서 도움말 초안 받기 (약 1분)

이 단계에서는 도움말 초안 파일을 받습니다. 자료가 있는 폴더에서 터미널로 claude를 켜고 위 요청문을 붙여 넣습니다. 이번 실험은 claude -p로 한 번에 보냈습니다. 채점 기준은 실행 전에 스킬 안내문의 검색되는 글쓰기 요령, 글 유형 틀, 결과물 틀에서 뽑아 정해 두었습니다.

이렇게 나오면 성공 폴더에 “도움말_초안.md”가 생기고, 주었던 문서 3개는 그대로입니다. 4번 모두 1분이 채 안 걸렸고, 자료 파일은 한 글자도 바뀌지 않았습니다.

  • 스킬로 받은 파일은 아래쪽에 직원용 게시 메모가 붙어 나옵니다. 쇼핑몰에 올리기 전에 이 구역을 꼭 지웁니다.
  • “이 문의는 FAQ로, 저 문의는 문제 해결 글로”처럼 유형을 나누고 싶으면 요청문에 “글 유형별로 나눠 줘”를 덧붙입니다.
채점 항목없이 1없이 2스킬 1스킬 2
고객 말투 질문·첫 문장에 답 (2점)2222
오류 문구 두 개 그대로 (1점)1111
48시간으로 씀·옛 도움말 고치라고 짚음 (2점)2222
카카오페이를 상태·대체 결제와 함께, 날짜 약속 없이 (1점)1111
고객용 글에 직원 메모 없음 (1점)1111
글 유형 구분 (1점, 스킬 형식)0010
분류·태그·대상 같은 게시 정보 (1점, 스킬 형식)0011
확인할 사람·다음 검토 시점 (1점)0011
합계77109

실행 기록 · <작업 폴더>/tools/run.sh, <작업 폴더>/runs.tsv

# 읽기 쉽게 줄여 적은 명령. 같은 요청문, 스킬 조건은 --plugin-dir·--add-dir과 맨 앞 /customer-support:kb-article
claude -p "$(cat tools/request.txt)" --model claude-sonnet-5-5 --effort medium \
  --setting-sources project,local --permission-mode acceptEdits [--plugin-dir skill/customer-support --add-dir skill/customer-support] \
  --allowedTools "Bash(ls:*),Bash(python3:*),Bash(cat:*),Bash(find:*),Bash(grep:*),Bash(wc:*),Read,Write,Edit,Skill,Glob,Grep" --disallowedTools "WebSearch,WebFetch" --output-format stream-json --verbose

조건	불린 도구	시간(ms)	사용량(달러)	턴	채점
none-1	Glob,Read,Write	19781	0.237	6	7
none-2	Glob,Read,Write	22761	0.241	6	7
skill-1	Bash,Read,Write	38598	0.205	6	10
skill-2	Bash,Read,Write	40675	0.215	7	9

이런 사람에게 권합니다

  • ✅ 상담 도구의 문의 기록으로 도움말을 계속 늘려 가는 고객지원 담당자. 분류·태그·검토 시점이 붙어 나와 도움말 관리가 쉬워집니다.
  • ✅ 결제 장애처럼 상태가 바뀌는 안내를 자주 올리는 쇼핑몰. 알려진 문제 형식으로 받으면 고쳐진 뒤 정리할 때를 놓치지 않습니다.
  • ❌ 게시판에 FAQ 몇 개를 한 번 올릴 사람. 이번 자료에서는 스킬 없이도 기한·오류 문구·직원 메모를 모두 맞게 처리했고, 바로 붙여 넣기 좋은 짧은 글이 나왔습니다.

한계와 주의할 점

  • 조건마다 2번씩, 지어낸 작은 쇼핑몰 자료로 해 본 결과입니다. 문의가 수백 건인 실제 상담 기록에서는 결과가 다를 수 있습니다.
  • “알려진 문제” 형식은 스킬 2번 중 1번만 따랐습니다. 꼭 필요하면 요청문에 적어 두는 편이 확실합니다.
  • 식물 관리처럼 자료에 사례가 하나뿐인 답은 그대로 일반화될 수 있습니다. 스킬 2회차는 “몬스테라 말고 다른 식물에도 맞는지 확인이 필요하다”고 적었습니다.

대안

이름다른 점이럴 때 고르세요
클로드 코드에 요청만설치 없음. 이번에는 짧고 바로 올릴 수 있는 FAQ가 나옴FAQ를 한 번 정리할 때
kb-article(이 글)글 유형 틀·게시 정보·검토 시점이 붙어 나옴. 상담 도구 연결 가능(안내문 기준)도움말을 계속 관리할 때
draft-response(고객 답장)도움말이 아니라 고객 한 명에게 보낼 답장문의에 하나씩 답할 때
process-doc(업무 매뉴얼)고객용이 아니라 직원용 처리 절차 문서교환 처리 절차를 직원끼리 맞출 때

자주 묻는 질문

FAQ 뜻이 무엇인가요?

FAQ는 Frequently Asked Questions의 줄임말로 “자주 묻는 질문”입니다. 고객이 반복해서 묻는 질문과 답을 한곳에 모은 페이지를 말합니다. kb-article 안내문은 FAQ를 도움말 글 유형 가운데 하나로 보고, 답이 길어지면 FAQ가 아니라 사용법 글로 나누라고 합니다.

FAQ 질문 제목은 어떻게 쓰나요?

고객이 실제로 쓴 말로 씁니다. “파손 상품 교환 정책”보다 “화분이 깨져서 왔어요”가 검색에 걸립니다. 오류가 뜨는 질문은 화면 문구를 그대로 넣습니다. 이번 4번 모두 이렇게 썼습니다.

기준이 바뀌면 FAQ는 어떻게 고치나요?

바뀐 기준이 있는 문서와 지금 올라가 있는 도움말을 함께 넣고 초안을 받으면, 어느 글을 고쳐야 하는지 알려 줍니다. 이번에는 4번 모두 24시간이 남은 옛 글을 찾아 고치라고 했습니다. 스킬 안내문은 틀린 도움말이 아예 없는 것보다 나쁘다며 분기마다 다시 보라고 합니다.

쇼핑몰 게시판에 바로 올려도 되나요?

스킬 없이 받은 초안은 질문과 답만 있어 거의 그대로 붙여 넣을 수 있습니다. 스킬로 받은 초안은 맨 위 게시 정보와 아래쪽 게시 메모를 지우고 올립니다. 어느 쪽이든 날짜·금액은 한 번 더 확인합니다.

출처

anthropics/knowledge-work-plugins 저장소, Customer Support 플러그인, kb-article SKILL.md (2026-11-14 확인)