사용 가이드로 건너뛰기
ux-copy작성자 Anthropic

UX Copy 스킬.

UX 카피를 작성하거나 검토하는 Claude Code 및 Codex 스킬입니다: 마이크로카피, 오류 메시지, 빈 상태, CTA.

  • UX 및 리서치
anthropics/knowledge-work-plugins · design/skills/ux-copy/SKILL.mdSKILL.md
--- name: ux-copy description: Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text. --- ## Usage ## What I Need From You ## Principles ## Copy Patterns ## Voice and Tone ## Output
2026-09-14에 업스트림 파일에서 읽은 전문 및 섹션 제목 · 전체 3,424자

01 기능

ux-copy 스킬이 Claude Code와 Codex에서 수행하는 작업

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

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

스킬 자체의 표현으로

인터페이스 텍스트 작성 및 검토 작업입니다: 마이크로카피, 오류 메시지, 빈 상태, CTA, 확인 대화상자, 툴팁, 로딩 상태, 온보딩을 다룹니다. 화면 또는 플로우, 사용자가 하려는 일과 느끼는 감정, 톤, 글자 수 제한을 제공하면, 요소별 추천 문구와 톤 및 활용 상황이 표시된 세 가지 대안, 근거, 로컬라이제이션 노트를 반환합니다.

이것이 구체적인 이유는 자유로운 제안이 아니라 고정된 구조를 적용한다는 점입니다: 오류는 발생한 일 더하기 이유 더하기 해결 방법으로, 빈 상태는 이것이 무엇인지 더하기 비어 있는 이유 더하기 시작 방법으로, 대화상자는 동작과 그 결과를 명시하는 방식으로 구성됩니다. 커넥터를 사용하면 브랜드 보이스를 가져오거나 Figma에서 플로우를 읽을 수 있습니다.

산출물

  • 화면의 각 명명된 요소에 대한 추천 문구
  • A, B, C 옵션의 대안 표로, 각각 톤과 사용 시점이 표시됩니다
  • 해당 사용자 맥락에서 카피가 효과적인 이유를 설명하는 간단한 근거
  • 피해야 할 관용구, 글자 수 확장, 문화적 맥락을 표시하는 로컬라이제이션 노트
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    먼저 맥락을 수집합니다

    작성에 앞서 화면, 플로우 또는 기능과 그 순간 사용자가 하려는 일 및 느끼는 감정을 묻습니다.

  2. 02
    카피를 다섯 가지 원칙에 따라 검토합니다

    명확함, 간결함, 일관성, 유용함, 인간적임은 제안되는 모든 문구가 통과해야 하는 필터입니다.

  3. 03
    요소를 해당 패턴에 맞춥니다

    CTA, 오류 메시지, 빈 상태, 확인 대화상자, 툴팁, 로딩 상태, 온보딩은 각각 카피 패턴 섹션에 고유한 규칙을 가지고 있습니다.

  4. 04
    상황에 맞게 톤을 조정합니다

    성공, 오류, 경고, 중립 상태는 하나의 하우스 보이스가 아니라 각각 다른 어조로 표현됩니다.

  5. 05
    템플릿화된 결과를 반환합니다

    요소별 추천 카피, 세 가지 옵션이 담긴 대안 표, 근거, 번역가를 위한 로컬라이제이션 노트가 제공됩니다.

02 적합성 확인

ux-copy Skill을 사용해야 하는 경우

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

적합한 경우

  • CTA 이름 짓기, 확인 대화상자 문구 작성, 빈 상태 채우기, 온보딩 텍스트 작성
  • 평이한 언어로 다시 써야 하는 결제 실패 오류: "결제가 거부되었습니다. 카드가 은행에 의해 거부되었습니다.
  • 이미 브랜드 보이스 가이드가 문서화되어 있는 제품으로, 카피를 그에 맞출 수 있습니다
  • Figma에서 디자인 중인 화면으로, 플로우와 레이아웃 제약이 보입니다
  • 번역이 필요하고 관용구, 확장, 문화적 맥락에 대한 노트가 필요한 모든 문구

