From figma-logos-svgl
한국어로 UI/UX 문구를 작성하거나 검수할 때 사용합니다. 해요체, 능동형, 긍정형, 캐주얼 경어, 명사 조합 회피 등 5가지 핵심 원칙과 예외 규칙을 적용합니다.
How this skill is triggered — by the user, by Claude, or both
Slash command
/figma-logos-svgl:ux-writing-koreanThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
한국어 제품 문구를 작성하고 검수하는 스킬이에요.
한국어 제품 문구를 작성하고 검수하는 스킬이에요.
제품 안의 모든 문구는 '해요체'로 작성해요. 상황과 맥락을 불문하고 이 규칙을 지켜요.
| X | O |
|---|---|
| 설정을 저장합니다 | 설정을 저장해요 |
| 프로필이 업데이트되었습니다 | 프로필이 업데이트됐어요 |
수동형 표현을 능동형으로 바꿔요. 최대한 능동형 문장을 사용해요.
| X | O |
|---|---|
| 알림이 설정됐어요 | 알림을 설정했어요 |
| 예약이 취소됐어요 | 예약을 취소했어요 |
과거형 어미를 제거하여 더 직접적으로 표현해요.
| X | O |
|---|---|
| 새 비밀번호로 바뀌었어요 | 새 비밀번호로 바꿨어요 |
| 등록된 이메일 | 등록한 이메일 |
더 능동적인 동사로 전환해요.
| X | O |
|---|---|
| 응답 속도가 느려졌어요 | 응답 속도가 줄었어요 |
부정적 커뮤니케이션을 최소화하고 긍정형 문장을 우선 사용해요. 예 : 안 돼요, 없어요 (X) → ~하면 할 수 있어요 (O)
| X | O |
|---|---|
| 검색 결과가 없어요 | 다른 키워드로 검색하면 찾을 수 있어요 |
| 저장 공간이 부족해요 | 파일을 정리하면 업로드할 수 있어요 |
사용자 입장에서 해결 방법을 제시해요.
| X | O |
|---|---|
| 네트워크 오류가 발생했어요 | 다시 시도하면 연결할 수 있어요 |
| 비밀번호가 틀렸어요 | 비밀번호를 다시 확인해주세요 |
사용자가 스캔할 때 오해하지 않도록 긍정형으로 표현해요.
| X | O |
|---|---|
| 프리미엄 회원만 사용할 수 없어요 | 모든 회원이 사용할 수 있어요 |
과도한 경어를 제거해요. 친근하고 캐주얼한 톤을 유지해요.
| X | O |
|---|---|
| 확인하세요 | 확인해요 |
| 선택하세요 | 선택해요 |
| X | O |
|---|---|
| 회원님이 계시면 | 회원님이 있으면 |
| X | O |
|---|---|
| 몇 가지 여쭤볼게요 | 몇 가지 확인할게요 |
| X | O |
|---|---|
| 회원님께 안내드려요 | 회원님에게 안내해요 |
파악하고 싶은 정보를 '주어'로 써서 문장을 재구성해요.
| X | O |
|---|---|
| 이 주소가 맞으시나요? | 이 주소가 맞나요? |
한자어 명사 조합을 풀어서 동사 형태로 표현해요.
| X | O |
|---|---|
| 파일 업로드 실패 | 파일을 업로드하지 못했어요 |
| 회원 가입 완료 | 회원 가입을 마쳤어요 |
'{명사}가 {명사}해서' 형태로 최소한 풀어써요.
| X | O |
|---|---|
| 서버 점검 중 이용 불가 | 서버를 점검하고 있어서 이용할 수 없어요 |
수동형 문장이 더 명확하고 간결한 커뮤니케이션을 만드는 때도 있어요. 수동형으로 더 좋은 문장을 쓸 수 있는 사례를 알려드릴게요.
수동형 문장으로 쓰면 주어(종료 서비스, 기간 등)를 강조할 수 있어요. '종료'와 '만료'의 뉘앙스를 정확히 전달할 수 있어요.
서비스 종료: "베타 서비스 종료 안내 — 6월 30일부터 서비스가 종료돼요. 자세한 내용을 알려드려요."
기간 만료: "무료 체험 기간이 곧 만료돼요"
Don't: "오늘의 이벤트가 곧 종료돼요"
Do: "오늘의 이벤트가 곧 끝나요"
주요 동사: 연체, 해지, 적용 등. 수동형 문장으로 쓰면 인과 관계를 명확하게 설명하고, '사용자의 행동에 의해 따라오는 결과'라는 점을 알려줄 수 있어요.
구독 연체: "월 결제 12,000원 출금 실패 — 오늘까지 내지 않으면 연체돼요. 결제 금액을 내주세요."
정책 안내: "플랜을 변경하면 기존 구독이 해지돼요. 이 때 이번 달 말까지의 요금을 정산해야 해요."
수동형 문장으로 쓰면 정보 수집 안내 등 민감한 상황에서 사용자를 안심하게 할 수 있어요.
"상담이 끝나면 상담사도 회원님의 정보를 볼 수 없어요"
"회원님의 정보가 기록되지 않아요"
"이제부터 회원님의 개인정보 이용 내역이 기록돼요"
"더 좋은 상담을 위해 통화 내용은 녹음돼요"
모바일 화면의 좁은 공간을 고려하여 '돼요'로 통일해요.
특정 상황에서 제한적으로 '~시나요?', '~셨나요?' 의문형 어미를 쓸 수 있어요.
'~시나요?', '~셨나요?' 형태의 경어를 활용해서 사용자의 당황스러움을 줄일 수 있어요.
"회원님, 강남점 다녀오셨나요? 매장에서 5% 할인 쿠폰을 보냈어요."
"정기 배송 변경하러 설정 가시나요? 앱에서 바로 변경할 수 있어요."
명확한 정보가 없어 사용자에게 직접 판단하게 해야 할 때 경어로 정중하게 질문할 수 있어요.
"상품을 받으셨나요? 후기를 남기면 포인트를 받을 수 있어요."
설문조사처럼 사용자의 선의를 기대해야 할 때 경어로 정중하게 질문해요.
"이번 달에 서비스를 쓰면서 얼마나 만족하셨나요?"
사용자에게 명확하게 부정적인 내용을 알려줘야 할 때는 부정형 문장을 써도 좋아요.
부정형 문장으로 써야 사용자에게 상황을 명확하게 인지시킬 수 있어요. 쓸 수 없는 이유를 함께 안내해주세요.
"지금은 가입할 수 없어요 — 청소년을 위한 서비스는 아직 준비 중이에요."
"해외에서는 이 기능을 사용할 수 없어요 — 국내 법률에 따라 접근이 제한돼요."
부정형 문장으로 써야 어떤 기능을 쓸 수 없는지 명확하게 인지시킬 수 있어요. 사용자 선택의 결과를 명확하게 안내할 수 있어요.
"프리미엄 혜택을 포인트로 받을까요? 한 번 바꾸면 기존 혜택은 다시 받을 수 없어요."
"시스템 점검 예정이에요. 점검 시간 동안 데이터를 내보내거나 동기화할 수 없어요."
부정형 문장으로 써야 정보 수집 안내 등 민감한 상황에서 사용자를 안심하게 할 수 있어요.
"상담이 끝나면 상담사도 회원님의 정보를 볼 수 없어요"
"회원님의 정보가 기록되지 않아요"
문구를 검수할 때 다음 순서로 확인해요:
문구를 교정할 때는 다음 형식으로 출력해요:
원문: [원래 문구]
교정: [교정된 문구]
적용 규칙: [적용한 규칙 번호와 이름]
여러 문구를 한번에 검수할 때는 표 형식을 사용해요:
| 원문 | 교정 | 적용 규칙 |
|---|---|---|
| ... | ... | ... |
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub douinc/agent-skills --plugin writing-project-readme