{"id":"5adbce28-edf0-4c22-b6fa-0a89d852b31f","shortId":"Q5aXef","kind":"skill","title":"hig-foundations","tagline":">-","description":"# Apple HIG: Design Foundations\n\nCheck for `.claude/apple-design-context.md` before asking questions. Use existing context and only ask for information not already covered.\n\n## Key Principles\n\n1. **Prioritize content over chrome.** Reduce visual clutter. Use system-provided materials and subtle separators rather than heavy borders and backgrounds.\n\n2. **Build in accessibility from the start.** Design for VoiceOver, Dynamic Type, Reduce Motion, Increase Contrast, and Switch Control from day one. Every interactive element needs an accessible label.\n\n3. **Use system colors and materials.** System colors adapt to light/dark mode, increased contrast, and vibrancy. Prefer semantic colors (`label`, `secondaryLabel`, `systemBackground`) over hard-coded values.\n\n4. **Use platform fonts and icons.** SF Pro, SF Compact, SF Mono by default. New York for serif. Follow the type hierarchy at recommended sizes. Use SF Symbols for iconography.\n\n5. **Match platform conventions.** Align look and behavior with system standards. Provide direct, responsive manipulation and clear feedback for every action.\n\n6. **Respect privacy.** Request permissions only when needed, explain why clearly, provide value before asking for data. Design for minimal data collection.\n\n7. **Support internationalization.** Accommodate text expansion, right-to-left scripts, and varying date/number formats. Use Auto Layout for dynamic content sizing.\n\n8. **Use motion purposefully.** Animation should communicate meaning and spatial relationships. Honor Reduce Motion by providing crossfade alternatives.\n\n## Reference Index\n\n| Reference | Topic | Key content |\n|---|---|---|\n| [accessibility.md](references/accessibility.md) | Accessibility | VoiceOver, Dynamic Type, color contrast, motor accessibility, Switch Control, audio descriptions |\n| [app-icons.md](references/app-icons.md) | App Icons | Icon grid, platform-specific sizes, single focal point, no transparency |\n| [branding.md](references/branding.md) | Branding | Integrating brand identity within Apple's design language, subtle branding, custom tints |\n| [color.md](references/color.md) | Color | System colors, Dynamic Colors, semantic colors, custom palettes, contrast ratios |\n| [dark-mode.md](references/dark-mode.md) | Dark Mode | Elevated surfaces, semantic colors, adapted palettes, vibrancy, testing in both modes |\n| [icons.md](references/icons.md) | Icons | Glyph icons, SF Symbols integration, custom icon design, icon weights, optical alignment |\n| [images.md](references/images.md) | Images | Image resolution, @2x/@3x assets, vector assets, image accessibility |\n| [immersive-experiences.md](references/immersive-experiences.md) | Immersive Experiences | AR/VR design, spatial immersion, comfort zones, progressive immersion levels |\n| [inclusion.md](references/inclusion.md) | Inclusion | Diverse representation, non-gendered language, cultural sensitivity, inclusive defaults |\n| [layout.md](references/layout.md) | Layout | Margins, spacing, alignment, safe areas, adaptive layouts, readable content guides |\n| [materials.md](references/materials.md) | Materials | Vibrancy, blur, translucency, system materials, material thickness |\n| [motion.md](references/motion.md) | Motion | Animation curves, transitions, continuity, Reduce Motion support, physics-based motion |\n| [privacy.md](references/privacy.md) | Privacy | Permission requests, usage descriptions, privacy nutrition labels, minimal data collection |\n| [right-to-left.md](references/right-to-left.md) | Right-to-Left | RTL layout mirroring, bidirectional text, icons that flip, exceptions |\n| [sf-symbols.md](references/sf-symbols.md) | SF Symbols | Symbol categories, rendering modes, variable color, custom symbols, weight matching |\n| [spatial-layout.md](references/spatial-layout.md) | Spatial Layout | visionOS window placement, depth, ergonomic zones, Z-axis design |\n| [typography.md](references/typography.md) | Typography | SF Pro, Dynamic Type sizes, text styles, custom fonts, font weight hierarchy, line spacing |\n| [writing.md](references/writing.md) | Writing | UI copy guidelines, tone, capitalization rules, error messages, button labels, conciseness |\n\n## Applying Foundations Together\n\nConsider how principles interact:\n\n1. **Color + Dark Mode + Accessibility** -- Custom palettes must work in both modes while maintaining WCAG contrast ratios. Start with system semantic colors.\n\n2. **Typography + Accessibility + Layout** -- Dynamic Type must scale without breaking layouts. Use text styles and Auto Layout for the full range of type sizes.\n\n3. **Icons + Branding + SF Symbols** -- Custom icons should match SF Symbols weight and optical sizing. Brand elements should integrate without overriding system conventions.\n\n4. **Motion + Accessibility + Feedback** -- Every animation must have a Reduce Motion alternative. Motion should reinforce spatial relationships, not decorate.\n\n5. **Privacy + Writing + Onboarding** -- Permission requests need clear, specific usage descriptions. Time them to when the user will understand the benefit.\n\n## Output Format\n\n1. **Cite the specific HIG foundation** with file and section.\n2. **Note platform differences** for the user's target platforms.\n3. **Provide concrete code patterns** (SwiftUI/UIKit/AppKit).\n4. **Explain accessibility impact** (contrast ratios, Dynamic Type scaling, VoiceOver behavior).\n\n## Questions to Ask\n\n1. Which platforms are you targeting?\n2. Do you have existing brand guidelines?\n3. What accessibility level are you targeting? (WCAG AA, AAA, Apple baseline?)\n4. System colors or custom?\n\n## Related Skills\n\n- **hig-platforms** -- How foundations apply per platform (e.g., type scale differences on watchOS vs macOS)\n- **hig-patterns** -- Interaction patterns where foundations like writing and accessibility are critical\n- **hig-components-layout** -- Structural components implementing layout principles\n- **hig-components-content** -- Content display using color, typography, and images\n\n---\n\n*Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)*","tags":["hig","foundations","doctor","raintree-technology","accessibility","agent-skills","ai-agents","apple","apple-design","audit","claude-code","cursor"],"capabilities":["skill","source-raintree-technology","skill-hig-foundations","topic-accessibility","topic-agent-skills","topic-ai-agents","topic-apple","topic-apple-design","topic-audit","topic-claude-code","topic-cursor","topic-hig","topic-ios","topic-macos","topic-skills"],"categories":["hig-doctor"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/raintree-technology/hig-doctor/hig-foundations","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add raintree-technology/hig-doctor","source_repo":"https://github.com/raintree-technology/hig-doctor","install_from":"skills.sh"}},"qualityScore":"0.472","qualityRationale":"deterministic score 0.47 from registry signals: · indexed on github topic:agent-skills · 45 github stars · SKILL.md body (6,113 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T00:57:09.759Z","embedding":null,"createdAt":"2026-04-18T22:18:09.898Z","updatedAt":"2026-05-02T00:57:09.759Z","lastSeenAt":"2026-05-02T00:57:09.759Z","tsv":"'1':27,480,591,631 '2':49,502,601,637 '2x':316 '3':78,526,611,644 '3x':317 '4':105,549,617,656 '5':135,568 '6':156 '7':178 '8':200 'aa':652 'aaa':653 'access':52,76,226,233,322,484,504,551,619,646,689 'accessibility.md':224 'accommod':181 'action':155 'adapt':86,289,357 'align':139,310,354 'alreadi':23 'altern':217,560 'anim':204,375,554 'app':240 'app-icons.md':238 'appl':4,260,654 'appli':473,668 'ar/vr':327 'area':356 'ask':12,19,170,630 'asset':318,320 'audio':236 'auto':194,517 'axi':440 'background':48 'base':384 'baselin':655 'behavior':142,627 'benefit':588 'bidirect':408 'blur':366 'border':46 'brand':255,257,265,528,541,642 'branding.md':253 'break':511 'build':50 'built':712 'button':470 'capit':466 'categori':419 'check':8 'chrome':31 'cite':592 'claude/apple-design-context.md':10 'clear':151,166,575 'clutter':34 'code':103,614 'collect':177,398 'color':81,85,96,230,270,272,274,276,288,423,481,501,658,708 'color.md':268 'comfort':331 'communic':206 'compact':114 'compon':694,697,703 'concis':472 'concret':613 'consid':476 'content':29,198,223,360,704,705 'context':16 'continu':378 'contrast':64,91,231,279,495,621 'control':67,235 'convent':138,548 'copi':463 'cover':24 'critic':691 'crossfad':216 'cultur':345 'curv':376 'custom':266,277,304,424,452,485,531,660 'dark':283,482 'dark-mode.md':281 'data':172,176,397 'date/number':191 'day':69 'decor':567 'default':118,348 'depth':435 'descript':237,392,578 'design':6,56,173,262,306,328,441 'develop':718 'differ':604,674 'direct':147 'display':706 'divers':339 'dynam':59,197,228,273,447,506,623 'e.g':671 'element':73,542 'elev':285 'ergonom':436 'error':468 'everi':71,154,553 'except':413 'exist':15,641 'expans':183 'experi':326 'explain':164,618 'feedback':152,552 'file':598 'flip':412 'focal':249 'follow':123 'font':108,453,454 'format':192,590 'foundat':3,7,474,596,667,685 'full':521 'gender':343 'glyph':299 'grid':243 'guid':361 'guidelin':464,643 'hard':102 'hard-cod':101 'heavi':45 'hierarchi':126,456 'hig':2,5,595,664,680,693,702 'hig-components-cont':701 'hig-components-layout':692 'hig-found':1 'hig-pattern':679 'hig-platform':663 'honor':211 'icon':110,241,242,298,300,305,307,410,527,532 'iconographi':134 'icons.md':296 'ident':258 'imag':313,314,321,711 'images.md':311 'immers':325,330,334 'immersive-experiences.md':323 'impact':620 'implement':698 'inclus':338,347 'inclusion.md':336 'increas':63,90 'index':219 'inform':21 'integr':256,303,544 'interact':72,479,682 'internation':180 'key':25,222 'label':77,97,395,471 'languag':263,344 'layout':195,351,358,406,431,505,512,518,695,699 'layout.md':349 'left':187,404 'level':335,647 'light/dark':88 'like':686 'line':457 'look':140 'maco':678 'maintain':493 'manipul':149 'margin':352 'match':136,427,534 'materi':39,83,364,369,370 'materials.md':362 'mean':207 'messag':469 'minim':175,396 'mirror':407 'mode':89,284,295,421,483,491 'mono':116 'motion':62,202,213,374,380,385,550,559,561 'motion.md':372 'motor':232 'must':487,508,555 'need':74,163,574 'new':119 'non':342 'non-gend':341 'note':602 'nutrit':394 'onboard':571 'one':70 'optic':309,539 'output':589 'overrid':546 'palett':278,290,486 'pattern':615,681,683 'per':669 'permiss':160,389,572 'physic':383 'physics-bas':382 'placement':434 'platform':107,137,245,603,610,633,665,670 'platform-specif':244 'point':250 'prefer':94 'principl':26,478,700 'priorit':28 'privaci':158,388,393,569 'privacy.md':386 'pro':112,446 'progress':333 'provid':38,146,167,215,612 'purpos':203 'question':13,628 'raintre':714 'raintree.technology':716,720 'rang':522 'rather':43 'ratio':280,496,622 'readabl':359 'recommend':128 'reduc':32,61,212,379,558 'refer':218,220 'references/accessibility.md':225 'references/app-icons.md':239 'references/branding.md':254 'references/color.md':269 'references/dark-mode.md':282 'references/icons.md':297 'references/images.md':312 'references/immersive-experiences.md':324 'references/inclusion.md':337 'references/layout.md':350 'references/materials.md':363 'references/motion.md':373 'references/privacy.md':387 'references/right-to-left.md':400 'references/sf-symbols.md':415 'references/spatial-layout.md':429 'references/typography.md':443 'references/writing.md':460 'reinforc':563 'relat':661 'relationship':210,565 'render':420 'represent':340 'request':159,390,573 'resolut':315 'respect':157 'respons':148 'right':185,402 'right-to-left':184,401 'right-to-left.md':399 'rtl':405 'rule':467 'safe':355 'scale':509,625,673 'script':188 'secondarylabel':98 'section':600 'semant':95,275,287,500 'sensit':346 'separ':42 'serif':122 'sf':111,113,115,131,301,416,445,529,535 'sf-symbols.md':414 'singl':248 'size':129,199,247,449,525,540 'skill':662 'skill-hig-foundations' 'source-raintree-technology' 'space':353,458 'spatial':209,329,430,564 'spatial-layout.md':428 'specif':246,576,594 'standard':145 'start':55,497 'structur':696 'style':451,515 'subtl':41,264 'support':179,381 'surfac':286 'swiftui/uikit/appkit':616 'switch':66,234 'symbol':132,302,417,418,425,530,536 'system':37,80,84,144,271,368,499,547,657 'system-provid':36 'systembackground':99 'target':609,636,650 'technolog':715 'test':292 'text':182,409,450,514 'thick':371 'time':579 'tint':267 'togeth':475 'tone':465 'tool':719 'topic':221 'topic-accessibility' 'topic-agent-skills' 'topic-ai-agents' 'topic-apple' 'topic-apple-design' 'topic-audit' 'topic-claude-code' 'topic-cursor' 'topic-hig' 'topic-ios' 'topic-macos' 'topic-skills' 'transit':377 'transluc':367 'transpar':252 'type':60,125,229,448,507,524,624,672 'typographi':444,503,709 'typography.md':442 'ui':462 'understand':586 'usag':391,577 'use':14,35,79,106,130,193,201,513,707 'user':584,607 'valu':104,168 'vari':190 'variabl':422 'vector':319 'vibranc':93,291,365 'visiono':432 'visual':33 'voiceov':58,227,626 'vs':677 'watcho':676 'wcag':494,651 'weight':308,426,455,537 'window':433 'within':259 'without':510,545 'work':488 'write':461,570,687 'writing.md':459 'york':120 'z':439 'z-axi':438 'zone':332,437","prices":[{"id":"8f6ee7ab-8439-459b-adaf-669f238f686b","listingId":"5adbce28-edf0-4c22-b6fa-0a89d852b31f","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"raintree-technology","category":"hig-doctor","install_from":"skills.sh"},"createdAt":"2026-04-18T22:18:09.898Z"}],"sources":[{"listingId":"5adbce28-edf0-4c22-b6fa-0a89d852b31f","source":"github","sourceId":"raintree-technology/hig-doctor/hig-foundations","sourceUrl":"https://github.com/raintree-technology/hig-doctor/tree/main/skills/hig-foundations","isPrimary":false,"firstSeenAt":"2026-04-18T22:18:09.898Z","lastSeenAt":"2026-05-02T00:57:09.759Z"}],"details":{"listingId":"5adbce28-edf0-4c22-b6fa-0a89d852b31f","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"raintree-technology","slug":"hig-foundations","github":{"repo":"raintree-technology/hig-doctor","stars":45,"topics":["accessibility","agent-skills","ai-agents","apple","apple-design","audit","claude-code","cursor","hig","human-interface-guidelines","ios","macos","skills","swiftui","tvos","uikit","visionos","watchos"],"license":"other","html_url":"https://github.com/raintree-technology/hig-doctor","pushed_at":"2026-04-28T22:36:54Z","description":"Apple HIG audit CLI + 14 agent skills for AI coding assistants — score any project for HIG compliance across 12 frameworks","skill_md_sha":"9f3abc69a0afeb5e2eb31ad4dd1b6db8ae82da1b","skill_md_path":"skills/hig-foundations/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/raintree-technology/hig-doctor/tree/main/skills/hig-foundations"},"layout":"multi","source":"github","category":"hig-doctor","frontmatter":{"name":"hig-foundations","description":">-"},"skills_sh_url":"https://skills.sh/raintree-technology/hig-doctor/hig-foundations"},"updatedAt":"2026-05-02T00:57:09.759Z"}}