스킬 · 디자인

애플 HIG 기준 화면 검수

애플 휴먼 인터페이스 가이드라인(HIG) 122장을 근거로, 이미 만들어 놓은 화면을 검사합니다. 플러터·리액트 네이티브·타우리·일렉트론·스위프트UI·UIKit·AppKit 을 모두 알아듣고, 애플의 용어를 그 프레임워크의 말로 바꿔 지적합니다. 접근성, 플랫폼 관례, 문구 표기까지 봅니다.

도도리 AI연구소 · 최종 수정 2026년 9월 11일 · CC BY-NC 4.0

디자인 분야 · 디자인·이미지 용도 · 개발자용입니다.

apple-design-skill 스킬 설치 한 줄

Claude Code 용입니다. Claude 데스크톱 앱의 채팅창이 아니라 컴퓨터의 터미널에 붙여 넣으십시오 — macOS 는 터미널, Windows 는 PowerShell 입니다. Node.js 가 깔려 있어야 하며, node -v 를 쳐서 버전이 나오면 준비된 것입니다.

뒤의 두 가지는 붙여 두시는 편이 좋습니다. -g 는 계정 전체에 넣는다는 뜻으로, 없으면 지금 열려 있는 폴더에만 깔려 다른 곳에서는 스킬이 보이지 않습니다. -a claude-code 는 Claude Code 에만 넣는다는 뜻입니다. 이걸 빼면 전역 설치를 지원하지 않는 다른 도구 때문에 빨간 Failed to install 이 뜨는데, 실제로는 설치가 된 상태라 헷갈립니다.

apple-design-skill 스킬 설치 절차 전체

터미널을 처음 여시거나, 위 한 줄에서 막히셨다면 여기를 보십시오. 터미널 여는 법부터 확인 명령까지 순서대로 적어 두었습니다.

# apple-design-skill 설치

## 0. 어디에 붙여 넣나

Claude 데스크톱 앱의 채팅창이 아닙니다. 컴퓨터의 터미널입니다.

  macOS    Spotlight(Command + 스페이스)에서 "터미널" 을 여십시오
  Windows  시작 메뉴에서 "PowerShell" 을 여십시오

Node.js 가 있어야 합니다. 터미널에 node -v 를 쳐서 v20.1.2 처럼
버전이 나오면 준비된 것입니다. "찾을 수 없습니다" 가 나오면
nodejs.org 에서 LTS 버전을 먼저 설치하십시오.

## 1. 넣기

npx skills add dickwu/apple-design-skill -g -a claude-code

  성공하면 이 한 줄이 나옵니다.
  Installed 1 skill → ~/.claude/skills/...

  -g 는 계정 전체에 넣는다는 뜻입니다(~/.claude/skills).
  어느 폴더에서 Claude Code 를 열든 쓸 수 있습니다.
  빼면 지금 열려 있는 폴더에만 깔려서(./.claude/skills), 다른 데서
  열면 스킬이 안 보입니다. "깔았는데 안 보인다" 는 대개 이것입니다.

  -a claude-code 는 Claude Code 에만 넣는다는 뜻입니다.
  빼면 전역 설치를 지원하지 않는 다른 도구 때문에 빨간
  "Failed to install" 이 뜹니다. 실제로는 설치가 끝난 상태인데
  실패한 것처럼 보여 여기서 멈추기 쉽습니다.

  저장소에 스킬이 여러 개면 어느 것을 넣을지 물어봅니다.
  미리 보시려면 --list 를 붙이십시오.

  npx skills add dickwu/apple-design-skill --list

## 2. Claude Code 를 다시 시작합니다

이미 claude 를 실행 중이셨다면 끝내고 다시 실행하십시오.
실행 중인 세션은 시작할 때 읽은 목록을 그대로 씁니다.

  데스크톱 앱을 껐다 켜는 것이 아닙니다. 터미널의 claude 를 말합니다.

## 3. 확인

npx skills list -g

  전역으로 넣은 스킬이 이름과 경로와 함께 나옵니다.
  -g 를 빼면 지금 폴더의 스킬만 보이므로 "없다" 고 나올 수 있습니다.

## 4. 쓰기

"애플 HIG 기준 화면 검수" 관련 작업을 시켜 보십시오.
스킬이 붙었다면 알아서 불러 씁니다.

이렇게 시켜 보세요

넣고 나서 바로 던져 볼 수 있는 지시문입니다. 누르면 복사됩니다.

알아 둘 것

apple-design-skill 스킬 안 될 때 확인할 것

만들어 주지는 않습니다

이미 있는 화면을 보고 지적하는 쪽입니다. 백지에서 화면을 짜 달라고 하면 할 일이 없습니다.

한 화면에서도 지적이 길게 나옵니다

122장을 기준으로 훑기 때문입니다. 전부 고칠 필요는 없으니 심각한 것부터 추려 달라고 되물으십시오.

애플 기준이라 안드로이드와 부딪힙니다

한 코드베이스로 양쪽을 내는 앱이면, 지적을 그대로 따르다 안드로이드 쪽 관례를 깨뜨릴 수 있습니다.

언제 쓰고, 언제 안 쓰나

이미 만든 앱 화면을 내보내기 전에 훑을 때 씁니다. 아직 디자인을 시작도 안 했다면 볼 것이 없습니다.

비슷한 것 중에 왜 이걸

이름이 거의 같은 apple-design 과 하는 일이 정반대입니다. 저쪽은 WWDC 원칙을 웹(CSS·JS)으로 옮겨 애플처럼 움직이는 화면을 만드는 쪽이고, 이쪽은 이미 만든 화면을 HIG 122장에 비춰 지적하는 쪽입니다. 앱을 만든다면 두 개를 같이 두고 저쪽으로 짜고 이쪽으로 검사하는 편이 낫습니다. 검사만 놓고 보면 impeccable 과 자리가 겹치는데, 저쪽은 'AI 가 만든 티'를 잡는 감각 쪽이고 이쪽은 애플 문서라는 출처가 있어 근거를 댈 수 있습니다. 웹만 만들고 앱은 안 낸다면 이쪽은 과합니다.

디자인 도구를 고를 때

Figma 등 디자인 툴과 연동합니다. 팀 플랜이 필요한 기능인지, 읽기 권한만 요구하는지 편집 권한까지 요구하는지 확인하세요.

원본 보기

스킬의 실제 내용은 SKILL.md 파일 하나에 들어 있습니다. 넣기 전에 한 번 읽어 보시는 것을 권합니다. 스킬은 Claude 에게 그대로 들어가는 지시문이라, 무엇을 시키는지 확인하지 않고 쓰면 의도치 않은 동작을 할 수 있습니다.

GitHub 에서 dickwu/apple-design-skill 열기

별점과 댓글

이 스킬을 써 보신 분의 별점(5점 만점)과 한마디입니다. 작성자는 아이디 앞 3자만 보입니다(예: wor****). 읽는 데는 제한이 없고, 남기는 것은 로그인한 회원만 됩니다. 한 사람이 한 번이며 다시 쓰면 앞의 것을 덮어씁니다.

함께 보면 좋은 스킬