본문으로 건너뛰기

UI 개선 스킬

입증된 디자인 근거로 제품의 한 화면을 감사하고 선택한 구현 계획을 작성합니다.

커뮤니티 · ibelick
작성자ibelick
라이선스MIT
소스ibelick/ui-skills · GitHub의 SKILL.md
프로젝트 웹사이트www.ui-skills.com
작동 환경Claude Code · Codex, Gemini CLI, Cursor, Copilot
소스 확인 날짜

improve-ui는 선택한 화면에 실제로 적용되는 디자인 결정에 따라 기존 인터페이스를 감사합니다.

제품 소스는 읽기 전용입니다. 발견 사항에는 규약, 실행 근거와 수정 근거가 필요하며 최대 세 건만 보고합니다. 사용자가 선택한 변경에 대해서만 계획을 작성합니다.

스킬의 SKILL.md에서: # Improve UI

ibelick의 커뮤니티 스킬로, 저희나 Anthropic이 검토하지 않았습니다. 스킬은 에이전트에게 코드 실행, 파일 읽기, 네트워크 호출을 지시할 수 있습니다. 설치하기 전에 SKILL.md와 폴더 안의 모든 스크립트를 읽고, 설명과 맞지 않는 동작이 없는지 확인하세요.

하는 일

  1. 경로, 구성 요소와 최종 스타일을 따라 일관된 화면 하나를 추적합니다.
  2. 각 후보를 보고하기 전에 입증하고 반증을 시도합니다.
  3. 선택한 발견 사항의 독립적인 계획을 design-plans에 작성합니다.

얻을 수 있는 결과물

  • 디자인 언어의 근거와 입증된 발견 사항 최대 세 건.
  • 다른 실행자가 쓸 수 있는 선택한 구현 계획.

이럴 때 사용하세요

  • 기존 제품의 정체성을 바꾸지 않고 디자인 이탈을 검토합니다.
  • 소스에 근거한 디자인 인계 자료를 준비합니다.

이럴 때는 맞지 않습니다

  • 이 감사가 변경을 구현하거나 기능과 접근성 문제를 자동으로 포함한다고 기대하는 경우.

필요한 것

  • 관련 소스와 적용되는 디자인 문서에 대한 읽기 권한.
  • 제공되거나 명시적으로 요청한 경우에만 렌더링 근거를 사용하며 필수 MCP 서비스나 패키지는 없습니다.

스킬에 들어 있는 파일

파일 또는 폴더용도
SKILL.md근거 요건, 범위 경계와 보고서 구조.

2026-11-17 기준 저장소에 있는 라이선스: MIT.

예시 프롬프트

설치한 뒤 아래 중 하나를 입력해 보세요. 스킬 이름을 넣으면 그 스킬이 확실히 사용됩니다.

  • 이 결제 화면을 현재 토큰과 비교해 감사하되 제품 소스를 변경하지 마세요.
  • 변경을 권하기 전에 이 UI 발견 사항을 반증해 보세요.
  • 내가 선택한 발견 사항을 design-plans의 독립적인 계획으로 작성하세요.

improve-ui 설치 방법

읽기 전용 감사

단일 스킬 폴더를 복사하세요. 선택적인 UI Skills 레지스트리 MCP는 검색 서비스이며 실행 요건이 아닙니다.

요청하지 않은 접근성 및 의미 구조 문제는 제외합니다. 그것이 과제라면 별도 접근성 검토를 수행하세요.

스킬은 SKILL.md 파일이 든 폴더입니다. 한 번만 설치하면, 에이전트가 세션을 시작할 때마다 짧은 설명을 읽고 요청이 맞을 때만 전체 지침을 불러옵니다. 사용하는 곳을 고르세요.

Claude Code: 스킬 폴더에 복사

이 컴퓨터의 모든 프로젝트에서 쓰려면 스킬 폴더를 ~/.claude/skills/에 넣고, 저장소에서 함께 작업하는 모든 사람과 공유하려면 저장소 안의 .claude/skills/에 넣으세요(커밋하세요).

git clone --depth 1 https://github.com/ibelick/ui-skills.git
mkdir -p ~/.claude/skills
cp -R ui-skills/skills/improve-ui ~/.claude/skills/

Claude Code는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /improve-ui를 입력하거나 작업을 설명하면 됩니다.

Windows에서는 Git Bash나 WSL에서 명령어를 실행하거나, 파일 탐색기로 같은 위치에 폴더를 복사하세요.

Codex, Gemini CLI, Cursor, GitHub Copilot

이 에이전트들은 같은 SKILL.md 폴더를 읽습니다. 네 가지 모두가 프로젝트 안에서 인식하는 폴더는 .agents/skills/이므로, 아래 명령은 스킬을 그곳에 복사합니다.

git clone --depth 1 https://github.com/ibelick/ui-skills.git
mkdir -p .agents/skills
cp -R ui-skills/skills/improve-ui .agents/skills/
에이전트프로젝트 폴더사용자 폴더참고
OpenAI Codex
.agents/skills/
~/.agents/skills/
$를 입력하거나 /skills를 실행해 스킬을 고르세요. 작업이 맞으면 Codex가 스스로 스킬을 고르기도 합니다.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
또는 gemini skills install <git URL> --path <folder> --consent로 Git에서 설치하세요. Google은 2026년 6월 18일 무료 등급과 Google One 사용자의 Gemini CLI를 Antigravity CLI로 대체했습니다. Antigravity는 프로젝트에서는 .agents/skills/를, 사용자용으로는 ~/.gemini/config/skills/를 사용합니다.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Agent 채팅에서 /를 입력해 스킬을 고르세요. Cursor는 Claude Code의 .claude/skills/ 폴더도 읽습니다.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Copilot CLI, 클라우드 에이전트, 그리고 VS Code, Visual Studio, JetBrains의 에이전트 모드에서 작동합니다(IDE 지원은 버전에 따라 다름). 또는 gh skill install OWNER/REPOSITORY SKILL를 실행하세요(공개 프리뷰, GitHub CLI 2.90.0 이상).
신뢰할 수 있는 스킬만 설치하세요. Anthropic은 신뢰할 수 있는 출처의 스킬만 사용하고, 그 밖의 스킬은 사용하기 전에 모든 파일을 읽어 보라고 권합니다. 스킬은 설명에 나오지 않는 방식으로 에이전트에게 명령어 실행, 파일 읽기, 데이터 전송을 지시할 수 있기 때문입니다.

이 단계의 출처

2026-11-14에 각 업체의 문서와 대조해 확인했습니다:

재설계에 앞서는 근거

초안 디자인 제안이 현재 코드를 자동으로 규정하지는 않습니다. 감사는 선택한 화면의 기준 소스를 먼저 확인해야 합니다.

계획은 구현과 별개이며 이 대화 없이도 실행할 수 있도록 근거와 정확한 담당 소스를 담아야 합니다.

improve-ui에 관한 질문

구성 요소를 수정하나요?

아니요. 제품 소스는 읽기 전용이며 허용되는 계획 파일은 design-plans에 둡니다.

반복만으로 결함을 입증할 수 있나요?

아니요. 각 발견 사항에는 구속력 있는 규약, 실행 근거와 결정적인 수정 방법 하나가 필요합니다.

항상 세 가지 문제를 찾나요?

아니요. 세 건은 최댓값이며 입증된 발견 사항이 없어도 유효한 결과입니다.

스크린샷을 자동으로 검사하나요?

렌더링 근거를 제공하거나 시각 검사를 명시적으로 요청한 경우에만 수행합니다.

더 많은 AI 스킬

관련 스킬

스킬 카테고리