사용 가이드로 건너뛰기
ux-writing작성자 content-designer

UX Writing 스킬.

UX 리서치를 위한 Claude Code 및 Codex 스킬입니다: 사용자 중심의 접근성 높은 마이크로카피: 버튼, 레이블, 오류, 폼, 온보딩.

  • UX 및 리서치
content-designer/ux-writing-skill · SKILL.mdSKILL.md
--- name: ux-writing description: Create user-centered, accessible interface copy (microcopy) for digital products including buttons, labels, error messages, notifications, forms, onboarding, empty states, success messages, and help text. Use when writing or editing any text that appears in apps, websites, or software interfaces, designing conversational flows, establishing voice and tone guidelines, auditing product content for consistency and … --- ## When to Use This Skill ## Core UX Writing Principles ## UX Text Patterns ## Voice and Tone ## Editing Process ## Workflow
2026-09-14에 업스트림 파일에서 읽은 전문 및 섹션 제목 · 전체 15,313자

01 기능

Claude Code와 Codex에서 ux-writing 스킬이 하는 일

요약, 워크플로, 산출물을 모두 해당 스킬의 SKILL.md에서 그대로 읽어 정리한 내용입니다.

SKILL.md에서2026-09-14 읽음 · 실행 기록 아님

스킬 자체의 표현으로

디지털 제품의 마이크로카피 작성 및 편집을 위한 실무 가이드입니다: 버튼, 레이블, 제목, 오류 메시지, 알림, 폼, 온보딩, 빈 상태, 성공 메시지, 도움말 텍스트를 다룹니다. 모든 문구는 목적성, 간결성, 대화성, 명료성이라는 네 가지 품질 기준으로 평가되며, 각 요소 유형에는 버튼의 [동사] [목적어], [실패한 것]과 같은 패턴이 있습니다.

오류의 경우 [이유/맥락]. [해야 할 일]. 보이스는 고정된 브랜드 개성으로 취급되며, 톤은 좌절, 혼란, 자신감, 신중함, 성공한 사용자에 따라 달라집니다. 이 스킬은 접근성 규칙, 연구에 기반한 문장 및 글자 수 기준, 4단계 편집 프로세스, 보이스 차트·콘텐츠 사용성·Figma MCP에 대한 참조 파일을 추가합니다.

산출물

  • 버튼, 레이블, 오류 메시지, 알림, 폼 및 관련 요소에 걸친 인터페이스 문구 자체입니다.
  • references/voice-chart-template.md로 작성된 제품 보이스 차트로, 브랜드 개념을 보이스 특성과 해도 되는 것/하지 말아야 할 것의 예시에 매핑합니다.
  • templates/error-message-template.md 템플릿, 즉 효과적인 오류 메시지를 위한 채워 넣을 수 있는 템플릿으로 작성된 오류 메시지입니다.
  • templates/onboarding-flow-template.md에서 설계된 온보딩 흐름으로, 명확한 온보딩 경험을 위한 프레임워크입니다.
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    컨텍스트에서 시작하기

    첫 번째 단계는 초안 작성을 시작하기 전에 사용자 목표, 비즈니스 목표, 기술적 제약과 사용자의 감정 상태를 이해하는 것입니다.

  2. 02
    말하듯이 초안 작성하기

    먼저 소리 내어 말할 내용을 생각하고, 해당 요소의 패턴을 적용하고, 어조와 톤을 저울질한 뒤, 중요한 정보를 앞에 배치합니다.

  3. 03
    정해진 순서로 네 차례 편집하기

    이 파일은 순서대로 진행되는 네 단계를 규정합니다: 목적성, 간결성, 대화성, 명료성이며 각 단계마다 고유한 점검 질문이 있습니다.

  4. 04
    상황에 맞게 톤 맞추기

    톤은 사용자의 감정 상태 — 답답함, 혼란, 자신감, 신중함, 성취감 — 에 따라 조정되지만 보이스는 일정하게 유지됩니다.

  5. 05
    테스트하고 측정하기

    팀과 함께 검토하고 가능하면 사용자와 테스트한 다음, 의견보다는 작업 완료율과 이해도를 측정합니다.

