clarify

개요

clarify 스킬이란?

clarify 스킬은 UI 및 UX 디자이너, 프론트엔드 개발자, 제품 팀이 불명확한 인터페이스 텍스트를 체계적으로 개선할 수 있도록 돕습니다. UX 카피, 오류 메시지, 마이크로카피, 라벨, 지침 등을 다듬어 디지털 제품을 더 이해하기 쉽고 사용하기 편하게 만듭니다. 사용자가 혼란스러운 라벨, 모호한 오류 메시지, 따라가기 어려운 지침 때문에 어려움을 겪는다면 clarify가 문제를 파악하고 해결하는 구조화된 방법을 제공합니다.

누가 clarify를 사용해야 하나요?

clarify는 인터페이스 디자인, UX 라이팅, 프론트엔드 개발을 담당하는 모든 분께 적합합니다. 혼란스러운 텍스트, 불명확한 라벨, 효과적이지 않은 오류 메시지에 대한 피드백을 받았을 때나 제품 커뮤니케이션의 명확성을 선제적으로 높이고 싶을 때 특히 유용합니다.

clarify가 해결하는 문제

• 불명확하거나 애매한 인터페이스 카피
• 사용자를 혼란스럽게 하는 기술 용어
• 사용자 복구에 도움이 되지 않는 오류 메시지
• 따라가기 어려운 지침
• UI 텍스트의 어조 불일치 또는 맥락 부족

사용법

설치 단계

1. 다음 명령어로 clarify를 설치하세요:

   npx skills add https://github.com/pbakaus/impeccable --skill clarify
   

2. clarify 스킬 디렉터리 내 SKILL.md 파일을 검토하며 시작하세요. 이 파일에는 워크플로우, 준비 단계, 인터페이스 카피 개선을 위한 모범 사례가 담겨 있습니다.

워크플로우 개요

• 필수 준비:

  • $frontend-design을 호출해 디자인 원칙과 컨텍스트 수집 프로토콜에 접근합니다.
  • 디자인 컨텍스트가 없으면 먼저 $teach-impeccable을 실행하세요.
  • 대상 청중의 기술 수준과 사용자 심리 상태에 관한 정보를 수집합니다.

• 현재 카피 평가:

  • 전문 용어, 애매함, 수동태, 길이, 가정, 맥락 누락, 어조 불일치 등 명확성 문제를 파악합니다.
  • 맥락을 이해합니다: 청중, 사용자 상태, 의도된 행동, 제약 조건.

• 계획 및 개선:

  • 각 명확성 문제를 체계적으로 해결합니다.
  • 사용자의 관점과 심리 상태를 고려해 카피를 다시 작성합니다.
  • 실제 사용자나 이해관계자와 함께 수정된 카피를 테스트합니다.

파일 구조 및 주요 자료

• 주요 워크플로우는 SKILL.md에서 시작하세요.
• 추가 컨텍스트는 설치 환경에 따라 README.md, AGENTS.md, 그리고 rules/, resources/, references/ 같은 지원 폴더에서 찾을 수 있습니다.

자주 묻는 질문

언제 clarify를 사용해야 하나요?

혼란스럽거나 애매한, 효과적이지 않은 인터페이스 텍스트를 만났을 때 또는 제품 커뮤니케이션의 명확성과 사용성을 선제적으로 개선하고 싶을 때 clarify를 사용하세요.

clarify는 어떤 종류의 카피에 도움이 되나요?

clarify는 UX 카피, 오류 메시지, 마이크로카피, 라벨, 지침 등 사용자 이해에 영향을 주는 모든 인터페이스 텍스트에 효과적입니다.

clarify를 사용하기 전에 디자인 컨텍스트가 필요한가요?

네. clarify 워크플로우는 변경하기 전에 디자인 컨텍스트를 수집하고 청중을 이해하는 과정을 요구합니다. 컨텍스트가 부족하면 SKILL.md에 안내된 준비 단계를 따르세요.

더 자세한 내용은 어디서 확인할 수 있나요?

스킬 디렉터리의 파일 탭을 열어 SKILL.md와 지원 스크립트, 참고 자료를 포함한 전체 파일 트리를 탐색하세요.