korean-ux-writing
한국어 화면 문구 쓰기
버튼, 안내, 오류, 빈 화면 문구를 사용자 말로 쓰고, 한 서비스 안에서 말투와 용어를 맞춰요.
2026년 11월 17일 추가한국어로 씀
까는 법
터미널에 붙여 넣으면 ~/.claude/skills/korean-ux-writing/SKILL.md에 파일 하나가 받아져요. Claude Code를 다시 켜면 스킬 목록에 나타나요.
mkdir -p ~/.claude/skills/korean-ux-writing && curl -fsSL https://beautifulsoup.dev/skill-files/korean-ux-writing/SKILL.md -o ~/.claude/skills/korean-ux-writing/SKILL.md
명령을 쓰기 어렵다면 아래 SKILL.md를 복사하거나 내려받아, 같은 위치에 korean-ux-writing 폴더를 만들고 그 안에 넣어도 돼요. 한 프로젝트에서만 쓰려면 프로젝트 안의 .claude/skills/에 넣어요.
에이전트가 이 스킬을 꺼내는 때
웹사이트나 앱의 한국어 화면 문구(버튼, 라벨, 안내, 오류, 알림, 빈 화면, 확인 창)를 쓰거나 고칠 때 쓴다. 화면 코드를 만들면서 문구를 넣을 때도 자동으로 따른다.
SKILL.md 머리말의 설명이에요. 에이전트는 이 설명을 보고 언제 이 스킬을 쓸지 정해요. 이름을 직접 불러 써도 돼요.
SKILL.md
말투
- 서비스 전체에서 한 가지 높임(해요체 또는 합니다체)만 쓴다. 이미 정해진 말투가 있으면 그것을 따른다.
- 시스템의 말이 아니라 사용자의 말로 쓴다. "요청 처리에 실패했습니다"가 아니라 "저장하지 못했어요".
버튼과 링크
- 누르면 일어나는 일을 동사로 쓴다: "저장하기", "보내기", "삭제". "확인", "제출", "OK"는 피한다.
- 같은 행동은 처음부터 끝까지 같은 낱말로 부른다. 버튼이 "게시"면 완료 알림도 "게시했어요".
- 되돌릴 수 없는 행동은 무엇이 사라지는지 버튼이나 확인 창에 적는다.
오류
- 무엇이 잘못됐는지와 어떻게 고치는지를 함께 쓴다: "비밀번호가 8자보다 짧아요. 8자 이상으로 적어 주세요."
- 사과로 시작하지 않는다. 사용자를 탓하지 않는다.
- 오류 코드는 필요할 때만, 문장 뒤에 괄호로 붙인다.
빈 화면과 불러오는 중
- 빈 화면은 기분이 아니라 다음 행동을 알려 준다: "아직 저장한 글이 없어요. 글 오른쪽 위 책갈피를 누르면 여기에 모여요."
- 오래 걸리는 작업은 무엇을 하고 있는지 알린다.
피할 것
- 개발자 말: 서버, 요청, 세션, null, 실패 코드
- 영어를 그대로 옮긴 말: "성공적으로 저장되었습니다" 대신 "저장했어요"
- 영어식 긴 줄표, 느낌표 남발, 과장
돌려줄 것
문구를 고칠 때는 화면, 원래 문구, 고친 문구, 까닭을 표로 주고, 이 서비스에서 쓸 용어 목록(쓸 말, 쓰지 않을 말)을 함께 정리한다.
글쓰기의 다른 스킬
- 근거를 붙여 쓰는 칼럼evidence-column칼럼이나 정보성 글을 쓸 때 주장마다 출처를 달고, 숫자는 원자료로 확인하고, 확실하지 않은 것은 그렇다고 써요.
- 맞춤법과 띄어쓰기 교정korean-proofreading한글 맞춤법 규정에 맞춰 틀린 곳만 고치고, 고친 까닭을 한 줄씩 알려 줘요. 문체는 건드리지 않아요.
- 번역투 없는 영어 한국어 번역en-ko-translation영어 문서를 한국어로 처음 쓴 것처럼 옮기고, 용어집을 만들어 문서 전체에서 같은 말을 쓰게 해요.
- 한국어 글에서 AI 티 지우기korean-natural-writing한국어 글을 쓰거나 고칠 때마다 번역투, 기계적인 문장부호, 빈말을 걸러서 사람이 쓴 것처럼 읽히게 해요.
이런 스킬도 있으면 좋겠다 싶으면 알려 주세요