02 적합성 확인

ux-writing Skill 사용 시점

이러한 종류의 UX 리서치 작업일 때 Claude Code 또는 Codex에서 ux-writing skill을 사용합니다. 적합성과 한계는 skill 자체 파일에서 가져왔습니다.

적합한 경우

  • 버튼, 레이블, 제목, 메시지, 폼 등 인터페이스 요소를 위한 새로운 카피를 작성하는 작업입니다.
  • 이미 배포되었지만 가독성이 좋지 않은 기존 UX 텍스트를 편집하는 작업입니다.
  • 여러 화면에 걸쳐 제품 콘텐츠의 일관성과 사용성을 감사하는 작업입니다.
  • 설명과 복구 방법을 담은 오류, 알림, 성공 메시지를 작성하는 작업입니다.
  • 제품의 보이스와 톤을 정립하거나, 온보딩 및 대화형 흐름을 설계하는 작업입니다.

한계 인지하기

  • ChatGPT에서는 작동하지 않습니다 — 이 파일은 Codex CLI/IDE에서 실행되며 ChatGPT는 스킬을 설치하거나 사용할 수 없다고 명시합니다.
  • "문제가 발생했습니다" 같은 모호한 오류 설명은 피해야 할 사항으로 나열되어 있습니다.
  • 지나치게 재치 있는 유머는 진지한 상황에서는 적합하지 않습니다.

제공할 사항

  • 사용자의 감정 상태와 위험 수준톤은 사용자가 느끼는 감정과 위험 부담의 정도에 따라 선택됩니다 — 낮은 위험의 테마 변경은 계정 삭제와는 다르게 읽힙니다.
  • 접근성 제약어떤 요소에 시각적 맥락만으로 충분한지, 아니면 보조 기술을 위해 명시적 레이블과 ARIA 레이블이 필요한지 여부입니다.

03 스킬 내부

ux-writing 스킬이 Claude Code와 Codex에 부여하는 규칙

SKILL.md가 에이전트에게 설정하는 8가지 구체적인 지시, 기본값, 제한 — 결과를 바꾸는 파일의 부분입니다.

  1. 40~60자 길이의 줄

    인터페이스 텍스트 줄은 이 파일이 정한 최대 가독 범위인 40~60자로 작성해야 합니다.

  2. 버튼: 2-4단어

    버튼과 CTA 라벨은 2-4단어로 작성하며, 6단어를 절대적인 상한선으로 합니다.

  3. 대상에 맞는 쉬운 언어

    일반 독자에게는 중학교 1학년 수준, 전문적인 맥락에서는 고등학교 1학년 수준의 읽기 난이도로 작성합니다.

  4. 85%의 시간 동안 능동태 사용

    카피의 약 85%는 능동태로 작성해야 합니다.

  5. 오류는 고정된 순서를 따릅니다

    오류 카피는 무엇이 실패했는지, 그다음 이유나 맥락, 그다음 해야 할 일을 순서대로 명시합니다.

  6. 사용자를 절대 탓하지 않습니다

    오류 카피는 문제를 인정하되 읽는 사람을 탓하지 않습니다.

  7. 색상만으로 표현하지 않습니다

    의미는 절대 색상만으로 전달되지 않으며, 시각적 표시는 항상 텍스트와 함께 제공됩니다.

  8. 오류 메시지: 12-18단어

    해결 방법을 포함한 오류 메시지는 12단어에서 18단어 사이여야 합니다.

04 활용하기

Claude Code 또는 Codex에 ux-writing 설치

npx skills add 명령 한 번 실행 후, 에이전트에서 첫 번째 작업을 수행하고 결과 체크리스트를 확인합니다.

Claude Code, Codex 또는 사용 중인 Agent에 ux-writing 추가

