hig-components-system
Helps your agent design Apple system components like widgets and notifications. Useful for creating consistent experiences across different Apple devices.
What it does
Helps decide where and how to show important information from your app outside of it, like in widgets, notifications, or shortcuts, following Apple's guidelines.
When to use it
- ✓When you want your app to show quick info on the lock screen.
- ✓When creating notifications that users can act on without opening the app.
- ✓To define shortcuts that appear in search or for Siri.
Example of what to ask your AI
“I want to show my order status in real-time on the iPhone lock screen. What should I use?”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
The AI analyzes which part of your app (widget, notification, etc.) is best for showing information outside the app. It considers where the information appears and how the user will interact with it.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add sickn33/agentic-awesome-skills --skill hig-components-systemOr download just the file:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/hig-components-system/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
Apple HIG: System Experiences
Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.
Key Principles
General
Glanceable, immediate value. System experiences bring your app's most important content to surfaces the user sees without launching your app. Design for seconds of attention.
Respect platform context. A Lock Screen widget has different constraints than a Home Screen widget. A complication is far smaller than a top shelf item.
Widgets
Show relevant information, not everything. Display the most useful subset, updated appropriately.
Support multiple sizes with distinct layouts. Each size should be a thoughtful design, not a scaled version of another.
Deep-link on tap. Take users to the relevant content, not the app's root screen.
Live Activities
Track events with a clear start and end. Deliveries, scores, timers, rides. Design for both Dynamic Island and Lock Screen.
Stay updated and timely. Stale data undermines trust. End promptly when the event concludes.
Notifications
Respect user attention. Only send notifications for information users genuinely care about. No promotional or low-value notifications.
Actionable and self-contained. Include enough context to understand and act without opening the app. Support notification actions. Use threading and grouping.
Complications
- Focused data on the watch face. Design for the smallest useful representation. Support multiple families. Budget updates wisely.
Home Screen Quick Actions
- 3-4 most common tasks. Short titles, optional subtitles, relevant SF Symbol icons.
Top Shelf
- tvOS showcase. Feature content that entices: new episodes, featured items, recent content.
App Clips
- Instant, focused functionality within a strict size budget. Load quickly without App Store download. Only what's needed for the immediate task, then offer full app install.
App Shortcuts
- Surface key actions to Siri and Spotlight. Define shortcuts for frequent tasks. Use natural, conversational trigger phrases.
Reference Index
| Reference | Topic | Key content |
|---|---|---|
| widgets.md | Widgets | Glanceable info, sizes, deep linking, timeline |
| live-activities.md | Live Activities | Real-time tracking, Dynamic Island, Lock Screen |
| notifications.md | Notifications | Attention, actions, grouping, content |
| complications.md | Complications | Watch face data, families, budgeted updates |
| home-screen-quick-actions.md | Quick actions | Haptic Touch, common tasks, SF Symbols |
| top-shelf.md | Top shelf | Featured content, showcase |
| app-clips.md | App Clips | Instant use, lightweight, focused task, NFC/QR |
| watch-faces.md | Watch faces | Custom complications, face sharing |
| app-shortcuts.md | App Shortcuts | Siri, Spotlight, voice triggers |
Output Format
- System experience recommendation -- which surface best fits the use case.
- Content strategy -- what to display, priority, what to omit.
- Update frequency -- refresh rate including system budget constraints.
- Size/family variants -- which to support and how layout adapts.
- Deep link behavior -- where tapping takes the user.
Questions to Ask
- What information needs to surface outside the app?
- Which platform?
- How frequently does the data update?
- What is the primary glanceable need?
Related Skills
- hig-components-status -- Progress indicators in widgets or Live Activities
- hig-inputs -- Interaction patterns for system experiences (Digital Crown for complications)
- hig-technologies -- Siri for App Shortcuts, HealthKit for complications, NFC for App Clips
Built by Raintree Technology · More developer tools
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
Example
User request:
…
FAQ
What are 'System Experiences'?
These are ways to display your app's information outside of the app itself, such as on home screen widgets or notifications.
Why follow Apple's guidelines (HIG)?
To ensure your app works well and looks familiar on Apple devices, providing a good user experience.
What does 'Glanceable, immediate value' mean?
It means the information shown should be useful and easy to understand quickly, without the user having to put in much effort.
Details
Original description by the author
Apple HIG guidance for system experience components: widgets, live activities, notifications, complications, home screen quick actions, top shelf, watch faces, app clips, and app shortcuts.
Popularity
- GitHub stars
- 48k
- Ranking position
- #3203
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
00-andruia-consultant
Helps your agent start or improve AI projects. It analyzes code, suggests tools, and creates action plans in Spanish.
sickn33/agentic-awesome-skills
007
Lets your agent perform security audits and threat modeling. It's useful for protecting projects against attacks and vulnerabilities.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Helps your agent create or improve AI tools. It defines how tools work, writes documentation, and validates the structure.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Lets your agent create a summary about a specific industry. It's useful for understanding the context, rules, usage patterns, and risks of a project, using reliable sources.
sickn33/agentic-awesome-skills
Similar skills
accessibility
Helps your agent create interfaces that everyone can use. Ensures websites and apps work well for people with disabilities, like those who are blind or have reduced mobility.
affaan-m/ECC
design-system
Helps your agent create a design system from existing code. It extracts visual information and checks for consistency, generating a report and an interactive preview.
affaan-m/ECC
liquid-glass-design
Helps your agent create iOS user interfaces with a 'Liquid Glass' effect. Allows adding dynamic and interactive visual effects in SwiftUI and UIKit.
affaan-m/ECC