toss-ux-writing

📁 narip/toss-ux-writing-skills 📅 7 days ago
4
总安装量
4
周安装量
#52285
全站排名
安装命令
npx skills add https://github.com/narip/toss-ux-writing-skills --skill toss-ux-writing

Agent 安装分布

opencode 3
gemini-cli 3
claude-code 3
github-copilot 3
codex 3
kimi-cli 3

Skill 文档

토스 UX 라이팅 가이드

토스 앱인토스(Apps in Toss) UX 라이팅 가이드를 기반으로 제품 문구를 검수하고 교정하는 스킬입니다.

출처: https://developers-apps-in-toss.toss.im/design/ux-writing.html

사용 시기

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

핵심 원칙 5가지

1. 해요체 사용

제품 안의 모든 문구는 ‘해요체’로 작성합니다. 상황과 맥락을 불문하고 이 규칙을 지킵니다.

X O
충전금을 송금합니다 충전금을 송금해요
포인트가 적립되었습니다 포인트가 적립됐어요

2. 능동적 말하기

수동형 표현을 능동형으로 바꿉니다. 최대한 능동형 문장을 사용합니다.

‘됐어요’ → ‘했어요’

X O
송금이 완료됐어요 송금했어요
결제가 취소됐어요 결제를 취소했어요

‘~었’ 빼기

과거형 어미를 제거하여 더 직접적으로 표현합니다.

X O
선택된 계좌 선택한 계좌
등록된 카드 등록한 카드

동사 바꿔쓰기

더 능동적인 동사로 전환합니다.

X O
혜택이 주어져요 혜택을 받아요
알림이 발송돼요 알림을 보내요

3. 긍정적 말하기

부정적 커뮤니케이션을 최소화하고 긍정형 문장을 우선 사용합니다.

‘없어요’ → ‘있어요’

X O
사용할 수 있는 쿠폰이 없어요 쿠폰이 생기면 알려드릴게요
잔액이 부족해요 3,000원을 더 충전하면 결제할 수 있어요

에러 메시지도 긍정적으로

사용자 입장에서 해결 방법을 제시합니다.

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

혜택 대상 안내

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

X O
신규 가입자만 받을 수 없어요 기존 회원도 받을 수 있어요

4. 캐주얼한 경어

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

동사에서 ‘~시’ 빼기

X O
확인하세요 확인해요
선택하세요 선택해요

‘계시다’ → ‘있다’

X O
고객님이 계시면 고객님이 있으면

‘여쭈다’ → ‘확인하다, 묻다’

X O
몇 가지 여쭤볼게요 몇 가지 확인할게요

‘께’ → ‘에게’

X O
고객님께 안내드려요 고객님에게 안내해요

경어를 뺐을 때 어색한 경우

파악하고 싶은 정보를 ‘주어’로 써서 문장을 재구성합니다.

X O
이 주소가 맞으시나요? 이 주소가 맞나요?

5. ‘{명사} + {명사}’ 쓰지 않기

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

한자어 풀어쓰기

X O
본인 인증 실패 본인 인증을 하지 못했어요
계좌 등록 완료 계좌를 등록했어요

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

‘{명사}가 {명사}해서’ 형태로 최소한 풀어씁니다.

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

예외 규칙

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

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

주어(종료 서비스, 기간 등)를 강조해야 할 때. ‘종료’와 ‘만료’의 뉘앙스를 정확히 전달해야 할 때.

  • 단, 주기적 반복 제품에서는 ‘종료돼요’ 사용 금지

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

주요 동사: 연체, 해지, 적용 등. 인과 관계를 명확하게 설명하고, “사용자 행동의 ê²°ê³¼”임을 명시해야 할 때.

3. 사용자 안심

정보 수집 안내 등 민감한 상황에서 사용자를 안심시켜야 할 때.

4. ‘되어요’ → ‘돼요’

모바일 화면의 좁은 공간을 고려하여 ‘돼요’로 통일합니다.

경어를 써도 되는 경우

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

‘~시나요?’, ‘~셨나요?’ 의문형 어미를 사용하여 사용자의 당황스러움을 줄일 수 있습니다.

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

토스에 명확한 정보가 없어 사용자의 직접 판단이 필요할 때, 정중한 톤을 사용합니다.

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

설문조사 등 협력 요청 상황에서 경어로 정중하게 질문합니다.

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

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

사용자에게 상황을 명확히 인지시키고, 쓸 수 없는 이유를 함께 안내합니다.

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

어떤 기능을 쓸 수 없는지 명확히 안내하고, 사용자 선택의 결과를 명확히 전달합니다.

3. 사용자 안심

정보 수집 안내 등 민감한 상황에서 사용자를 안심시켜야 할 때.


검수 체크리스트

문구를 검수할 때 다음 순서로 확인합니다:

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

출력 형식

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

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

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

원문 교정 적용 규칙