agentsclimarketplace

Ux writing korean

Skill douinc/agent-skills/skills/ux-writing-korean

Agent skills for Claude Code, Copilot, Codex, and Gemini CLI — Figma icons (Iconify), logos (SVGL), Korean UX Writing, and more.

Install
npx -y skills add douinc/agent-skills --skill ux-writing-korean

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

한국어로 UI/UX 문구를 작성하거나 검수할 때 사용합니다. 해요체, 능동형, 긍정형, 캐주얼 경어, 명사 조합 회피 등 5가지 핵심 원칙과 예외 규칙을 적용합니다.

SKILL.md

10.2 KB, as published. Nobody here has run it

한국어 UX 라이팅 가이드

한국어 제품 문구를 작성하고 검수하는 스킬이에요.

사용 시기

  • 제품 UI 문구를 작성하거나 검토할 때
  • 에러 메시지, 안내 문구, 버튼 텍스트 등을 교정할 때
  • UX 라이팅 리뷰가 필요할 때

핵심 원칙 5가지

1. 해요체 사용

제품 안의 모든 문구는 '해요체'로 작성해요. 상황과 맥락을 불문하고 이 규칙을 지켜요.

XO
설정을 저장합니다설정을 저장해요
프로필이 업데이트되었습니다프로필이 업데이트됐어요

2. 능동적 말하기

수동형 표현을 능동형으로 바꿔요. 최대한 능동형 문장을 사용해요.

'됐어요' → '했어요'

XO
알림이 설정됐어요알림을 설정했어요
예약이 취소됐어요예약을 취소했어요

'~었' 빼기

과거형 어미를 제거하여 더 직접적으로 표현해요.

XO
새 비밀번호로 바뀌었어요새 비밀번호로 바꿨어요
등록된 이메일등록한 이메일

동사 바꿔쓰기

더 능동적인 동사로 전환해요.

XO
응답 속도가 느려졌어요응답 속도가 줄었어요

3. 긍정적 말하기

부정적 커뮤니케이션을 최소화하고 긍정형 문장을 우선 사용해요. 예 : 안 돼요, 없어요 (X) → ~하면 할 수 있어요 (O)

'없어요' → '있어요'

XO
검색 결과가 없어요다른 키워드로 검색하면 찾을 수 있어요
저장 공간이 부족해요파일을 정리하면 업로드할 수 있어요

에러 메시지도 긍정적으로

사용자 입장에서 해결 방법을 제시해요.

XO
네트워크 오류가 발생했어요다시 시도하면 연결할 수 있어요
비밀번호가 틀렸어요비밀번호를 다시 확인해주세요

혜택 대상 안내

사용자가 스캔할 때 오해하지 않도록 긍정형으로 표현해요.

XO
프리미엄 회원만 사용할 수 없어요모든 회원이 사용할 수 있어요

4. 캐주얼한 경어

과도한 경어를 제거해요. 친근하고 캐주얼한 톤을 유지해요.

동사에서 '~시' 빼기

XO
확인하세요확인해요
선택하세요선택해요

'계시다' → '있다'

XO
회원님이 계시면회원님이 있으면

'여쭈다' → '확인하다, 묻다'

XO
몇 가지 여쭤볼게요몇 가지 확인할게요

'께' → '에게'

XO
회원님께 안내드려요회원님에게 안내해요

경어를 뺐을 때 어색한 경우

파악하고 싶은 정보를 '주어'로 써서 문장을 재구성해요.

XO
이 주소가 맞으시나요?이 주소가 맞나요?

5. '{명사} + {명사}' 쓰지 않기

한자어 명사 조합을 풀어서 동사 형태로 표현해요.

한자어 풀어쓰기

XO
파일 업로드 실패파일을 업로드하지 못했어요
회원 가입 완료회원 가입을 마쳤어요

한자어를 풀어쓰기 어려울 경우

'{명사}가 {명사}해서' 형태로 최소한 풀어써요.

XO
서버 점검 중 이용 불가서버를 점검하고 있어서 이용할 수 없어요

예외 규칙

수동형 문장이 더 명확하고 간결한 커뮤니케이션을 만드는 때도 있어요. 수동형으로 더 좋은 문장을 쓸 수 있는 사례를 알려드릴게요.

수동형 문장을 써도 되는 경우

1. 서비스 종료, 기간 만료

수동형 문장으로 쓰면 주어(종료 서비스, 기간 등)를 강조할 수 있어요. '종료'와 '만료'의 뉘앙스를 정확히 전달할 수 있어요.

서비스 종료: "베타 서비스 종료 안내 — 6월 30일부터 서비스가 종료돼요. 자세한 내용을 알려드려요."

기간 만료: "무료 체험 기간이 곧 만료돼요"

  • 단, 주기적으로 종료가 반복되는 제품에는 '종료돼요'를 쓰지 않아요.

