dickwu/apple-design-skill

Cross-platform UI/UX design reviewer based on Apple HIG. Works with Flutter, Tauri, Electron, React Native. Compatible with Claude Code, Cursor, Codex.

Apple Design Skill – Apple 스타일 UI를 AI로 검토하는 도구

무엇인가요 – Claude Code, Cursor, Codex, OpenCode, Windsurf 등 AI 코딩 어시스턴트용 플러그인(skill)입니다. 이 스킬을 통해 어시스턴트가 Apple의 Human Interface Guidelines(HIG)에 따라 UI를 디자인 리뷰할 수 있습니다. Flutter, React Native, Tauri, Electron, SwiftUI, UIKit, AppKit 등 다양한 프론트엔드 프레임워크를 지원하며, 선택한 프레임워크 언어로 구체적인 수정 제안을 제공합니다.

작동 방식 – 리포지토리는 다음을 포함합니다:

공식 Apple HIG 페이지에서 생성된 122개의 Markdown 파일 (원문 표현, 제목, 표, 변경 내역을 그대로 유지).
최신 HIG 페이지를 다시 다운로드하고 이 Markdown 파일들을 재생성하는 작은 Node 스크립트 (scripts/pull-hig.mjs).
에이전트의 "자세", 리뷰 체크리스트, 보고서 형식, 그리고 선택적 improvement mode (디자인 토큰 시스템: 팔레트, 타이포그래피, 모션 등)을 정의하는 SKILL.md.
요청(예: "내 Flutter 홈 화면을 리뷰해줘")을 관련 HIG 페이지로 매핑하는 라우팅 테이블 (references/hig-lookup.md).

에이전트가 디자인 리뷰 프롬프트를 받으면, 해당 HIG Markdown을 로드한 후 다음 절차를 수행합니다:

Apple의 8가지 디자인 원칙(목적, 주체성, 책임감, 친숙함, 유연성, 단순성, 정교함, 즐거움)을 확인.
접근성 수치(텍스트 확대, 대비, 컨트롤 크기, VoiceOver, 키보드, 모션 설정)를 검증.
플랫폼별 규칙(탭 바, 메뉴, 세이프 영역, 단축키 등)을 확인.
시각적 정교함(색상, 글꼴, 레이아웃, 아이콘, 모션, "시점")을 검토.
상호작용 패턴(로딩, 알림, 되돌리기, 파괴적 작업)을 분석.
콘텐츠 및 글쓰기(라벨, 대문자, 오류 메시지)를 검토.

각 발견은 무엇이 문제인가, 왜 문제인가 (정확한 HIG 제목 인용), 그리고 수정안 (개발자가 사용하는 프레임워크 언어로 작성)으로 반환됩니다. 전용 서브모드로 앱 아이콘, 다크모드, "Liquid Glass" 효과, 온보딩, 권한, 폼, 생성형 AI 컴포넌트, 단일 UI 컴포넌트 등을 다룹니다.

설치 방법 – 스킬은 일반적인 skills CLI를 통해 배포됩니다:

npx skills add dickwu/apple-design-skill          # 모든 지원되는 에이전트에 설치
npx skills add dickwu/apple-design-skill -a claude-code   # Claude Code 전용
npx skills add dickwu/apple-design-skill -g               # 사용자 전체 설치

Claude나 Cursor, Windsurf 등의 에이전트가 로컬 .claude/skills/, .cursorrules, .windsurfrules 등을 읽는 경우, 리포지토리를 직접 해당 폴더에 클론할 수도 있습니다.

일반적인 사용법 – 어시스턴트와의 채팅에서 다음과 같이 요청하면 됩니다:

"내 Flutter 앱의 홈 화면을 Apple 가이드라인에 따라 리뷰해줘."
"이 Tauri 앱의 접근성을 감사해줘."
"이 macOS 설정 창은 플랫폼 규칙을 따르고 있나요?"
"iOS 패턴을 깨지 않고 이 UI에 시점을 부여해줘." 어시스턴트는 구조화된 리뷰와 구체적인 코드 수준 제안을 반환합니다.

데이터 최신화 – 포함된 스크립트를 실행하세요:

node scripts/pull-hig.mjs   # Node 18+ 필요

이 스크립트는 developer.apple.com에 약 150회 요청하여 references/hig/*.md 파일을 재작성하고 룩업 테이블을 업데이트합니다. 스크립트는 결정론적이며, 두 번째 실행 시 변경 사항이 없습니다.

라이선스 및 출처 – 가이드라인 텍스트는 Apple의 공개 Human Interface Guidelines에서 재현되었으며, 모든 생성 파일에 출처가 명시되어 있습니다. 이 리포지토리는 Apple과 관련이 없습니다. 코드와 스킬은 리포지토리 라이선스에 따라 "있는 그대로" 제공됩니다 (리포지토리 내 LICENSE 파일 참조).

결론 – Apple Design Skill은 일반적인 LLM 기반 코딩 어시스턴트를, 여러 개발 프레임워크에서 Apple의 디자인 기준을 강제하는 전문적인 UI 디자인 감사자로 바꾸는 도구이며, 최신 참조 자료와 실행 가능한 프레임워크별 수정 제안을 제공합니다.