{"id":"acc5c146-bdc8-4ae2-b132-4fedeac290c4","shortId":"HrmH55","kind":"skill","title":"hig-components-menus","tagline":">-","description":"# Apple HIG: Menus and Buttons\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. **Menus should be contextual and predictable.** Standard items in standard locations. Follow platform conventions for ordering and grouping.\n\n2. **Use standard button styles.** System-defined styles communicate affordance and maintain visual consistency. Prefer them over custom designs.\n\n3. **Toolbars for frequent actions.** Most commonly used commands in the toolbar. Rarely used actions belong in menus.\n\n4. **Menu bar is the primary command interface on macOS.** Every command reachable from the menu bar. Toolbars and context menus supplement, not replace.\n\n5. **Context menus for secondary actions.** Right-click or long-press, relevant to the item under the pointer. Never put a command only in a context menu.\n\n6. **Pop-up buttons for mutually exclusive choices.** Select exactly one option from a set.\n\n7. **Pull-down buttons for action lists.** No current selection; they offer a set of commands.\n\n8. **Action buttons consolidate related actions** behind a single icon in toolbars or title bars.\n\n9. **Disclosure controls for progressive disclosure.** Show or hide additional content.\n\n10. **Dock menus: short and focused** on the most useful actions when the app is running.\n\n## Reference Index\n\n| Reference | Topic | Key content |\n|---|---|---|\n| [menus.md](references/menus.md) | General menu design | Item ordering, grouping, shortcuts |\n| [context-menus.md](references/context-menus.md) | Context menus | Right-click, long press, secondary actions |\n| [dock-menus.md](references/dock-menus.md) | Dock menus | macOS app-level actions, running state |\n| [edit-menus.md](references/edit-menus.md) | Edit menus | Undo, copy, paste, standard items |\n| [the-menu-bar.md](references/the-menu-bar.md) | Menu bar | macOS primary command interface, structure |\n| [toolbars.md](references/toolbars.md) | Toolbars | Frequent actions, customization, placement |\n| [buttons.md](references/buttons.md) | Buttons | System styles, sizing, affordance |\n| [action-button.md](references/action-button.md) | Action button | Grouped secondary actions, toolbar use |\n| [pop-up-buttons.md](references/pop-up-buttons.md) | Pop-up buttons | Mutually exclusive choice selection |\n| [pull-down-buttons.md](references/pull-down-buttons.md) | Pull-down buttons | Action lists, no current selection |\n| [disclosure-controls.md](references/disclosure-controls.md) | Disclosure controls | Progressive disclosure, show/hide |\n\n## Output Format\n\n1. **Component recommendation** -- which menu or button type and why.\n2. **Visual hierarchy** -- placement, sizing, grouping within the interface.\n3. **Platform-specific behavior** across iOS, iPadOS, macOS, visionOS.\n4. **Keyboard shortcuts** (macOS) -- standard and custom shortcuts for menu items and toolbar actions.\n\n## Questions to Ask\n\n1. Which platforms?\n2. Primary or secondary action?\n3. How many actions need to be available?\n4. macOS menu bar app?\n\n## Related Skills\n\n- **hig-components-search** -- Search fields, page controls alongside toolbars and menus\n- **hig-components-controls** -- Toggles, pickers, segmented controls complementing buttons\n- **hig-components-dialogs** -- Alerts, sheets, popovers triggered by menu items or buttons\n- **hig-inputs** -- Keyboard shortcuts and pointer interactions with menus and toolbars\n\n---\n\n*Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)*","tags":["hig","components","menus","doctor","raintree-technology","accessibility","agent-skills","ai-agents","apple","apple-design","audit","claude-code"],"capabilities":["skill","source-raintree-technology","skill-hig-components-menus","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-menus","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 (3,584 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.420Z","embedding":null,"createdAt":"2026-04-18T22:18:06.857Z","updatedAt":"2026-05-02T00:57:09.420Z","lastSeenAt":"2026-05-02T00:57:09.420Z","tsv":"'1':29,322,368 '10':198 '2':48,332,371 '3':68,341,376 '4':86,351,384 '5':110 '6':139 '7':155 '8':172 '9':187 'across':346 'action':72,82,115,161,173,177,208,239,248,273,285,289,308,364,375,379 'action-button.md':283 'addit':196 'afford':58,282 'alert':417 'alongsid':399 'alreadi':25 'app':211,246,388 'app-level':245 'appl':5 'ask':14,21,367 'avail':383 'bar':88,102,186,263,387 'behavior':345 'behind':178 'belong':83 'built':438 'button':9,51,143,159,174,278,286,297,307,328,412,425 'buttons.md':276 'check':10 'choic':147,300 'claude/apple-design-context.md':12 'click':118,235 'command':76,92,97,133,171,266 'common':74 'communic':57 'complement':411 'compon':3,323,393,405,415 'consist':62 'consolid':175 'content':197,219 'context':18,105,111,137,231 'context-menus.md':229 'contextu':33 'control':189,316,398,406,410 'convent':43 'copi':256 'cover':26 'current':164,311 'custom':66,274,357 'defin':55 'design':67,224 'develop':444 'dialog':416 'disclosur':188,192,315,318 'disclosure-controls.md':313 'dock':199,242 'dock-menus.md':240 'edit':253 'edit-menus.md':251 'everi':96 'exact':149 'exclus':146,299 'exist':17 'field':396 'focus':203 'follow':41 'format':321 'frequent':71,272 'general':222 'group':47,227,287,337 'hide':195 'hierarchi':334 'hig':2,6,392,404,414,427 'hig-components-control':403 'hig-components-dialog':413 'hig-components-menus':1 'hig-components-search':391 'hig-input':426 'icon':181 'index':215 'inform':23 'input':428 'interact':433 'interfac':93,267,340 'io':347 'ipado':348 'item':37,126,225,259,361,423 'key':27,218 'keyboard':352,429 'level':247 'list':162,309 'locat':40 'long':121,236 'long-press':120 'maco':95,244,264,349,354,385 'maintain':60 'mani':378 'menu':87,101,138,223,262,326,360,386,422 'menus':4,7,30,85,106,112,200,232,243,254,402,435 'menus.md':220 'mutual':145,298 'need':380 'never':130 'offer':167 'one':150 'option':151 'order':45,226 'output':320 'page':397 'past':257 'picker':408 'placement':275,335 'platform':42,343,370 'platform-specif':342 'pointer':129,432 'pop':141,295 'pop-up':140,294 'pop-up-buttons.md':292 'popov':419 'predict':35 'prefer':63 'press':122,237 'primari':91,265,372 'principl':28 'progress':191,317 'pull':157,305 'pull-down':156,304 'pull-down-buttons.md':302 'put':131 'question':15,365 'raintre':440 'raintree.technology':442,446 'rare':80 'reachabl':98 'recommend':324 'refer':214,216 'references/action-button.md':284 'references/buttons.md':277 'references/context-menus.md':230 'references/disclosure-controls.md':314 'references/dock-menus.md':241 'references/edit-menus.md':252 'references/menus.md':221 'references/pop-up-buttons.md':293 'references/pull-down-buttons.md':303 'references/the-menu-bar.md':261 'references/toolbars.md':270 'relat':176,389 'relev':123 'replac':109 'right':117,234 'right-click':116,233 'run':213,249 'search':394,395 'secondari':114,238,288,374 'segment':409 'select':148,165,301,312 'set':154,169 'sheet':418 'short':201 'shortcut':228,353,358,430 'show':193 'show/hide':319 'singl':180 'size':281,336 'skill':390 'skill-hig-components-menus' 'source-raintree-technology' 'specif':344 'standard':36,39,50,258,355 'state':250 'structur':268 'style':52,56,280 'supplement':107 'system':54,279 'system-defin':53 'technolog':441 'the-menu-bar.md':260 'titl':185 'toggl':407 'tool':445 'toolbar':69,79,103,183,271,290,363,400,437 'toolbars.md':269 'topic':217 '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' 'trigger':420 'type':329 'undo':255 'use':16,49,75,81,207,291 'visiono':350 'visual':61,333 'within':338","prices":[{"id":"04893528-cba7-4ede-8297-21bf95ca9b41","listingId":"acc5c146-bdc8-4ae2-b132-4fedeac290c4","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:06.857Z"}],"sources":[{"listingId":"acc5c146-bdc8-4ae2-b132-4fedeac290c4","source":"github","sourceId":"raintree-technology/hig-doctor/hig-components-menus","sourceUrl":"https://github.com/raintree-technology/hig-doctor/tree/main/skills/hig-components-menus","isPrimary":false,"firstSeenAt":"2026-04-18T22:18:06.857Z","lastSeenAt":"2026-05-02T00:57:09.420Z"}],"details":{"listingId":"acc5c146-bdc8-4ae2-b132-4fedeac290c4","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"raintree-technology","slug":"hig-components-menus","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":"68305e7d1696d3dcabc10d51ffde3e5b3a001ba4","skill_md_path":"skills/hig-components-menus/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/raintree-technology/hig-doctor/tree/main/skills/hig-components-menus"},"layout":"multi","source":"github","category":"hig-doctor","frontmatter":{"name":"hig-components-menus","description":">-"},"skills_sh_url":"https://skills.sh/raintree-technology/hig-doctor/hig-components-menus"},"updatedAt":"2026-05-02T00:57:09.420Z"}}