{"id":"a180cac0-28b5-4c34-a15a-49868b5778b5","shortId":"MkYZmL","kind":"skill","title":"hig-components-controls","tagline":"Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.","description":"# Apple HIG: Selection and Input Controls\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. **Clear current state.** Users must always see what is selected. Toggles show on/off, segmented controls highlight the active segment, pickers display the current selection.\n\n2. **Prefer standard system controls.** Built-in controls provide consistency and accessibility. Custom controls introduce a learning curve and may break assistive features.\n\n3. **Toggles for binary states.** On or off. In Settings-style screens, changes take effect immediately. In modal forms, changes commit on confirmation.\n\n4. **Segmented controls for mutually exclusive options.** 2-5 items, roughly equal importance, short labels.\n\n5. **Sliders for continuous values.** When precise numeric input is not critical. Provide min/max labels or icons for range endpoints.\n\n6. **Pickers for long option lists.** Too many options for a segmented control. Works well for dates, times, structured data.\n\n7. **Steppers for small, precise adjustments.** Increment/decrement in fixed steps. Display current value next to the stepper with reasonable min/max bounds.\n\n8. **Text fields for short, single-line input.** Text views for multi-line. Configure keyboard type to match expected input (email, URL, number).\n\n9. **Combo boxes: text input + selection list.** macOS. Type a value or choose from a predefined list when custom values are valid.\n\n10. **Token fields: discrete values as visual tokens.** macOS. For email recipients, tags, or collections of discrete items.\n\n11. **Gauges and rating indicators display values.** Gauges show a value within a range. Rating indicators show ratings (often stars). Display-only; use interactive variants for input.\n\n## Reference Index\n\n| Reference | Topic | Key content |\n|---|---|---|\n| [controls.md](references/controls.md) | General controls | States, affordance, system controls |\n| [toggles.md](references/toggles.md) | Toggles | On/off, immediate effect |\n| [segmented-controls.md](references/segmented-controls.md) | Segmented controls | 2-5 options, equal weight |\n| [sliders.md](references/sliders.md) | Sliders | Continuous range, min/max labels |\n| [steppers.md](references/steppers.md) | Steppers | Fixed steps, bounded values |\n| [pickers.md](references/pickers.md) | Pickers | Dates, times, long option sets |\n| [combo-boxes.md](references/combo-boxes.md) | Combo boxes | macOS, type or select, custom values |\n| [text-fields.md](references/text-fields.md) | Text fields | Short input, keyboard types, validation |\n| [text-views.md](references/text-views.md) | Text views | Multi-line, comments, descriptions |\n| [labels.md](references/labels.md) | Labels | Placement, VoiceOver support |\n| [token-fields.md](references/token-fields.md) | Token fields | macOS, chips, tags, recipients |\n| [virtual-keyboards.md](references/virtual-keyboards.md) | Virtual keyboards | Email, URL, number keyboard types |\n| [rating-indicators.md](references/rating-indicators.md) | Rating indicators | Star ratings, display-only |\n| [gauges.md](references/gauges.md) | Gauges | Level indicators, range display |\n\n## Output Format\n\n1. **Control recommendation with rationale** and why alternatives are less suitable.\n2. **State management** -- how the control communicates current state and whether changes apply immediately or on confirmation.\n3. **Validation approach** -- when to show errors and how to communicate rules.\n4. **Accessibility** -- labels, traits, hints for VoiceOver.\n\n## Questions to Ask\n\n1. What type of data? (Boolean, choice from fixed set, numeric, free-form text?)\n2. How many options?\n3. Which platforms? (Combo boxes and token fields are macOS-only)\n4. Settings screen or inline form?\n\n## Related Skills\n\n- **hig-components-menus** -- Buttons and pop-up buttons complementing selection controls\n- **hig-components-dialogs** -- Sheets and popovers containing forms\n- **hig-components-search** -- Search fields sharing text input patterns\n- **hig-inputs** -- Keyboard, pointer, gesture interactions with controls\n- **hig-foundations** -- Typography, color, layout for control styling\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","components","controls","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding"],"capabilities":["skill","source-sickn33","skill-hig-components-controls","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-components-controls","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 (4,763 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:26.721Z","embedding":null,"createdAt":"2026-04-18T21:38:26.171Z","updatedAt":"2026-04-23T18:51:26.721Z","lastSeenAt":"2026-04-23T18:51:26.721Z","tsv":"'-5':128,314 '1':47,409,459 '10':243 '11':261 '2':72,127,313,420,474 '3':96,437,478 '4':120,449,490 '5':135 '6':155 '7':175 '8':196 '9':221 'access':84,450 'action':569 'activ':65 'adjust':180 'afford':300 'alreadi':20,43 'altern':416 'alway':53 'appl':22 'appli':432 'applic':563 'approach':439 'ask':9,16,32,39,458,607 'assist':94 'binari':99 'boolean':464 'bound':195,330 'boundari':615 'box':223,343,482 'break':93 'built':78,548 'built-in':77 'button':502,507 'chang':109,116,431 'check':5,28 'chip':379 'choic':465 'choos':233 'clarif':609 'claude/apple-design-context.md':7,30 'clear':48,582 'collect':257 'color':543 'combo':222,342,481 'combo-boxes.md':340 'comment':366 'commit':117 'communic':426,447 'complement':508 'compon':3,500,513,522 'configur':211 'confirm':119,436 'consist':82 'contain':518 'content':294 'context':13,36 'continu':138,321 'control':4,27,62,76,80,86,122,167,298,302,312,410,425,510,538,546 'controls.md':295 'cover':21,44 'criteria':618 'critic':146 'current':49,70,186,427 'curv':90 'custom':85,239,348 'data':174,463 'date':171,335 'describ':570,586 'descript':367 'develop':554 'dialog':514 'discret':246,259 'display':68,185,266,282,398,406 'display-on':281,397 'effect':111,308 'email':218,253,386 'endpoint':154 'environ':598 'environment-specif':597 'equal':131,316 'error':443 'exclus':125 'execut':565 'exist':12,35 'expect':216 'expert':603 'featur':95 'field':198,245,353,377,485,525 'fix':183,328,467 'form':115,472,495,519 'format':408 'foundat':541 'free':471 'free-form':470 'gaug':262,268,402 'gauges.md':400 'general':297 'gestur':535 'hig':2,23,499,512,521,531,540 'hig-components-control':1 'hig-components-dialog':511 'hig-components-menus':498 'hig-components-search':520 'hig-found':539 'hig-input':530 'highlight':63 'hint':453 'icon':151 'immedi':112,307,433 'import':132 'increment/decrement':181 'index':290 'indic':265,276,394,404 'inform':18,41 'inlin':494 'input':26,143,204,217,225,288,355,528,532,612 'interact':285,536 'introduc':87 'item':129,260 'key':45,293 'keyboard':212,356,385,389,533 'label':134,149,324,370,451 'labels.md':368 'layout':544 'learn':89 'less':418 'level':403 'limit':574 'line':203,210,365 'list':160,227,237 'long':158,337 'maco':228,251,344,378,488 'macos-on':487 'manag':422 'mani':162,476 'match':215,583 'may':92 'menus':501 'min/max':148,194,323 'miss':620 'modal':114 'multi':209,364 'multi-lin':208,363 'must':52 'mutual':124 'next':188 'number':220,388 'numer':142,469 'often':279 'on/off':60,306 'option':126,159,163,315,338,477 'output':407,592 'overview':573 'pattern':529 'permiss':613 'picker':67,156,334 'pickers.md':332 'placement':371 'platform':480 'pointer':534 'pop':505 'pop-up':504 'popov':517 'precis':141,179 'predefin':236 'prefer':73 'principl':46 'provid':81,147 'question':10,33,456 'raintre':550 'raintree.technology':552,556 'rang':153,274,322,405 'rate':264,275,278,393,396 'rating-indicators.md':391 'rational':413 'reason':193 'recipi':254,381 'recommend':411 'refer':289,291 'references/combo-boxes.md':341 'references/controls.md':296 'references/gauges.md':401 'references/labels.md':369 'references/pickers.md':333 'references/rating-indicators.md':392 'references/segmented-controls.md':310 'references/sliders.md':319 'references/steppers.md':326 'references/text-fields.md':351 'references/text-views.md':360 'references/toggles.md':304 'references/token-fields.md':375 'references/virtual-keyboards.md':383 'relat':496 'requir':611 'review':604 'rough':130 'rule':448 'safeti':614 'scope':585 'screen':108,492 'search':523,524 'see':54 'segment':61,66,121,166,311 'segmented-controls.md':309 'select':24,57,71,226,347,509 'set':106,339,468,491 'settings-styl':105 'share':526 'sheet':515 'short':133,200,354 'show':59,269,277,442 'singl':202 'single-lin':201 'skill':497,561,577 'skill-hig-components-controls' 'slider':136,320 'sliders.md':318 'small':178 'source-sickn33' 'specif':599 'standard':74 'star':280,395 'state':50,100,299,421,428 'step':184,329 'stepper':176,191,327 'steppers.md':325 'stop':605 'structur':173 'style':107,547 'substitut':595 'success':617 'suitabl':419 'support':373 'system':75,301 'tag':255,380 'take':110 'task':581 'technolog':551 'test':601 'text':197,205,224,352,361,473,527 'text-fields.md':350 'text-views.md':359 'time':172,336 'toggl':58,97,305 'toggles.md':303 'token':244,250,376,484 'token-fields.md':374 'tool':555 'topic':292 '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' 'trait':452 'treat':590 'type':213,229,345,357,390,461 'typographi':542 'url':219,387 'use':11,34,284,559,575 'user':51 'valid':242,358,438,600 'valu':139,187,231,240,247,267,271,331,349 'variant':286 'view':206,362 'virtual':384 'virtual-keyboards.md':382 'visual':249 'voiceov':372,455 'weight':317 'well':169 'whether':430 'within':272 'work':168 'workflow':567","prices":[{"id":"8cd82918-f0d3-4ade-b9ac-b52e0a2224a0","listingId":"a180cac0-28b5-4c34-a15a-49868b5778b5","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:26.171Z"}],"sources":[{"listingId":"a180cac0-28b5-4c34-a15a-49868b5778b5","source":"github","sourceId":"sickn33/antigravity-awesome-skills/hig-components-controls","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/hig-components-controls","isPrimary":false,"firstSeenAt":"2026-04-18T21:38:26.171Z","lastSeenAt":"2026-04-23T18:51:26.721Z"}],"details":{"listingId":"a180cac0-28b5-4c34-a15a-49868b5778b5","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"hig-components-controls","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":"f38c59a20584ac69a042e7251082e88eb08c4ac6","skill_md_path":"skills/hig-components-controls/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/hig-components-controls"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"hig-components-controls","description":"Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/hig-components-controls"},"updatedAt":"2026-04-23T18:51:26.721Z"}}