한계 인지하기

  • 맥락을 추측하지 않습니다: 화면 또는 플로우, 사용자 상태, 톤, 제약 조건을 직접 제공해야 합니다.
  • 브랜드 보이스 조회와 Figma 화면 맥락은 해당 커넥터가 실제로 연결되어 있을 때만 작동합니다.
  • 툴팁은 구조나 예시 없이 한 줄의 안내만 제공됩니다.

제공할 사항

  • 어조격식체, 친근함, 유쾌함 또는 안심시키는 톤, 혹은 브랜드 보이스에 대한 설명입니다.
  • 제약 조건문구를 제한하는 글자 수 제한과 플랫폼 가이드라인입니다.
  • 검토하는 경우, 카피 자체실행 시에는 작성 기준이 되는 컨텍스트 또는 검토할 카피 중 하나를 입력으로 받습니다.

03 스킬 내부

ux-copy 스킬이 Claude Code와 Codex에 제공하는 규칙

SKILL.md가 에이전트를 위해 설정하는 7가지 구체적 지침, 기본값, 한도 — 결과를 바꾸는 파일의 부분

  1. 오류 메시지는 세 부분으로 구성됩니다

    무슨 일이 일어났는지, 왜 일어났는지, 어떻게 해결하는지의 순서로 구성합니다.

  2. 빈 상태는 세 부분으로 구성됩니다

    이것이 무엇인지, 왜 비어 있는지, 어떻게 시작하는지를 말합니다.

  3. 확인 대화상자에서 동작을 명시합니다

    제목에서 실제 질문을 던집니다. 예를 들어 일반적인 "정말 진행하시겠습니까?" 대신 "파일 3개를 삭제하시겠습니까?"라고 씁니다.

  4. 버튼에는 동작을 라벨로 사용합니다

    버튼에는 "확인"/"취소" 대신 "파일 삭제"/"파일 유지"처럼 실제 동작을 나타내는 동사를 사용합니다.

  5. CTA는 동사로 시작합니다

    라벨을 동사로 시작하고 구체적으로 작성하여 결과가 라벨과 일치하도록 합니다. "제출"이 아니라 "계정 만들기"처럼 작성합니다.

  6. 하나의 대상에는 하나의 용어

    인터페이스 전체에서 같은 개념에는 항상 같은 단어를 사용합니다.

  7. 온보딩은 한 번에 하나의 개념씩 소개합니다

    온보딩 카피는 처음부터 모든 것을 설명하기보다 점진적 노출 방식을 사용합니다.

04 활용하기

Claude Code 또는 Codex에 ux-copy 설치

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

Claude Code, Codex 또는 사용자 에이전트에 ux-copy 추가

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

Terminal
npx skills add https://github.com/anthropics/knowledge-work-plugins --skill ux-copy

design/skills/ux-copy/SKILL.md를 위한 일반적인 skills CLI 형식입니다. 저장소마다 자체 경로를 문서화할 수 있습니다.

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

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

Starter prompt
Write copy for the [checkout] screen. The user just tried to pay and their card was declined, so they are frustrated and need to know what to do next. Tone should be empathetic but not wordy, and the retry button has a [20] character limit on [iOS].

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

첫 번째 결과 확인

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

  • 각 줄의 단어 수를 확인합니다. 의미를 온전히 전달하면서 가장 짧은 버전이 최선입니다.
  • 각 단어가 사용자의 목표 달성에 도움이 되는지 확인합니다.
  • 로딩 문구가 단순히 회전만 하는 것이 아니라 기대치를 설정하고 불안을 줄이는지 확인합니다.
  • 결과를 공유받은 브랜드 보이스와 비교하고 사용자의 감정 상태에 맞게 조정합니다.
  • 제공한 컨텍스트가 충분히 구체적이었는지 다시 확인합니다. 예를 들어 단순히 "오류 메시지"라고 하지 않고 실패 조건을 명시했는지 확인합니다.

