{"id":"f8c47861-44b7-474a-aac7-854131185e42","shortId":"mcggA4","kind":"skill","title":"hig-components-search","tagline":">-","description":"# Apple HIG: Navigation Components\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. **Search: discoverable with instant feedback.** Place search fields where users expect them (top of list, toolbar/navigation bar). Show results as the user types.\n\n2. **Page controls: position in a flat page sequence.** For discrete, equally weighted pages (onboarding, photo gallery). Show current page and total count.\n\n3. **Path controls: file hierarchy navigation.** macOS path controls display location within a directory structure and allow jumping to any ancestor.\n\n4. **Search scopes narrow large result sets.** Provide scope buttons so users can filter without complex queries.\n\n5. **Clear empty states for search.** Helpful message suggesting corrections or alternatives, not a blank screen.\n\n6. **Page controls are not for hierarchical navigation.** Flat, linear sequences only. Use navigation controllers, tab bars, or sidebars for hierarchy.\n\n7. **Keep path controls concise.** Show meaningful segments only. Users can click any segment to navigate directly.\n\n8. **Support keyboard for search.** Command-F and system search shortcuts should activate search.\n\n## Reference Index\n\n| Reference | Topic | Key content |\n|---|---|---|\n| [search-fields.md](references/search-fields.md) | Search fields | Scopes, tokens, instant results, placement |\n| [page-controls.md](references/page-controls.md) | Page controls | Dot indicators, flat page sequences |\n| [path-controls.md](references/path-controls.md) | Path controls | Breadcrumbs, ancestor navigation |\n\n## Output Format\n\n1. **Component recommendation** -- search field, page control, or path control, and why.\n2. **Behavior specification** -- interaction model (search-as-you-type, swipe for pages, click-to-navigate for paths).\n3. **Platform differences** across iOS, iPadOS, macOS, visionOS.\n\n## Questions to Ask\n\n1. What type of content is being searched or navigated?\n2. Which platforms?\n3. How large is the dataset?\n4. Is search the primary interaction?\n\n## Related Skills\n\n- **hig-components-menus** -- Toolbars and menu bars hosting search and navigation controls\n- **hig-components-controls** -- Text fields, pickers, segmented controls in search interfaces\n- **hig-components-dialogs** -- Popovers and sheets for expanded search or filtering\n- **hig-patterns** -- Navigation patterns and information architecture\n- **hig-foundations** -- Typography and layout for navigation components\n\n---\n\n*Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)*","tags":["hig","components","search","doctor","raintree-technology","accessibility","agent-skills","ai-agents","apple","apple-design","audit","claude-code"],"capabilities":["skill","source-raintree-technology","skill-hig-components-search","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-components-search","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 (2,677 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.506Z","embedding":null,"createdAt":"2026-04-18T22:18:07.628Z","updatedAt":"2026-05-02T00:57:09.506Z","lastSeenAt":"2026-05-02T00:57:09.506Z","tsv":"'1':28,215,257 '2':52,227,267 '3':75,246,270 '4':96,276 '5':113 '6':129 '7':150 '8':167 'across':249 'activ':180 'allow':91 'alreadi':24 'altern':124 'ancestor':95,211 'appl':5 'architectur':328 'ask':13,20,256 'bar':45,145,291 'behavior':228 'blank':127 'breadcrumb':210 'built':338 'button':105 'check':9 'claude/apple-design-context.md':11 'clear':114 'click':161,241 'click-to-navig':240 'command':173 'command-f':172 'complex':111 'compon':3,8,216,286,299,311,337 'concis':154 'content':187,261 'context':17 'control':54,77,83,131,143,153,200,209,221,224,296,300,305 'correct':122 'count':74 'cover':25 'current':70 'dataset':275 'develop':344 'dialog':312 'differ':248 'direct':166 'directori':88 'discover':30 'discret':62 'display':84 'dot':201 'empti':115 'equal':63 'exist':16 'expand':317 'expect':39 'f':174 'feedback':33 'field':36,191,219,302 'file':78 'filter':109,320 'flat':58,137,203 'format':214 'foundat':331 'galleri':68 'help':119 'hierarch':135 'hierarchi':79,149 'hig':2,6,285,298,310,322,330 'hig-components-control':297 'hig-components-dialog':309 'hig-components-menus':284 'hig-components-search':1 'hig-found':329 'hig-pattern':321 'host':292 'index':183 'indic':202 'inform':22,327 'instant':32,194 'interact':230,281 'interfac':308 'io':250 'ipado':251 'jump':92 'keep':151 'key':26,186 'keyboard':169 'larg':100,272 'layout':334 'linear':138 'list':43 'locat':85 'maco':81,252 'meaning':156 'menu':290 'menus':287 'messag':120 'model':231 'narrow':99 'navig':7,80,136,142,165,212,243,266,295,324,336 'onboard':66 'output':213 'page':53,59,65,71,130,199,204,220,239 'page-controls.md':197 'path':76,82,152,208,223,245 'path-controls.md':206 'pattern':323,325 'photo':67 'picker':303 'place':34 'placement':196 'platform':247,269 'popov':313 'posit':55 'primari':280 'principl':27 'provid':103 'queri':112 'question':14,254 'raintre':340 'raintree.technology':342,346 'recommend':217 'refer':182,184 'references/page-controls.md':198 'references/path-controls.md':207 'references/search-fields.md':189 'relat':282 'result':47,101,195 'scope':98,104,192 'screen':128 'search':4,29,35,97,118,171,177,181,190,218,233,264,278,293,307,318 'search-as-you-typ':232 'search-fields.md':188 'segment':157,163,304 'sequenc':60,139,205 'set':102 'sheet':315 'shortcut':178 'show':46,69,155 'sidebar':147 'skill':283 'skill-hig-components-search' 'source-raintree-technology' 'specif':229 'state':116 'structur':89 'suggest':121 'support':168 'swipe':237 'system':176 'tab':144 'technolog':341 'text':301 'token':193 'tool':345 'toolbar':288 'toolbar/navigation':44 'top':41 'topic':185 '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' 'total':73 'type':51,236,259 'typographi':332 'use':15,141 'user':38,50,107,159 'visiono':253 'weight':64 'within':86 'without':110","prices":[{"id":"8b147e7c-01a5-4ef9-bc3f-c6694fe7a8db","listingId":"f8c47861-44b7-474a-aac7-854131185e42","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:07.628Z"}],"sources":[{"listingId":"f8c47861-44b7-474a-aac7-854131185e42","source":"github","sourceId":"raintree-technology/hig-doctor/hig-components-search","sourceUrl":"https://github.com/raintree-technology/hig-doctor/tree/main/skills/hig-components-search","isPrimary":false,"firstSeenAt":"2026-04-18T22:18:07.628Z","lastSeenAt":"2026-05-02T00:57:09.506Z"}],"details":{"listingId":"f8c47861-44b7-474a-aac7-854131185e42","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"raintree-technology","slug":"hig-components-search","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":"7804f7ffb32698c74b2c2b06220aaf1e285d7870","skill_md_path":"skills/hig-components-search/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/raintree-technology/hig-doctor/tree/main/skills/hig-components-search"},"layout":"multi","source":"github","category":"hig-doctor","frontmatter":{"name":"hig-components-search","description":">-"},"skills_sh_url":"https://skills.sh/raintree-technology/hig-doctor/hig-components-search"},"updatedAt":"2026-05-02T00:57:09.506Z"}}