From macOS Notch Apps
Design and implement macOS Dynamic Island / notch-style apps: NSPanel, hardware-aligned geometry, state machine, module widgets (agent monitor, media, HUD, shelf, camera). Use for /macos-notch or notch-style macOS UI.
How this skill is triggered — by the user, by Claude, or both
Slash command
/macos-notch:macos-notchThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Hub skill for designing and implementing **notch-style macOS apps**: a top-center, hardware-aligned black shell that expands into useful modules — Dynamic Island behavior on MacBook displays.
Hub skill for designing and implementing notch-style macOS apps: a top-center, hardware-aligned black shell that expands into useful modules — Dynamic Island behavior on MacBook displays.
Read this file first, then open only the spoke files relevant to the task.
Create a notch utility that feels like display hardware with context, not a floating widget. The closed state should merge with the camera housing (or a centered pill on non-notch displays). The open state grows downward from a pinned top edge with calm spring motion.
NSPanel for the shell — not a titled document window. See foundations.md.layout-and-windowing.md spoke)| If the task involves… | Read |
|---|---|
| OSS landscape, licenses, picking an archetype | ecosystem-landscape.md |
| NSPanel, geometry, shape, state machine | foundations.md |
| Hover, drag, drop, springs, root view | interactions-and-motion.md |
| Closed/open visual language, materials | visual-system.md |
| Now playing / music | module-media-now-playing.md |
| Volume, brightness, system HUD | module-system-hud.md |
| Short-lived peeks and live activity | module-peek-transient.md |
| File drag shelf | module-file-shelf.md |
| Calendar glance | module-calendar-glance.md |
| Camera mirror preview | module-camera-mirror.md |
| Coding-agent session monitor | module-agent-monitor.md |
| Menu bar, prefs, a11y, QA, launch | integration-shipping.md |
| Task | Spokes to read |
|---|---|
| New notch app (MVP) | foundations → interactions-and-motion → visual-system → integration-shipping |
| One module only | foundations (skim) → relevant module-*.md |
| Agent status notch | ecosystem-landscape → foundations → module-agent-monitor → integration-shipping |
| Media + HUD utility | foundations → module-media-now-playing → module-system-hud → module-peek-transient |
| Design critique | visual-system → interactions-and-motion → integration-shipping (checklist) |
| OSS / license question | ecosystem-landscape |
| File | Contents |
|---|---|
| ecosystem-landscape.md | Public repos, taxonomy, GPL note, module map |
| foundations.md | Mental model, file tree, NSPanel, geometry, shape, state |
| interactions-and-motion.md | Root view, hover/tap/drag, animation rules |
| visual-system.md | Closed/open layout, color, materials |
| module-media-now-playing.md | Music module |
| module-system-hud.md | System HUD replacement |
| module-peek-transient.md | Peek kinds, timing, compact chips |
| module-file-shelf.md | File shelf / drop |
| module-calendar-glance.md | Calendar glance |
| module-camera-mirror.md | Camera mirror |
| module-agent-monitor.md | Agent/coding-tool monitor |
| integration-shipping.md | Menu bar, prefs, edge cases, checklist, build order |
appkit-patterns.md — AppKit panels and safe areasaccessibility.md — Reduce Motion, permissionsCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub robzilla1738/roberts-skills --plugin macos-notch