OpenDesign에서 ux-copy를 SKILL.md 링크에서 임포트합니다: Plugins → Add → Skill → Import from link, 그런 다음 상단 바에서 선택합니다.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

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

Author
Anthropic
스킬 파일
design/skills/ux-copy/SKILL.md 검증 시 기록된 콘텐츠 체크섬, 커밋 8f877b6
License
Apache-2.0 LICENSE에서 확인
리포지토리 스타
24,012 anthropics/knowledge-work-plugins 리포지토리 전체에 대해 2026-09-14에 수집한 GitHub 스냅샷이며, 이 카탈로그에는 7개의 스킬이 포함되어 있습니다. ux-copy에 대한 평가나 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 스타 수가 확인되었습니다. OpenDesign 메인에 번들로 포함되지 않음(2026-08-28 확인); 이 페이지에 실제 실행 기록이 없습니다.

SKILL.md 내부

  1. 사용법호출 방법: 컨텍스트나 카피를 인자로 받는 슬래시 명령
  2. 필요한 입력값제공해야 할 네 가지 입력: 컨텍스트, 사용자 상태, 톤, 제약 조건
  3. 원칙모든 문구가 갖춰야 할 다섯 가지 특성: 명확함, 간결함, 일관성, 유용함, 인간적임
  4. 카피 패턴CTA, 오류, 빈 상태, 다이얼로그, 툴팁, 로딩, 온보딩에 대한 요소별 규칙
  5. 보이스와 톤성공, 오류, 경고, 중립 상황에 따라 톤이 어떻게 달라지는지
  6. 출력마크다운 템플릿: 권장 카피, 대안 표, 근거, 로컬라이제이션 참고사항
  7. 커넥터 사용 가능 시연결된 지식 베이스나 디자인 도구가 카피에 추가하는 것
  8. 팁컨텍스트를 구체적으로 명시하고, 브랜드 보이스를 공유하며, 감정 상태를 고려하십시오
스킬 자체 설명
"UX 카피 작성 또는 검토 — 마이크로카피, 오류 메시지, 빈 상태, CTA. "write copy for", "what should this button say?", "review this error message"로 트리거되거나 CTA 이름 지정, 확인 대화 상자 문구 작성, 빈 상태 채우기, 온보딩 텍스트 작성 시 사용됩니다."

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

06 설치하기 전에

ux-copy 스킬에 대한 질문

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

기존 브랜드 보이스를 그냥 사용할 수 있나요?

지식 베이스 커넥터가 연결된 경우에만 가능하며, 이 경우 브랜드 보이스 가이드라인과 콘텐츠 스타일 가이드를 가져오고 기존 카피 패턴과 용어를 확인합니다. 그렇지 않으면 요청에서 보이스를 직접 설명해야 합니다.

정확히 무엇이 반환되나요?

컨텍스트가 포함된 'UX Copy'라는 제목의 마크다운 블록, 요소별 권장 문구, 톤과 적합한 용도가 태그된 세 가지 대안 표, 근거, 그리고 번역가를 위한 로컬라이제이션 참고사항입니다.

실제 화면을 볼 수 있나요?

디자인 도구 커넥터가 연결된 경우 Figma에서 화면 컨텍스트를 확인해 전체 사용자 흐름을 파악하고, 디자인에서 문자 수 제한과 레이아웃 제약을 확인합니다. 그렇지 않으면 흐름을 말로 설명해야 합니다.

UX Copy

실제 UX 리서치 작업에서 ux-copy 실행하기

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

터미널
npx skills add https://github.com/anthropics/knowledge-work-plugins --skill ux-copy

OpenDesign 데스크톱

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

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

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

macOS, Windows 지원