hig-foundations

hig-foundations 스킬 개요

hig-foundations는 Apple Human Interface Guidelines를 바탕으로, 명확성·접근성·시스템 적합성에 영향을 주는 초기 디자인 결정을 돕는 foundations 스킬입니다. 색상, 타이포그래피, 심볼, 머티리얼, 모션, 개인정보, 레이아웃, RTL, 포용적 디자인처럼 Apple 플랫폼에서 중요한 기본 판단이 필요할 때 hig-foundations 스킬을 사용하세요. 대략적인 인터페이스 아이디어를 Apple에 맞는 디자인 선택으로 바꿔야 하는 UI 디자이너, 제품팀, 에이전트에게 특히 잘 맞습니다.

hig-foundations는 무엇을 위한 스킬인가

이 스킬은 화면, 컴포넌트, 플랫폼 패턴으로 들어가기 전에 “이게 어떻게 보여야 하고 어떤 느낌이어야 하는가?”를 먼저 정리하도록 돕습니다. 다크 모드 대비, Dynamic Type 지원, 시스템 색상 사용, 폰트 선택, 아이콘을 네이티브하게 보이게 만드는 방법처럼 기본기가 중요한 문제에서 특히 유용합니다. 목표가 Apple HIG에 맞추는 것이라면, 커스텀 비주얼 언어를 새로 발명하기보다 hig-foundations를 출발점으로 삼는 편이 맞습니다.

언제 가장 잘 맞는가

hig-foundations는 한 화면이 아니라 앱 전체에 적용되는 UI Design 결정이 필요할 때 사용하세요. Apple 기기에서의 브랜드 스타일링, 접근성 우선 비주얼 시스템, 제품 명세서나 디자인 프롬프트의 foundations 검토 같은 상황에 잘 맞습니다. 반대로 이미 좁은 상호작용 패턴이나 플랫폼별 구현 디테일이 필요한 단계라면 효용이 떨어집니다.

주요 차별점

hig-foundations의 가치는 장식적인 디자인 추측보다 시스템 기본값과 접근성을 고려한 선택으로 사용자를 이끈다는 점에 있습니다. 또 HIG의 관련 영역으로 이어지는 상호 참조를 제공해, foundations에서 플랫폼·패턴·컴포넌트로 자연스럽게 이어갈 수 있습니다. 그래서 hig-foundations 가이드는 단순히 “Apple 스타일로 해줘”라고 하는 일반적인 프롬프트보다 훨씬 실용적입니다.

hig-foundations 스킬 사용 방법

스킬 설치 및 준비

npx skills add raintree-technology/apple-hig-skills --skill hig-foundations로 설치하세요. 가장 좋은 결과를 내려면, 에이전트가 추천안을 작성하기 전에 스킬 파일과 주변 맥락을 살펴볼 수 있는 워크플로에서 사용하는 것이 좋습니다. hig-foundations 설치는 제품 목표, 대상 플랫폼, 접근성 제약 조건을 미리 준비해 둘수록 효과가 큽니다.

스킬에 맞는 입력을 주는 방법

약한 프롬프트는 “이걸 더 Apple답게 만들어줘”입니다. 더 강한 프롬프트는 “이 iOS 온보딩 화면에 hig-foundations를 적용해줘. 시스템 색상을 쓰고, Dynamic Type을 지원하고, 모션은 최소화하고, CTA가 다크 모드에서도 읽히게 해줘”처럼 구체적입니다. 플랫폼, 대상 사용자, 기존 디자인 제약, 그리고 대비 부족, 아이콘 불일치, RTL 레이아웃 같은 알려진 문제를 함께 넣으세요. 현재 상태를 구체적으로 적을수록 스킬이 추측해야 할 부분이 줄어듭니다.

소스를 이 순서로 읽기

먼저 SKILL.md부터 보세요. 핵심 판단 기준과 상호 참조가 들어 있습니다. 그다음 스킬에서 언급한 repo 맥락을 확인하고, 특히 README.md, AGENTS.md, metadata.json, 그리고 있으면 지원 폴더도 살펴보세요. 이 repository에서는 실무적으로 가장 중요한 신호가 SKILL.md 안에 있으므로, 여기만 빠르게 훑어봐도 hig-foundations 사용이 현재 작업에 맞는지 대체로 판단할 수 있습니다.

더 나은 결과를 만드는 워크플로

