{"id":"002b8cbe-d028-476e-92d6-9405f838804d","shortId":"uwmBqm","kind":"skill","title":"hig-foundations","tagline":"Apple Human Interface Guidelines design foundations.","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)*\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["hig","foundations","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-hig-foundations","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/hig-foundations","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34768 github stars · SKILL.md body (6,535 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-04-23T18:51:27.418Z","embedding":null,"createdAt":"2026-04-18T21:38:31.552Z","updatedAt":"2026-04-23T18:51:27.418Z","lastSeenAt":"2026-04-23T18:51:27.418Z","tsv":"'1':33,486,597,637 '2':55,508,607,643 '2x':322 '3':84,532,617,650 '3x':323 '4':111,555,623,662 '5':141,574 '6':162 '7':184 '8':206 'aa':658 'aaa':659 'access':58,82,232,239,328,490,510,557,625,652,695 'accessibility.md':230 'accommod':187 'action':161,739 'adapt':92,295,363 'align':145,316,360 'alreadi':29 'altern':223,566 'anim':210,381,560 'app':246 'app-icons.md':244 'appl':4,10,266,660 'appli':479,674 'applic':733 'ar/vr':333 'area':362 'ask':18,25,176,636,777 'asset':324,326 'audio':242 'auto':200,523 'axi':446 'background':54 'base':390 'baselin':661 'behavior':148,633 'benefit':594 'bidirect':414 'blur':372 'border':52 'boundari':785 'brand':261,263,271,534,547,648 'branding.md':259 'break':517 'build':56 'built':718 'button':476 'capit':472 'categori':425 'check':14 'chrome':37 'cite':598 'clarif':779 'claude/apple-design-context.md':16 'clear':157,172,581,752 'clutter':40 'code':109,620 'collect':183,404 'color':87,91,102,236,276,278,280,282,294,429,487,507,664,714 'color.md':274 'comfort':337 'communic':212 'compact':120 'compon':700,703,709 'concis':478 'concret':619 'consid':482 'content':35,204,229,366,710,711 'context':22 'continu':384 'contrast':70,97,237,285,501,627 'control':73,241 'convent':144,554 'copi':469 'cover':30 'criteria':788 'critic':697 'crossfad':222 'cultur':351 'curv':382 'custom':272,283,310,430,458,491,537,666 'dark':289,488 'dark-mode.md':287 'data':178,182,403 'date/number':197 'day':75 'decor':573 'default':124,354 'depth':441 'describ':740,756 'descript':243,398,584 'design':8,12,62,179,268,312,334,447 'develop':724 'differ':610,680 'direct':153 'display':712 'divers':345 'dynam':65,203,234,279,453,512,629 'e.g':677 'element':79,548 'elev':291 'environ':768 'environment-specif':767 'ergonom':442 'error':474 'everi':77,160,559 'except':419 'execut':735 'exist':21,647 'expans':189 'experi':332 'expert':773 'explain':170,624 'feedback':158,558 'file':604 'flip':418 'focal':255 'follow':129 'font':114,459,460 'format':198,596 'foundat':3,9,13,480,602,673,691 'full':527 'gender':349 'glyph':305 'grid':249 'guid':367 'guidelin':7,470,649 'hard':108 'hard-cod':107 'heavi':51 'hierarchi':132,462 'hig':2,11,601,670,686,699,708 'hig-components-cont':707 'hig-components-layout':698 'hig-found':1 'hig-pattern':685 'hig-platform':669 'honor':217 'human':5 'icon':116,247,248,304,306,311,313,416,533,538 'iconographi':140 'icons.md':302 'ident':264 'imag':319,320,327,717 'images.md':317 'immers':331,336,340 'immersive-experiences.md':329 'impact':626 'implement':704 'inclus':344,353 'inclusion.md':342 'increas':69,96 'index':225 'inform':27 'input':782 'integr':262,309,550 'interact':78,485,688 'interfac':6 'internation':186 'key':31,228 'label':83,103,401,477 'languag':269,350 'layout':201,357,364,412,437,511,518,524,701,705 'layout.md':355 'left':193,410 'level':341,653 'light/dark':94 'like':692 'limit':744 'line':463 'look':146 'maco':684 'maintain':499 'manipul':155 'margin':358 'match':142,433,540,753 'materi':45,89,370,375,376 'materials.md':368 'mean':213 'messag':475 'minim':181,402 'mirror':413 'miss':790 'mode':95,290,301,427,489,497 'mono':122 'motion':68,208,219,380,386,391,556,565,567 'motion.md':378 'motor':238 'must':493,514,561 'need':80,169,580 'new':125 'non':348 'non-gend':347 'note':608 'nutrit':400 'onboard':577 'one':76 'optic':315,545 'output':595,762 'overrid':552 'overview':743 'palett':284,296,492 'pattern':621,687,689 'per':675 'permiss':166,395,578,783 'physic':389 'physics-bas':388 'placement':440 'platform':113,143,251,609,616,639,671,676 'platform-specif':250 'point':256 'prefer':100 'principl':32,484,706 'priorit':34 'privaci':164,394,399,575 'privacy.md':392 'pro':118,452 'progress':339 'provid':44,152,173,221,618 'purpos':209 'question':19,634 'raintre':720 'raintree.technology':722,726 'rang':528 'rather':49 'ratio':286,502,628 'readabl':365 'recommend':134 'reduc':38,67,218,385,564 'refer':224,226 'references/accessibility.md':231 'references/app-icons.md':245 'references/branding.md':260 'references/color.md':275 'references/dark-mode.md':288 'references/icons.md':303 'references/images.md':318 'references/immersive-experiences.md':330 'references/inclusion.md':343 'references/layout.md':356 'references/materials.md':369 'references/motion.md':379 'references/privacy.md':393 'references/right-to-left.md':406 'references/sf-symbols.md':421 'references/spatial-layout.md':435 'references/typography.md':449 'references/writing.md':466 'reinforc':569 'relat':667 'relationship':216,571 'render':426 'represent':346 'request':165,396,579 'requir':781 'resolut':321 'respect':163 'respons':154 'review':774 'right':191,408 'right-to-left':190,407 'right-to-left.md':405 'rtl':411 'rule':473 'safe':361 'safeti':784 'scale':515,631,679 'scope':755 'script':194 'secondarylabel':104 'section':606 'semant':101,281,293,506 'sensit':352 'separ':48 'serif':128 'sf':117,119,121,137,307,422,451,535,541 'sf-symbols.md':420 'singl':254 'size':135,205,253,455,531,546 'skill':668,731,747 'skill-hig-foundations' 'source-sickn33' 'space':359,464 'spatial':215,335,436,570 'spatial-layout.md':434 'specif':252,582,600,769 'standard':151 'start':61,503 'stop':775 'structur':702 'style':457,521 'substitut':765 'subtl':47,270 'success':787 'support':185,387 'surfac':292 'swiftui/uikit/appkit':622 'switch':72,240 'symbol':138,308,423,424,431,536,542 'system':43,86,90,150,277,374,505,553,663 'system-provid':42 'systembackground':105 'target':615,642,656 'task':751 'technolog':721 'test':298,771 'text':188,415,456,520 'thick':377 'time':585 'tint':273 'togeth':481 'tone':471 'tool':725 'topic':227 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'transit':383 'transluc':373 'transpar':258 'treat':760 'type':66,131,235,454,513,530,630,678 'typographi':450,509,715 'typography.md':448 'ui':468 'understand':592 'usag':397,583 'use':20,41,85,112,136,199,207,519,713,729,745 'user':590,613 'valid':770 'valu':110,174 'vari':196 'variabl':428 'vector':325 'vibranc':99,297,371 'visiono':438 'visual':39 'voiceov':64,233,632 'vs':683 'watcho':682 'wcag':500,657 'weight':314,432,461,543 'window':439 'within':265 'without':516,551 'work':494 'workflow':737 'write':467,576,693 'writing.md':465 'york':126 'z':445 'z-axi':444 'zone':338,443","prices":[{"id":"a2d4138e-a714-4558-bb85-5bc9e990d621","listingId":"002b8cbe-d028-476e-92d6-9405f838804d","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:38:31.552Z"}],"sources":[{"listingId":"002b8cbe-d028-476e-92d6-9405f838804d","source":"github","sourceId":"sickn33/antigravity-awesome-skills/hig-foundations","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/hig-foundations","isPrimary":false,"firstSeenAt":"2026-04-18T21:38:31.552Z","lastSeenAt":"2026-04-23T18:51:27.418Z"}],"details":{"listingId":"002b8cbe-d028-476e-92d6-9405f838804d","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"hig-foundations","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34768,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-23T06:41:03Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"6d8b74f19efb6b54bc0f1cb0f6267fcb11d2438b","skill_md_path":"skills/hig-foundations/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/hig-foundations"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"hig-foundations","description":"Apple Human Interface Guidelines design foundations."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/hig-foundations"},"updatedAt":"2026-04-23T18:51:27.418Z"}}