프로젝트에서 실행합니다. 설치 프로그램이 어떤 에이전트에 추가할지 묻습니다.

Terminal
npx skills add https://github.com/content-designer/ux-writing-skill --skill ux-writing

SKILL.md를 위한 일반적인 skills CLI 형식이며, 저장소별로 자체 경로를 문서화할 수 있습니다.

스킬에 첫 UX 리서치 작업 제공

스킬 자체의 용어로 작성되었습니다. 대괄호 부분은 각자의 자료로 교체합니다.

Starter prompt
Write the microcopy for our [checkout] flow: the payment button label, the field labels, and the message a user sees when their card is declined. The user will be frustrated, so keep the tone empathetic and give a clear next step. Then run the four-phase edit and flag any line over 60 characters.

출처: 스킬 자체의 용어로 SKILL.md에서 작성했습니다.

첫 번째 결과 확인

SKILL.md 자체가 올바른 결과의 모습으로 제시하는 내용:

  • 카피를 소리 내어 읽고 실제로 그렇게 말할지 자문해 보세요.
  • 텍스트를 가독성 도구에 통과시키세요; 파일명은 Hemingway Editor와 Flesch-Kincaid 점수입니다.
  • 이해도 기준을 확인하세요: 8단어 이하는 100% 이해도, 14단어 이하는 90% 이해도를 나타냅니다.
  • UX 텍스트 품질 평가를 위해 제공된 체크리스트인 references/content-usability-checklist.md를 검토하세요.
  • 취향이 아니라 작업 완료율과 이해도를 측정하며, 팀과 함께 사용자 테스트 및 검토를 진행하세요.
  • 접근성을 위해, 오류와 필드 라벨이 스크린 리더에서 함께 안내되도록 구조가 잡혀 있는지 확인하세요.

OpenDesign에서 SKILL.md 링크로 ux-writing을 가져오세요: Plugins → Add → Skill → Import from link, 그다음 상단 바에서 선택합니다.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

이 페이지의 사실이 어디에서 왔으며 언제 마지막으로 확인되었는지 안내합니다.

스킬 파일
SKILL.md 검증 시 기록된 콘텐츠 체크섬; 커밋 98cacde
License
MIT LICENSE에서 확인
리포지토리 스타
168 content-designer/ux-writing-skill 리포지토리 전체에 대한 GitHub 스냅샷이 2026-09-14에 생성되었습니다. ux-writing에 대한 평점이나 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 스타 수가 확인되었습니다. OpenDesign 메인에 번들로 포함되지 않음(2026-08-28 확인); 이 페이지에 실제 실행 기록이 없습니다.

SKILL.md 내부

  1. 이 스킬을 사용해야 할 때여섯 가지 트리거: 인터페이스 카피 작성 또는 편집, 메시지, 대화형 흐름, 톤, 콘텐츠 감사.
  2. 핵심 UX 라이팅 원칙네 가지 품질 기준과 간결성, 명확성, 대화체 톤, 사용자 중심 관행.
  3. UX 텍스트 패턴제목, 버튼, 네 가지 오류 유형, 성공 메시지, 빈 상태, 양식, 알림에 대한 형식과 예시.
  4. 보이스와 톤일관된 보이스를 구축하고, 사용자의 감정 상태와 콘텐츠 유형에 따라 톤을 조정합니다.
  5. 편집 프로세스목적성, 간결성, 대화체, 명확성이라는 네 단계의 순차적 검토 과정이며, 각 단계마다 점검 질문이 있습니다.
  6. 워크플로맥락을 파악하고, 초안을 작성하고, 네 단계를 반복적으로 편집한 후 테스트하고 측정합니다.
  7. UX 라이팅에서의 접근성스크린 리더, 인지, 멀티모달, 쉬운 언어 요건을 나쁜 패턴과 좋은 패턴 예시와 함께 설명합니다.
  8. UX 텍스트 기준요소별 문장 및 글자 수 목표, 이해율, 읽기 수준과 테스트 도구입니다.
  9. 피해야 할 흔한 실수피동형 문장이나 일반적인 라벨부터 접근성이 낮은 링크 텍스트까지, 열한 가지 안티패턴입니다.
  10. 빠른 참조문장체 대소문자, 명령형 버튼, 사용자 중심, 구체적인 동사, 핵심 정보 앞배치에 관한 한 줄짜리 리마인더입니다.
  11. 리소스접근성 가이드, 보이스 차트, 사용성 체크리스트, 패턴 예시, 템플릿, Figma 연동을 포함한 아홉 개의 파일이 제공됩니다.
