ux-writing-korean
한국어로 UI/UX 문구를 작성하거나 검수할 때 사용합니다. 해요체, 능동형, 긍정형, 캐주얼 경어, 명사 조합 회피 등 5가지 핵심 원칙과 예외 규칙을 적용합니다.
- License 许可
- MIT
- 最近更新
- 2026-11-11
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- ux-writing-korean
- metadata
- { "email": "initred@dou.so", "author": "initred", "version": "1.0.0" }
- description
- 한국어로 UI/UX 문구를 작성하거나 검수할 때 사용합니다. 해요체, 능동형, 긍정형, 캐주얼 경어, 명사 조합 회피 등 5가지 핵심 원칙과 예외 규칙을 적용합니다.
03 SKILL.md 正文
한국어 UX 라이팅 가이드
한국어 제품 문구를 작성하고 검수하는 스킬이에요.
사용 시기
- 제품 UI 문구를 작성하거나 검토할 때
- 에러 메시지, 안내 문구, 버튼 텍스트 등을 교정할 때
- UX 라이팅 리뷰가 필요할 때
핵심 원칙 5가지
1. 해요체 사용
제품 안의 모든 문구는 '해요체'로 작성해요. 상황과 맥락을 불문하고 이 규칙을 지켜요.
| X | O |
|---|---|
| 설정을 저장합니다 | 설정을 저장해요 |
| 프로필이 업데이트되었습니다 | 프로필이 업데이트됐어요 |
2. 능동적 말하기
수동형 표현을 능동형으로 바꿔요. 최대한 능동형 문장을 사용해요.
'됐어요' → '했어요'
| X | O |
|---|---|
| 알림이 설정됐어요 | 알림을 설정했어요 |
| 예약이 취소됐어요 | 예약을 취소했어요 |
'~었' 빼기
과거형 어미를 제거하여 더 직접적으로 표현해요.
| X | O |
|---|---|
| 새 비밀번호로 바뀌었어요 | 새 비밀번호로 바꿨어요 |
| 등록된 이메일 | 등록한 이메일 |
동사 바꿔쓰기
더 능동적인 동사로 전환해요.
| X | O |
|---|---|
| 응답 속도가 느려졌어요 | 응답 속도가 줄었어요 |
3. 긍정적 말하기
부정적 커뮤니케이션을 최소화하고 긍정형 문장을 우선 사용해요. 예 : 안 돼요, 없어요 (X) → ~하면 할 수 있어요 (O)
'없어요' → '있어요'
| X | O |
|---|---|
| 검색 결과가 없어요 | 다른 키워드로 검색하면 찾을 수 있어요 |
| 저장 공간이 부족해요 | 파일을 정리하면 업로드할 수 있어요 |
에러 메시지도 긍정적으로
사용자 입장에서 해결 방법을 제시해요.
| X | O |
|---|---|
| 네트워크 오류가 발생했어요 | 다시 시도하면 연결할 수 있어요 |
| 비밀번호가 틀렸어요 | 비밀번호를 다시 확인해주세요 |
혜택 대상 안내
사용자가 스캔할 때 오해하지 않도록 긍정형으로 표현해요.
| X | O |
|---|---|
| 프리미엄 회원만 사용할 수 없어요 | 모든 회원이 사용할 수 있어요 |
4. 캐주얼한 경어
과도한 경어를 제거해요. 친근하고 캐주얼한 톤을 유지해요.
동사에서 '~시' 빼기
| X | O |
|---|---|
| 확인하세요 | 확인해요 |
| 선택하세요 | 선택해요 |
'계시다' → '있다'
| X | O |
|---|---|
| 회원님이 계시면 | 회원님이 있으면 |
'여쭈다' → '확인하다, 묻다'
| X | O |
|---|---|
| 몇 가지 여쭤볼게요 | 몇 가지 확인할게요 |
'께' → '에게'
| X | O |
|---|---|
| 회원님께 안내드려요 | 회원님에게 안내해요 |
경어를 뺐을 때 어색한 경우
파악하고 싶은 정보를 '주어'로 써서 문장을 재구성해요.
| X | O |
|---|---|
| 이 주소가 맞으시나요? | 이 주소가 맞나요? |
5. '{명사} + {명사}' 쓰지 않기
한자어 명사 조합을 풀어서 동사 형태로 표현해요.
한자어 풀어쓰기
| X | O |
|---|---|
| 파일 업로드 실패 | 파일을 업로드하지 못했어요 |
| 회원 가입 완료 | 회원 가입을 마쳤어요 |
한자어를 풀어쓰기 어려울 경우
'{명사}가 {명사}해서' 형태로 최소한 풀어써요.
| X | O |
|---|---|
| 서버 점검 중 이용 불가 | 서버를 점검하고 있어서 이용할 수 없어요 |
예외 규칙
수동형 문장이 더 명확하고 간결한 커뮤니케이션을 만드는 때도 있어요. 수동형으로 더 좋은 문장을 쓸 수 있는 사례를 알려드릴게요.
수동형 문장을 써도 되는 경우
1. 서비스 종료, 기간 만료
수동형 문장으로 쓰면 주어(종료 서비스, 기간 등)를 강조할 수 있어요. '종료'와 '만료'의 뉘앙스를 정확히 전달할 수 있어요.
서비스 종료: "베타 서비스 종료 안내 — 6월 30일부터 서비스가 종료돼요. 자세한 내용을 알려드려요."
기간 만료: "무료 체험 기간이 곧 만료돼요"
- 단, 주기적으로 종료가 반복되는 제품에는 '종료돼요'를 쓰지 않아요.
Don't: "오늘의 이벤트가 곧 종료돼요"
Do: "오늘의 이벤트가 곧 끝나요"
2. 사용자에게 미치는 영향을 알려줄 때
주요 동사: 연체, 해지, 적용 등. 수동형 문장으로 쓰면 인과 관계를 명확하게 설명하고, '사용자의 행동에 의해 따라오는 결과'라는 점을 알려줄 수 있어요.
구독 연체: "월 결제 12,000원 출금 실패 — 오늘까지 내지 않으면 연체돼요. 결제 금액을 내주세요."
정책 안내: "플랜을 변경하면 기존 구독이 해지돼요. 이 때 이번 달 말까지의 요금을 정산해야 해요."
3. 사용자 안심
수동형 문장으로 쓰면 정보 수집 안내 등 민감한 상황에서 사용자를 안심하게 할 수 있어요.
"상담이 끝나면 상담사도 회원님의 정보를 볼 수 없어요"
"회원님의 정보가 기록되지 않아요"
"이제부터 회원님의 개인정보 이용 내역이 기록돼요"
"더 좋은 상담을 위해 통화 내용은 녹음돼요"
4. '되어요' → '돼요'
모바일 화면의 좁은 공간을 고려하여 '돼요'로 통일해요.
경어를 써도 되는 경우
특정 상황에서 제한적으로 '~시나요?', '~셨나요?' 의문형 어미를 쓸 수 있어요.
1. 사용자의 맥락을 활용해서 질문할 때
'~시나요?', '~셨나요?' 형태의 경어를 활용해서 사용자의 당황스러움을 줄일 수 있어요.
"회원님, 강남점 다녀오셨나요? 매장에서 5% 할인 쿠폰을 보냈어요."
"정기 배송 변경하러 설정 가시나요? 앱에서 바로 변경할 수 있어요."
2. 사용자의 상황을 추정할 때
명확한 정보가 없어 사용자에게 직접 판단하게 해야 할 때 경어로 정중하게 질문할 수 있어요.
"상품을 받으셨나요? 후기를 남기면 포인트를 받을 수 있어요."
3. 사용자의 선의가 필요할 때
설문조사처럼 사용자의 선의를 기대해야 할 때 경어로 정중하게 질문해요.
"이번 달에 서비스를 쓰면서 얼마나 만족하셨나요?"
부정형 문장을 써도 되는 경우
사용자에게 명확하게 부정적인 내용을 알려줘야 할 때는 부정형 문장을 써도 좋아요.
1. 서비스를 정책 상 쓸 수 없을 때
부정형 문장으로 써야 사용자에게 상황을 명확하게 인지시킬 수 있어요. 쓸 수 없는 이유를 함께 안내해주세요.
"지금은 가입할 수 없어요 — 청소년을 위한 서비스는 아직 준비 중이에요."
"해외에서는 이 기능을 사용할 수 없어요 — 국내 법률에 따라 접근이 제한돼요."
2. 일부 기능만 쓸 수 없을 때
부정형 문장으로 써야 어떤 기능을 쓸 수 없는지 명확하게 인지시킬 수 있어요. 사용자 선택의 결과를 명확하게 안내할 수 있어요.
"프리미엄 혜택을 포인트로 받을까요? 한 번 바꾸면 기존 혜택은 다시 받을 수 없어요."
"시스템 점검 예정이에요. 점검 시간 동안 데이터를 내보내거나 동기화할 수 없어요."
3. 사용자 안심
부정형 문장으로 써야 정보 수집 안내 등 민감한 상황에서 사용자를 안심하게 할 수 있어요.
"상담이 끝나면 상담사도 회원님의 정보를 볼 수 없어요"
"회원님의 정보가 기록되지 않아요"
검수 체크리스트
문구를 검수할 때 다음 순서로 확인해요:
- 해요체인가? — '합니다', '습니다' 등 하십시오체가 아닌지 확인
- 능동형인가? — '됐어요'를 '했어요'로, 수동형을 능동형으로 바꿀 수 있는지 확인
- 긍정형인가? — '없어요', '못해요' 등 부정형을 긍정형으로 바꿀 수 있는지 확인
- 캐주얼한가? — '~시', '께', '여쭈다' 등 과도한 경어가 없는지 확인
- 명사 조합이 아닌가? — 한자어 명사 나열을 동사로 풀어쓸 수 있는지 확인
- 예외에 해당하는가? — 위 원칙의 예외 상황인지 확인
출력 형식
문구를 교정할 때는 다음 형식으로 출력해요:
원문: [원래 문구]
교정: [교정된 문구]
적용 규칙: [적용한 규칙 번호와 이름]
여러 문구를 한번에 검수할 때는 표 형식을 사용해요:
| 원문 | 교정 | 적용 규칙 |
|---|---|---|
| ... | ... | ... |
04 同仓库更多 Skills
template-skill
Replace with description of the skill and when the agent should use it.
writing-project-readme
Use when explicitly invoked to write or fully rewrite a project README that must cover tech stack, architecture, features, and service description in a single document — readable by non-engineers (PM, design, ops, domain experts) as well as developers. Triggers on requests like "write the README", "redo README.md based on the whole project", "make a comprehensive README everyone can understand". Skip for one-section edits, badge tweaks, or generating a CHANGELOG.
token-audit
Audit a Claude Code or Codex CLI project for token waste and fix it with the user's approval. Use whenever the user wants to check, reduce, or optimize token usage, context bloat, or API/subscription costs of an agent project — phrases like "토큰 점검", "토큰 낭비 찾아줘", "토큰 최적화", "컨텍스트 최적화", "Claude Code 비용 줄여줘", "API 비용이 너무 나와", "audit token efficiency", "check my CLAUDE.md/AGENTS.md/MCP setup". Also trigger when the user complains that sessions hit context limits too fast, that costs jumped unexpectedly, or asks whether their project setup is token-efficient — even if they don't say the word "token".
release-showcase
정식 릴리스의 변경을 이전·이후 스크린샷, 클릭 흐름 녹화 영상, 비교·단계·탭·흐름도 같은 HTML 컴포넌트로 보여 주는 파일 하나짜리 릴리스 문서를 만든다. 텍스트뿐인 릴리스 노트로는 어떤 UX가 바뀌었고 새 기능을 어떻게 쓰는지 감이 안 올 때 쓴다. '릴리스 노트 문서 만들어 줘', '릴리스 쇼케이스', '이번 배포 변경사항 정리해서 공유', '릴리즈 노트 HTML', '변경사항을 화면으로 보여 주는 문서', '업데이트 소개 페이지', 'what's new 페이지', 'release notes with screenshots', 'changelog page', '배포 공지 자료'처럼 버전 태그 사이의 변경을 팀·고객에게 시각적으로 알릴 때 반드시 사용한다. git 태그로 릴리스하는 저장소라면 웹·데스크톱·모바일 어느 앱이든 쓴다. 커밋 목록만 필요한 CHANGELOG.md 갱신, 릴리스 태그·배포 자체, 마케팅 영상 제작에는 쓰지 않는다.
public-sector-rfp-authoring
Use when drafting or revising Korean government or local-government bid notices, requests for proposals, statements of work, or public-sector service/project specifications from the ordering agency's perspective.
onboarding-design
Use when designing, reviewing, or auditing signup flows, goal-selection quizzes, permission prompts, paywalls, or any screen a user sees before their first meaningful action.