Files
antigravity-skills-reference/skills/hig-components-menus/SKILL.md
Ares 4a5f1234bb fix: harden registry tooling, make tests hermetic, and restore metadata consistency (#168)
* chore: upgrade maintenance scripts to robust PyYAML parsing

- Replaces fragile regex frontmatter parsing with PyYAML/yaml library
- Ensures multi-line descriptions and complex characters are handled safely
- Normalizes quoting and field ordering across all maintenance scripts
- Updates validator to strictly enforce description quality

* fix: restore and refine truncated skill descriptions

- Recovered 223+ truncated descriptions from git history (6.5.0 regression)
- Refined long descriptions into concise, complete sentences (<200 chars)
- Added missing descriptions for brainstorming and orchestration skills
- Manually fixed imagen skill description
- Resolved dangling links in competitor-alternatives skill

* chore: sync generated registry files and document fixes

- Regenerated skills index with normalized forward-slash paths
- Updated README and CATALOG to reflect restored descriptions
- Documented restoration and script improvements in CHANGELOG.md

* fix: restore missing skill and align metadata for full 955 count

- Renamed SKILL.MD to SKILL.md in andruia-skill-smith to ensure indexing
- Fixed risk level and missing section in andruia-skill-smith
- Synchronized all registry files for final 955 skill count

* chore(scripts): add cross-platform runners and hermetic test orchestration

* fix(scripts): harden utf-8 output and clone target writeability

* fix(skills): add missing date metadata for strict validation

* chore(index): sync generated metadata dates

* fix(catalog): normalize skill paths to prevent CI drift

* chore: sync generated registry files

* fix: enforce LF line endings for generated registry files
2026-03-01 09:38:25 +01:00

3.9 KiB

name, description, risk, source, date_added
name description risk source date_added
hig-components-menus Apple HIG guidance for menu and button components including menus, context menus, dock menus, edit menus, the menu bar, toolbars, action buttons, pop-up buttons, pull-down buttons, disclosure... unknown community 2026-02-27

Apple HIG: Menus and Buttons

Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.

Key Principles

  1. Menus should be contextual and predictable. Standard items in standard locations. Follow platform conventions for ordering and grouping.

  2. Use standard button styles. System-defined styles communicate affordance and maintain visual consistency. Prefer them over custom designs.

  3. Toolbars for frequent actions. Most commonly used commands in the toolbar. Rarely used actions belong in menus.

  4. Menu bar is the primary command interface on macOS. Every command reachable from the menu bar. Toolbars and context menus supplement, not replace.

  5. 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.

  6. Pop-up buttons for mutually exclusive choices. Select exactly one option from a set.

  7. Pull-down buttons for action lists. No current selection; they offer a set of commands.

  8. Action buttons consolidate related actions behind a single icon in toolbars or title bars.

  9. Disclosure controls for progressive disclosure. Show or hide additional content.

  10. Dock menus: short and focused on the most useful actions when the app is running.

Reference Index

Reference Topic Key content
menus.md General menu design Item ordering, grouping, shortcuts
context-menus.md Context menus Right-click, long press, secondary actions
dock-menus.md Dock menus macOS app-level actions, running state
edit-menus.md Edit menus Undo, copy, paste, standard items
the-menu-bar.md Menu bar macOS primary command interface, structure
toolbars.md Toolbars Frequent actions, customization, placement
buttons.md Buttons System styles, sizing, affordance
action-button.md Action button Grouped secondary actions, toolbar use
pop-up-buttons.md Pop-up buttons Mutually exclusive choice selection
pull-down-buttons.md Pull-down buttons Action lists, no current selection
disclosure-controls.md Disclosure controls Progressive disclosure, show/hide

Output Format

  1. Component recommendation -- which menu or button type and why.
  2. Visual hierarchy -- placement, sizing, grouping within the interface.
  3. Platform-specific behavior across iOS, iPadOS, macOS, visionOS.
  4. Keyboard shortcuts (macOS) -- standard and custom shortcuts for menu items and toolbar actions.

Questions to Ask

  1. Which platforms?
  2. Primary or secondary action?
  3. How many actions need to be available?
  4. macOS menu bar app?
  • hig-components-search -- Search fields, page controls alongside toolbars and menus
  • hig-components-controls -- Toggles, pickers, segmented controls complementing buttons
  • hig-components-dialogs -- Alerts, sheets, popovers triggered by menu items or buttons
  • hig-inputs -- Keyboard shortcuts and pointer interactions with menus and toolbars

Built by Raintree Technology · More developer tools

When to Use

This skill is applicable to execute the workflow or actions described in the overview.