시작하기
power-ux-harness는 AI 코딩 에이전트에 설치해 쓰는 UX 스킬 11개입니다. 설치한 뒤 필요한 스킬을 말이나 @별칭으로 부르면 됩니다.
Claude Code에 설치
Codex · Cursor · Gemini CLI · GitHub Copilot에 설치
프로젝트 폴더에서 실행하면 .agents/skills에 11개를
설치해요. Node.js 22 이상이 필요해요.
일부만 설치
.agents/skills와 .claude/skills 둘 다
스킬 목록 보기
복사만 해도 돼요. skills/<id> 폴더를 쓰는
에이전트의 스킬 폴더로 옮기면 됩니다. 폴더 하나만으로 동작해요.
부르는 법
그냥 말하기
「온보딩에서 사용자가 헤매는 것 같아」처럼 말하면 맞는 스킬이 켜져요.
@별칭으로 집기
@ux review 로그인 화면처럼 별칭 뒤에 대상을
적으면 그 스킬이 확실하게 켜져요. 별칭은 아래
별칭에 모았어요.
설치 확인 · 업데이트
설치 확인
@ux review 로그인 화면처럼 불러서 스킬이
응답하는지 보세요. npx로 설치했다면 프로젝트의
.agents/skills(--tool both면
.claude/skills도)에 ux-… 폴더가
생겨요.
업데이트
npx로 설치했다면 같은 명령을 다시 실행해요.
같은 파일은 건너뛰어요. 같은 이름인데 내용이 다른 스킬(직접
고친 것 포함)은 폴더째 건너뛰고 충돌로 알려 주며,
--force를 붙여야 덮어써요.
--dry-run을 붙이면 할 일만 먼저 보여 줘요.
상황별 찾기
지금 상황을 고르면 맞는 스킬이 펼쳐집니다.
스킬 11개
이름을 누르면 언제 쓰는지, 부르는 법, 준비할 것, 내는 것, 예시 요청, 헷갈리는 짝, 고치기 전 · 후, 데모가 펼쳐집니다.
찾는 항목이 없습니다. 다른 단어로 검색해 보세요.
실전 순서
자주 하는 일 다섯 가지를 이렇게 이어서 부릅니다. 모든 스킬이 같은 어휘를 써서 한 스킬의 결과를 다음 스킬이 그대로 받아요. 필요한 스킬 하나만 불러도 됩니다.
헷갈리는 짝
비슷해 보이는 두 스킬은 이 기준으로 고릅니다.
별칭 한눈에 보기
@로 시작하는 별칭을 쓰면 해당 스킬이 확실하게 발동합니다.
| 스킬 | 별칭 | 한 줄 설명 |
|---|
같은 어휘
모든 스킬이 이 말을 같은 뜻으로 써서, 한 스킬의 결과를 다음 스킬이 그대로 받습니다.
| 어휘 | 뜻 |
|---|
문제 해결
자주 막히는 일과 풀어 가는 방법입니다.
스킬이 발동하지 않아요
@별칭으로 불러 보세요. @ux review 로그인 화면처럼
별칭 뒤에 대상을 적으면 그 스킬이 확실하게 켜집니다. 스킬별
별칭은 별칭에 있어요.
npx로 설치했다면 스킬은 설치한 프로젝트의
.agents/skills에 있어요. 그 프로젝트에서
에이전트를 열었는지 확인하세요.
결과가 뻔하고 일반적이에요
서비스 설명이나 주소, 기획서를 함께 주세요.
ux-benchmark는 서비스 설명 · 주소 · 기획서 · 화면에서
맥락을 읽고, ux-simulate는 링크 · 기획서 · 화면 ·
데이터 파일을 열어 읽어요.
맥락을 읽지 못한 칸은 가정으로 적고 진행해요. 대상 사용자 · 규모 · 기기 · 제약처럼 결과를 뒤집을 사실을 요청에 적으면 가정이 줄어요. 스킬마다 받는 입력은 각 스킬의 「준비할 것」에 있어요.
결과에 NOT_CHECKED · BLOCKED · hypothesis가 있어요
열지 못했거나 확인하지 못한 항목은 NOT_CHECKED로,
환경 · 권한 때문에 확인하지 못했다면 BLOCKED로
남겨요. ux-simulate의 합성 결과는 언제나
hypothesis이고, 실제 사용자 검증 계획이 함께
나옵니다. 뜻은 같은 어휘에 있어요.
열 수 있는 주소 · 스크린샷 · 파일을 함께 주면 확인하지 못한 항목을 줄일 수 있어요.
일부 스킬만 설치하고 싶어요
--only 뒤에 스킬 이름을 쉼표로 이어요.
skills/<id> 폴더를 에이전트의 스킬 폴더로
직접 복사해도 돼요.
업데이트하고 싶어요
npx로 설치했다면 같은 명령을 다시 실행해요. 같은
파일은 건너뛰고, 내용이 다른 스킬(직접 고친 것 포함)은 폴더째
건너뛰고 충돌로 알려 줘요. --force 없이는
덮어쓰지 않아요. --dry-run으로 할 일만 먼저 볼 수
있어요.
다른 에이전트에서도 쓰고 싶어요
Codex · Cursor · Gemini CLI · GitHub Copilot은
npx 한 줄로 .agents/skills에
설치해요. .claude/skills에도 두려면
--tool both를 붙입니다.
그 밖의 에이전트는 skills/<id> 폴더를 스킬
폴더로 복사하세요.