{
  "schema": "https://ai-atoms.com/schemas/skill-v1.json",
  "type": "skill",
  "id": "skill/hig-components-dialogs",
  "version": "1.0.1",
  "name": "Hig Components Dialogs",
  "description": "Apple HIG guidance for presentation components including alerts, action sheets, popovers, sheets, and digit entry views. Use this skill when the user says \"should I use an alert or a sheet,\" \"how do I show a confirmation dialog,\" \"when should I use a popover,\" \"my modals are annoying users,\" or asks about alert design, action sheet, popover, sheet, modal, dialog, digit entry, confirmation dialog, warning dialog, modal presentation, non-modal content, destructive action confirmation, or overlay UI patterns. Cross-references: hig-components-menus, hig-components-controls, hig-components-search, hig-patterns.",
  "system_prompt_fragment": "# Apple HIG: Presentation 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. **Alerts: sparingly, for critical situations.** Errors needing attention, destructive action confirmations, or information requiring acknowledgment. They interrupt flow and demand a response.\n\n2. **Sheets: focused tasks that maintain context.** Slides in from the edge (or attaches to a window on macOS). Use for creating items, editing settings, multi-step forms.\n\n3. **Popovers: non-modal on iPad and Mac.** Appear next to the trigger element, dismissed by tapping outside. For additional information, options, or controls without taking over the screen.\n\n4. **Action sheets: choosing among actions.** Present when picking from multiple actions, especially if one is destructive. iPhone: slide up from bottom. iPad: appear as popovers.\n\n5. **Minimize interruptions.** Before reaching for a modal, consider inline presentation or making the action undoable instead.\n\n6. **Concise, actionable alert text.** Short descriptive title. Brief message body if needed. Button labels should be specific verbs (\"Delete\", \"Save\"), not \"OK\".\n\n7. **Mark destructive actions clearly.** Destructive button style (red text). Place destructive buttons where users are less likely to tap reflexively.\n\n8. **Provide a cancel option** for alerts and action sheets with multiple actions. On action sheets, cancel appears at the bottom, separated.\n\n9. **Digit entry: focused and accessible.** Appropriately sized input fields, automatic advancement between digits, support for paste and autofill.\n\n10. **Adapt presentation to platform.** The same interaction may use different components on iPhone, iPad, Mac, and visionOS.\n\n## Reference Index\n\n| Reference | Topic | Key content |\n|---|---|---|\n| [alerts.md](references/alerts.md) | Alerts | Button ordering, title/message text, confirmation, destructive actions |\n| [action-sheets.md](references/action-sheets.md) | Action sheets | Multiple actions, cancel option, destructive handling |\n| [popovers.md](references/popovers.md) | Popovers | Non-modal, dismiss on tap outside, iPad/Mac |\n| [sheets.md](references/sheets.md) | Sheets | Modal task, context preservation |\n| [digit-entry-views.md](references/digit-entry-views.md) | Digit entry | PIN input, autofill, auto-advance |\n\n## Output Format\n\n1. **Recommended presentation type with rationale** and why alternatives are less suitable.\n2. **Content guidelines** -- title, message, button labels per Apple's tone and brevity rules.\n3. **Dismiss behavior** -- how the user dismisses and what happens (save, discard, cancel).\n4. **Alternatives** -- when the scenario might not need a modal at all (inline feedback, undo, progressive disclosure).\n\n## Questions to Ask\n\n1. What information or action does the presentation need?\n2. Blocking or non-blocking?\n3. Which platforms?\n4. How often does this appear?\n\n## Related Skills\n\n- **hig-components-menus** -- Buttons and toolbar items triggering presentations\n- **hig-components-controls** -- Input controls within sheets and popovers\n- **hig-components-search** -- Search and navigation within presented views\n- **hig-patterns** -- Modality, interruptions, user flow management\n- **hig-foundations** -- Color, typography, layout for presentation components\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.",
  "applicable_domains": [
    "frontend"
  ],
  "category": "frontend",
  "invocation": [
    "/hig-components-dialogs"
  ],
  "authored_by": "claudeskills.in community",
  "source_url": "https://claudeskills.in/skill/hig-components-dialogs",
  "provenance": {
    "source": "claudeskills.in",
    "source_url": "https://claudeskills.in/skill/hig-components-dialogs",
    "license": "unknown",
    "imported_at": "2026-09-03",
    "notes": "Aggregated by claudeskills.in from community GitHub lists."
  },
  "tags": [
    "claudeskills",
    "frontend"
  ],
  "lifecycle": "draft"
}