스킬 자체 설명
"버튼, 레이블, 오류 메시지, 알림, 양식, 온보딩, 빈 상태, 성공 메시지, 도움말 텍스트를 포함한 디지털 제품의 사용자 중심, 접근 가능한 인터페이스 카피(마이크로카피)를 작성합니다. 앱, 웹사이트 또는 소프트웨어 인터페이스에 표시되는 텍스트 작성 또는 편집, 대화형 플로우 설계, 보이스 및 톤 가이드라인 수립, 일관성과 사용성을 위한 제품 콘텐츠 감사, UI 문자열 검토 또는 기존 인터페이스 카피 개선 시 사용합니다. 목적성, 간결성, 대화성, 명확성이라는 네 가지 품질 기준에 기반한 UX 작성 모범 사례를 적용합니다. 접근성 가이드라인, 연구 기반 벤치마크(문장 길이, 이해율, 읽기 수준), 확장된 오류 패턴, 톤 적응 프레임워크, 종합 참조 자료를 포함합니다."

SKILL.md의 전문 설명입니다. 전체 파일은 약 15,313자입니다. GitHub에서 전체 파일 읽기.

06 설치하기 전에

ux-writing 스킬에 관한 질문

이 답변은 2026-09-14 기준으로 확인한 SKILL.md 내용을 근거로 하며, 실행 기록을 바탕으로 한 것이 아닙니다.

어떤 에이전트에서 이 스킬을 실행할 수 있나요?

Claude, Codex, Cursor를 비롯해 에이전트 스킬 사양을 지원하는 모든 에이전트를 위해 작성되었습니다. ChatGPT는 명시적으로 제외되며, 스킬을 설치하거나 사용할 수 없습니다.

이미 존재하는 카피에도 사용할 수 있나요?

네. 이 스킬은 처음부터 작성하는 것뿐 아니라 기존 UX 텍스트 편집, UI 문자열 검토, 일관성과 사용성을 위한 제품 콘텐츠 감사도 다룹니다.

접근성도 다루나요?

네. 접근성 있는 글쓰기는 별도의 섹션으로 다루며, 스크린 리더 최적화, 인지적 접근성, 멀티모달 소통, 쉬운 언어를 포함하고 WCAG AA 색상 대비 최소 기준인 4.5:1을 준수합니다.

UX Writing

실제 UX 연구 작업에서 ux-writing 실행

OpenDesign를 다운로드하고 SKILL.md 링크에서 ux-writing을 가져온 다음 위 프롬프트를 붙여넣고 결과 전에 계획을 읽으십시오.

터미널
npx skills add https://github.com/content-designer/ux-writing-skill --skill ux-writing

OpenDesign 데스크톱

하나의 디자인 시스템으로 모든 결과물에 브랜드 일관성을

완전한 Vibe Design Workspace에서 하나의 브랜드 규칙을 웹사이트, 슬라이드, 인터랙티브 프로토타입, 대시보드, 이미지, HTML 영상에 적용하세요. 로컬 Codex, Claude Code, Cursor 등을 연결해 무료로 제작할 수 있습니다.

  • 웹, 슬라이드, 프로토타입, 대시보드, 이미지, 영상
  • 140개+ 디자인 시스템과 전체 템플릿·스킬 라이브러리
  • 로컬 Codex 및 21개+ 코딩 에이전트 연결 · 무료
무료 다운로드

macOS, Windows 지원