Don't: "오늘의 이벤트가 곧 종료돼요"

Do: "오늘의 이벤트가 곧 끝나요"

2. 사용자에게 미치는 영향을 알려줄 때

주요 동사: 연체, 해지, 적용 등. 수동형 문장으로 쓰면 인과 관계를 명확하게 설명하고, '사용자의 행동에 의해 따라오는 결과'라는 점을 알려줄 수 있어요.

구독 연체: "월 결제 12,000원 출금 실패 — 오늘까지 내지 않으면 연체돼요. 결제 금액을 내주세요."

정책 안내: "플랜을 변경하면 기존 구독이 해지돼요. 이 때 이번 달 말까지의 요금을 정산해야 해요."

3. 사용자 안심

수동형 문장으로 쓰면 정보 수집 안내 등 민감한 상황에서 사용자를 안심하게 할 수 있어요.

"상담이 끝나면 상담사도 회원님의 정보를 볼 수 없어요"

"회원님의 정보가 기록되지 않아요"

"이제부터 회원님의 개인정보 이용 내역이 기록돼요"

"더 좋은 상담을 위해 통화 내용은 녹음돼요"

4. '되어요' → '돼요'

모바일 화면의 좁은 공간을 고려하여 '돼요'로 통일해요.

경어를 써도 되는 경우

특정 상황에서 제한적으로 '~시나요?', '~셨나요?' 의문형 어미를 쓸 수 있어요.

1. 사용자의 맥락을 활용해서 질문할 때

'~시나요?', '~셨나요?' 형태의 경어를 활용해서 사용자의 당황스러움을 줄일 수 있어요.

"회원님, 강남점 다녀오셨나요? 매장에서 5% 할인 쿠폰을 보냈어요."

"정기 배송 변경하러 설정 가시나요? 앱에서 바로 변경할 수 있어요."

2. 사용자의 상황을 추정할 때

명확한 정보가 없어 사용자에게 직접 판단하게 해야 할 때 경어로 정중하게 질문할 수 있어요.

"상품을 받으셨나요? 후기를 남기면 포인트를 받을 수 있어요."

3. 사용자의 선의가 필요할 때

설문조사처럼 사용자의 선의를 기대해야 할 때 경어로 정중하게 질문해요.

"이번 달에 서비스를 쓰면서 얼마나 만족하셨나요?"

부정형 문장을 써도 되는 경우

사용자에게 명확하게 부정적인 내용을 알려줘야 할 때는 부정형 문장을 써도 좋아요.

1. 서비스를 정책 상 쓸 수 없을 때

부정형 문장으로 써야 사용자에게 상황을 명확하게 인지시킬 수 있어요. 쓸 수 없는 이유를 함께 안내해주세요.

"지금은 가입할 수 없어요 — 청소년을 위한 서비스는 아직 준비 중이에요."

"해외에서는 이 기능을 사용할 수 없어요 — 국내 법률에 따라 접근이 제한돼요."

2. 일부 기능만 쓸 수 없을 때

부정형 문장으로 써야 어떤 기능을 쓸 수 없는지 명확하게 인지시킬 수 있어요. 사용자 선택의 결과를 명확하게 안내할 수 있어요.

"프리미엄 혜택을 포인트로 받을까요? 한 번 바꾸면 기존 혜택은 다시 받을 수 없어요."

"시스템 점검 예정이에요. 점검 시간 동안 데이터를 내보내거나 동기화할 수 없어요."

3. 사용자 안심

부정형 문장으로 써야 정보 수집 안내 등 민감한 상황에서 사용자를 안심하게 할 수 있어요.

"상담이 끝나면 상담사도 회원님의 정보를 볼 수 없어요"

"회원님의 정보가 기록되지 않아요"


검수 체크리스트

문구를 검수할 때 다음 순서로 확인해요:

  1. 해요체인가? — '합니다', '습니다' 등 하십시오체가 아닌지 확인
  2. 능동형인가? — '됐어요'를 '했어요'로, 수동형을 능동형으로 바꿀 수 있는지 확인
  3. 긍정형인가? — '없어요', '못해요' 등 부정형을 긍정형으로 바꿀 수 있는지 확인
  4. 캐주얼한가? — '~시', '께', '여쭈다' 등 과도한 경어가 없는지 확인
  5. 명사 조합이 아닌가? — 한자어 명사 나열을 동사로 풀어쓸 수 있는지 확인
  6. 예외에 해당하는가? — 위 원칙의 예외 상황인지 확인

출력 형식

문구를 교정할 때는 다음 형식으로 출력해요:

원문: [원래 문구]
교정: [교정된 문구]
적용 규칙: [적용한 규칙 번호와 이름]

여러 문구를 한번에 검수할 때는 표 형식을 사용해요:

원문교정적용 규칙
.........

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.