버튼·에러 메시지·온보딩 등 텍스트를 일관되게 작성하는 UX라이팅 스킬

1. 어떤 문제를 해결하나요?

디자인은 완성됐는데 버튼 텍스트가 결정이 안 됩니다. '확인'이냐 '저장'이냐 '완료'냐. 에러 메시지는 '오류가 발생했습니다'만 달랑 뜨고, 빈 상태 화면엔 아무 안내도 없습니다.

UI 텍스트는 작지만 사용자 경험에 큰 영향을 미칩니다. 애매한 버튼 라벨, 사용자를 탓하는 에러 메시지, 다음 행동을 안내하지 않는 시스템 메시지는 이탈률을 높이고 신뢰를 떨어뜨립니다.

microcopy 스킬은 브랜드 원칙(명확성·일관된 동사·행동 유도)에 따라 모든 UI 텍스트를 작성합니다. 한국어·영어 모두 지원하며, 고정 용어 사전과 실패·협업·대기 상황별 패턴이 내장되어 있습니다.

2. 이런 분들에게 추천합니다

• 버튼·라벨·플레이스홀더 텍스트를 결정해야 하는 UX 디자이너

• 에러 메시지·빈 상태·온보딩 문구를 작성하는 UX 라이터

• 글로벌 서비스의 한국어·영어 UI 텍스트를 일관되게 유지해야 하는 PO

• 디자인 시스템에 마이크로카피 가이드라인을 추가하려는 팀

• i18n 번역 시 브랜드 용어 일관성을 유지해야 하는 로컬라이제이션 담당자

3. 어떻게 사용하는 기어인가요?

작성해야 하는 UI 컴포넌트 유형(버튼·에러·빈 상태·온보딩 등)과 상황(성공·실패·대기·협업 등)을 설명하면 됩니다. 브랜드 원칙이나 기존 용어 사전이 있으면 함께 제공할 수 있으며, 없으면 스킬 내 기본 가이드라인이 적용됩니다.

4. 어떤 결과를 얻을 수 있나요?

• 브랜드 원칙에 맞는 버튼·라벨·플레이스홀더 문구

• 사용자를 탓하지 않고 다음 행동을 안내하는 에러 메시지

• 정보 80% + 따뜻함 20% 밸런스의 빈 상태·온보딩 텍스트

• '무엇이 일어났는지 → 왜 → 어떻게 해결하는지' 3단계 구조의 시스템 메시지

• 한국어·영어 양쪽 버전 동시 제공 (용어 대응표 포함)

5. 포함된 구성

• microcopy 스킬 소스 (SKILL.md)

• 고정 용어 사전 (한국어↔영어 18개 핵심 UI 용어)

• 브랜드 원칙 3가지 (Create / Collaborate / Evolve)

• 상황별 마이크로카피 패턴 (시작 / 대기 / 실패 / 협업)

• 에러 메시지 3단계 구조 가이드 (What / Why / Next)

• 인간적 따뜻함 밸런스 공식 (80/20 → 70/30 규칙)

• 한국어 마이크로카피 가이드 (microcopy-cn.md → 한국 적용 참고용)

• 영어 마이크로카피 가이드 (microcopy-en.md)

6. 사용 AI 도구

Claude Sonnet 4 (Anthropic) — LobeHub 오픈소스 마이크로카피 가이드라인 기반

7. 실제 활용 예시

• "파일 업로드 실패 에러 메시지 한국어/영어로 각각 써줘" → 3단계 구조 (원인·이유·해결 방법) 포함 양국어 버전 즉시 제공

• "처음 가입한 사용자에게 보여줄 빈 상태 화면 텍스트 만들어줘" → 따뜻함·명확성 밸런스 잡힌 온보딩 문구 + 행동 유도 CTA 제안

• "버튼 텍스트가 '확인'인데 더 명확하게 바꾸고 싶어" → 컨텍스트에 따른 3가지 대안 제시 (저장/완료/적용 등)

8. 출처, 원본 링크

• Author: lobehub

• Repository: lobehub/lobehub

• GitHub: https://github.com/lobehub/lobehub

• Skill file: https://github.com/lobehub/lobehub/tree/canary/.agents/skills/microcopy