{"id":"958b2917-2910-476f-8ffd-3475cf644222","shortId":"VmGUq9","kind":"skill","title":"hig-inputs","tagline":">-","description":"# Apple HIG: Inputs\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. **Support multiple input methods.** Touch, pointer, keyboard, pencil, voice, eyes, hands, controllers. Design for the inputs available on each platform. On iPadOS, support both touch and pointer; on macOS, both pointer and keyboard.\n\n2. **Consistent feedback for every input action.** Visible, audible, or haptic response.\n\n3. **Standard gestures must behave consistently.** Tap to activate, swipe to scroll/navigate, pinch to zoom, long press for context menus, drag to move. Don't override system gestures (edge swipes for back, Home, notifications).\n\n4. **Use standard recognizers; keep custom gestures discoverable.** Apple's built-in recognizers handle edge cases and accessibility. If you add non-standard gestures, provide hints or coaching to teach them.\n\n5. **Apple Pencil: precision drawing, markup, and selection.** Support pressure, tilt, and hover. Distinguish finger from Pencil when appropriate (finger pans, Pencil draws).\n\n6. **Support Scribble in text fields.** Users expect to write with Pencil in any text input.\n\n7. **Keyboard shortcuts and full navigation.** Standard shortcuts (Cmd+C/V/Z) plus custom ones visible in the iPadOS Command key overlay. Logical tab order.\n\n8. **Respect the software keyboard.** Adjust layout when keyboard appears. Use keyboard-avoidance APIs.\n\n9. **Game controllers: MFi controllers with on-screen fallbacks.** Map to extended gamepad profile, sensible defaults, remappable. Always offer touch or keyboard alternatives.\n\n10. **Pointer and trackpad: native feel.** Hover effects, pointer shape adaptation, standard cursor behaviors. Two-finger scroll, pinch to zoom, swipe to navigate.\n\n11. **Digital Crown: primary scrolling and value-adjustment input on watchOS.** Scrolling lists, adjusting values, navigating views. Haptic feedback at detents.\n\n12. **Eyes and spatial (visionOS): look and pinch.** Generous hit targets (eye tracking is less precise than touch). Avoid sustained gaze for activation. Direct hand manipulation in immersive experiences.\n\n13. **Focus system: critical for tvOS and visionOS.** Predictable focus movement. Every interactive element focusable. Clear visual indicators (scale, highlight, elevation). Logical focus groups.\n\n14. **Siri Remote: limited surface.** Touch area for swiping, clickpad for selection, few physical buttons. Keep interactions simple.\n\n15. **Gyroscope, accelerometer, UWB: use judiciously.** Suits gaming, fitness, AR. Not for essential tasks. Provide calibration and reset. For UWB, communicate distance and direction with visual or haptic cues.\n\n## Reference Index\n\n| Reference | Topic | Key content |\n|---|---|---|\n| [gestures.md](references/gestures.md) | Touch gestures | Tap, swipe, pinch, long press, drag, system gestures |\n| [apple-pencil-and-scribble.md](references/apple-pencil-and-scribble.md) | Apple Pencil | Precision, pressure, tilt, hover, handwriting |\n| [keyboards.md](references/keyboards.md) | Keyboards | Shortcuts, navigation, software keyboard, Command key |\n| [game-controls.md](references/game-controls.md) | Game controllers | MFi, extended gamepad, remapping, fallbacks |\n| [pointing-devices.md](references/pointing-devices.md) | Pointer/trackpad | Hover, cursor morphing, trackpad gestures |\n| [digital-crown.md](references/digital-crown.md) | Digital Crown | Scrolling, value adjustment, haptic detents |\n| [eyes.md](references/eyes.md) | Eye tracking | Look and tap, gaze targeting, hit target sizing |\n| [spatial-interactions.md](references/spatial-interactions.md) | Spatial input | Hand gestures, direct manipulation, immersive input |\n| [focus-and-selection.md](references/focus-and-selection.md) | Focus system | tvOS/visionOS navigation, focus indicators, groups |\n| [remotes.md](references/remotes.md) | Remotes | Touch surface, clickpad, simple interactions |\n| [gyro-and-accelerometer.md](references/gyro-and-accelerometer.md) | Motion sensors | Gyroscope, accelerometer, calibration, gaming |\n| [nearby-interactions.md](references/nearby-interactions.md) | Nearby interactions | U1 chip, directional finding, proximity triggers |\n| [camera-control.md](references/camera-control.md) | Camera Control | iPhone camera hardware button, quick launch |\n\n## Output Format\n\n1. **Input method recommendations by platform** and how they interact.\n2. **Gesture specification table** -- standard and custom gestures with expected behaviors.\n3. **Keyboard shortcut recommendations** following system conventions.\n4. **Accessibility input alternatives** for VoiceOver, Switch Control, etc.\n\n## Questions to Ask\n\n1. Which platforms and input devices?\n2. Productivity or casual app?\n3. Custom gestures in the design?\n4. Game controller support needed?\n\n## Related Skills\n\n- **hig-components-status** -- Progress indicators responding to input (pull-to-refresh)\n- **hig-components-system** -- System experiences with unique input constraints\n- **hig-technologies** -- VoiceOver, Siri voice input, ARKit spatial gesture context\n\n---\n\n*Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)*","tags":["hig","inputs","doctor","raintree-technology","accessibility","agent-skills","ai-agents","apple","apple-design","audit","claude-code","cursor"],"capabilities":["skill","source-raintree-technology","skill-hig-inputs","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-inputs","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 (5,259 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.855Z","embedding":null,"createdAt":"2026-04-18T22:18:10.636Z","updatedAt":"2026-05-02T00:57:09.855Z","lastSeenAt":"2026-05-02T00:57:09.855Z","tsv":"'1':26,517,557 '10':240 '11':264 '12':286 '13':315 '14':339 '15':357 '2':60,527,563 '3':72,538,568 '4':106,545,574 '5':139 '6':162 '7':178 '8':201 '9':216 'acceleromet':359,492 'access':124,546 'action':66 'activ':80,308 'adapt':250 'add':127 'adjust':206,272,278,445 'alreadi':22 'altern':239,548 'alway':234 'api':215 'app':567 'appear':210 'appl':4,114,140,406 'apple-pencil-and-scribble.md':404 'appropri':157 'ar':366 'area':345 'arkit':611 'ask':11,18,556 'audibl':68 'avail':43 'avoid':214,304 'back':103 'behav':76 'behavior':253,537 'built':117,615 'built-in':116 'button':353,512 'c/v/z':187 'calibr':372,493 'camera':507,510 'camera-control.md':505 'case':122 'casual':566 'check':7 'chip':500 'claude/apple-design-context.md':9 'clear':330 'clickpad':348,484 'cmd':186 'coach':135 'command':195,420 'communic':377 'compon':583,596 'consist':61,77 'constraint':603 'content':391 'context':15,90,614 'control':38,218,220,425,508,552,576 'convent':544 'cover':23 'critic':318 'crown':266,442 'cue':385 'cursor':252,435 'custom':111,189,533,569 'default':232 'design':39,573 'detent':285,447 'develop':621 'devic':562 'digit':265,441 'digital-crown.md':439 'direct':309,380,466,501 'discover':113 'distanc':378 'distinguish':152 'drag':92,401 'draw':143,161 'edg':100,121 'effect':247 'element':328 'elev':335 'essenti':369 'etc':553 'everi':64,326 'exist':14 'expect':169,536 'experi':314,599 'extend':228,427 'eye':36,287,297,450 'eyes.md':448 'fallback':225,430 'feedback':62,283 'feel':245 'field':167 'find':502 'finger':153,158,256 'fit':365 'focus':316,324,329,337,472,476 'focus-and-selection.md':470 'follow':542 'format':516 'full':182 'game':217,364,424,494,575 'game-controls.md':422 'gamepad':229,428 'gaze':306,455 'generous':294 'gestur':74,99,112,131,395,403,438,465,528,534,570,613 'gestures.md':392 'group':338,478 'gyro-and-accelerometer.md':487 'gyroscop':358,491 'hand':37,310,464 'handl':120 'handwrit':412 'haptic':70,282,384,446 'hardwar':511 'hig':2,5,582,595,605 'hig-components-status':581 'hig-components-system':594 'hig-input':1 'hig-technolog':604 'highlight':334 'hint':133 'hit':295,457 'home':104 'hover':151,246,411,434 'immers':313,468 'index':387 'indic':332,477,586 'inform':20 'input':3,6,29,42,65,177,273,463,469,518,547,561,589,602,610 'interact':327,355,486,498,526 'ipado':48,194 'iphon':509 'judici':362 'keep':110,354 'key':24,196,390,421 'keyboard':33,59,179,205,209,213,238,415,419,539 'keyboard-avoid':212 'keyboards.md':413 'launch':514 'layout':207 'less':300 'limit':342 'list':277 'logic':198,336 'long':87,399 'look':291,452 'maco':55 'manipul':311,467 'map':226 'markup':144 'menus':91 'method':30,519 'mfi':219,426 'morph':436 'motion':489 'move':94 'movement':325 'multipl':28 'must':75 'nativ':244 'navig':183,263,280,417,475 'nearbi':497 'nearby-interactions.md':495 'need':578 'non':129 'non-standard':128 'notif':105 'offer':235 'on-screen':222 'one':190 'order':200 'output':515 'overlay':197 'overrid':97 'pan':159 'pencil':34,141,155,160,173,407 'physic':352 'pinch':84,258,293,398 'platform':46,522,559 'plus':188 'pointer':32,53,57,241,248 'pointer/trackpad':433 'pointing-devices.md':431 'precis':142,301,408 'predict':323 'press':88,400 'pressur':148,409 'primari':267 'principl':25 'product':564 'profil':230 'progress':585 'provid':132,371 'proxim':503 'pull':591 'pull-to-refresh':590 'question':12,554 'quick':513 'raintre':617 'raintree.technology':619,623 'recogn':109,119 'recommend':520,541 'refer':386,388 'references/apple-pencil-and-scribble.md':405 'references/camera-control.md':506 'references/digital-crown.md':440 'references/eyes.md':449 'references/focus-and-selection.md':471 'references/game-controls.md':423 'references/gestures.md':393 'references/gyro-and-accelerometer.md':488 'references/keyboards.md':414 'references/nearby-interactions.md':496 'references/pointing-devices.md':432 'references/remotes.md':480 'references/spatial-interactions.md':461 'refresh':593 'relat':579 'remap':429 'remapp':233 'remot':341,481 'remotes.md':479 'reset':374 'respect':202 'respond':587 'respons':71 'scale':333 'screen':224 'scribbl':164 'scroll':257,268,276,443 'scroll/navigate':83 'select':146,350 'sensibl':231 'sensor':490 'shape':249 'shortcut':180,185,416,540 'simpl':356,485 'siri':340,608 'size':459 'skill':580 'skill-hig-inputs' 'softwar':204,418 'source-raintree-technology' 'spatial':289,462,612 'spatial-interactions.md':460 'specif':529 'standard':73,108,130,184,251,531 'status':584 'suit':363 'support':27,49,147,163,577 'surfac':343,483 'sustain':305 'swipe':81,101,261,347,397 'switch':551 'system':98,317,402,473,543,597,598 'tab':199 'tabl':530 'tap':78,396,454 'target':296,456,458 'task':370 'teach':137 'technolog':606,618 'text':166,176 'tilt':149,410 'tool':622 'topic':389 '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' 'touch':31,51,236,303,344,394,482 'track':298,451 'trackpad':243,437 'trigger':504 'tvos':320 'tvos/visionos':474 'two':255 'two-fing':254 'u1':499 'uniqu':601 'use':13,107,211,361 'user':168 'uwb':360,376 'valu':271,279,444 'value-adjust':270 'view':281 'visibl':67,191 'visiono':290,322 'visual':331,382 'voic':35,609 'voiceov':550,607 'watcho':275 'write':171 'zoom':86,260","prices":[{"id":"a12fcd53-ef08-45b8-b4c0-79272bf9936d","listingId":"958b2917-2910-476f-8ffd-3475cf644222","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:10.636Z"}],"sources":[{"listingId":"958b2917-2910-476f-8ffd-3475cf644222","source":"github","sourceId":"raintree-technology/hig-doctor/hig-inputs","sourceUrl":"https://github.com/raintree-technology/hig-doctor/tree/main/skills/hig-inputs","isPrimary":false,"firstSeenAt":"2026-04-18T22:18:10.636Z","lastSeenAt":"2026-05-02T00:57:09.855Z"}],"details":{"listingId":"958b2917-2910-476f-8ffd-3475cf644222","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"raintree-technology","slug":"hig-inputs","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":"f596f73143f06e66898d65ebf96a207991a20a6f","skill_md_path":"skills/hig-inputs/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/raintree-technology/hig-doctor/tree/main/skills/hig-inputs"},"layout":"multi","source":"github","category":"hig-doctor","frontmatter":{"name":"hig-inputs","description":">-"},"skills_sh_url":"https://skills.sh/raintree-technology/hig-doctor/hig-inputs"},"updatedAt":"2026-05-02T00:57:09.855Z"}}