스킬은 세 단계로 쓰면 좋습니다. 먼저 UI 문제를 정의하고, 그다음 플랫폼과 접근성 요구사항으로 조건을 걸고, 마지막에 추천이나 재작성 요청을 하세요. 예를 들어: “이 iPad 설정 페이지를 hig-foundations 기준으로 검토하고, 색상·위계·터치 타깃 명확성 측면에서 수정안을 제안해줘.” 이렇게 하면 모델이 처음부터 화면을 상상해야 하는 대신, 평가할 구체적인 디자인 표면을 갖게 됩니다. 카피나 와이어프레임을 바탕으로 작업하는 경우에는 둘 다 함께 넣으세요. foundations guidance는 텍스트와 레이아웃을 함께 볼 때 더 좋아집니다.

hig-foundations 스킬 FAQ

hig-foundations는 디자이너만을 위한 스킬인가?

아닙니다. hig-foundations 스킬은 디자이너, PM, 프론트엔드 엔지니어, 그리고 Apple에 맞는 UI 방향이 필요한 에이전트에게 유용합니다. 구현 티켓을 작성하거나 인터페이스 카피를 검토할 때도 도움이 되는데, 많은 foundations 이슈가 비주얼만큼 코드에도 영향을 주기 때문입니다.

일반 프롬프트와 무엇이 다른가?

일반 프롬프트도 Apple 스타일을 언급할 수는 있지만, hig-foundations는 시스템 색상, 접근성, 비주얼 위계 같은 foundations를 판단하기 위한 재사용 가능한 결정 프레임을 제공합니다. 그 덕분에 모호한 결과가 줄고, 여러 화면이나 기능에 걸쳐 hig-foundations 가이드를 더 안정적으로 쓸 수 있습니다. 물론 제품 맥락을 대체하는 것은 아니지만, 단순히 “더 나은 디자인”을 요청하는 것보다는 훨씬 체계적입니다.

이 스킬을 쓰지 말아야 하는 경우는?

매우 구체적인 상호작용 패턴, 컴포넌트 라이브러리 선택, 또는 플랫폼 구현 심화 내용이 필요하다면 hig-foundations를 쓰지 마세요. 그런 경우에는 더 집중된 스킬이나 직접적인 플랫폼 가이드가 더 빠릅니다. 또한 디자인이 이미 Apple 관례를 잘 따르고 있고, 필요한 것이 작은 카피 수정 정도라면 이 스킬은 피하는 편이 좋습니다.

초보자도 쓰기 쉬운가?

네. 제품 화면과 해결하려는 문제를 설명할 수 있다면 충분합니다. HIG 용어를 전부 미리 알 필요는 없습니다. 가장 좋은 hig-foundations 활용은 기기, 문제, 제약 조건을 분명하게 적은 단순하고 명시적인 프롬프트에서 나옵니다.

hig-foundations 스킬 개선 방법

디자인 제약 조건을 더 선명하게 주기

가장 큰 품질 향상은 바뀌면 안 되는 것들을 명시할 때 나옵니다. 브랜드 컬러, 기존 레이아웃, 지원 언어, 최소 접근성 기준 같은 항목입니다. 예를 들어 “현재 구조는 유지하되 위계를 더 Apple답게 만들고, 브랜드 포인트 컬러는 유지하며, 다크 모드 대비를 통과하게 해줘”라고 말해보세요. 그러면 스킬이 뻔한 조언을 되풀이하기보다 트레이드오프에 집중할 수 있습니다.

원칙보다 결정을 요청하기

hig-foundations 스킬은 무엇을 선택할지 물을 때 가장 강합니다. “이 상태 카드에는 어떤 시스템 색상이 맞나?” 또는 “이 모션은 줄여야 하나, 아예 없애야 하나?”처럼 구체적으로 물어보세요. “접근성이 무엇인지 설명해줘”보다 “무엇을 선택해야 하는지”를 묻는 편이 바로 적용하고 빠르게 검토할 수 있는 결과를 줍니다.

첫 결과를 바탕으로 반복하기

첫 응답을 받은 뒤에는 가장 약한 부분, 즉 타이포그래피, 대비, 아이콘, 레이아웃 밀도 중 하나로 범위를 좁히세요. “CTA가 너무 눈에 띈다” 또는 “Dynamic Type을 적용하면 여전히 너무 빽빽하다”처럼 구체적인 실패 지점을 다시 넣으면 됩니다. foundations 문제는 보통 한 번에 한 층씩 고치는 편이 쉬우므로, hig-foundations와 반복 작업의 궁합이 좋습니다.