Macos notch
Skill robzilla1738/roberts-skills/plugins/macos-notch/skills/macos-notch
Provider-agnostic agent skills and plugins for AI coding assistants. By Robert Courson.
npx -y skills add robzilla1738/roberts-skills --skill macos-notchAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
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.
SKILL.md
5.8 KB, as published. Nobody here has run it
macOS Notch
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.
Mission
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.
Non-negotiables
- Use a transparent nonactivating
NSPanelfor the shell — not a titled document window. See foundations.md. - Separate AppKit positioning from SwiftUI content — geometry and screen changes stay out of views.
- State machine over boolean soup — closed, peek, open, expanded, dragging. See foundations.md and module-peek-transient.md.
- Black closed shell — no translucent glass on the hardware edge. See visual-system.md.
- Menu bar fallback — notch may be unavailable on external displays. See integration-shipping.md.
- GPL caution — TheBoredTeam/boring.notch is GPL-3.0. Study patterns via ecosystem-landscape.md; do not copy source into proprietary apps without compliance.
- Not physical-notch masking — hiding the hardware notch (znotch-style) is a different product category. See ecosystem-landscape.md.
When to use this skill
- Building or reviewing a Dynamic Island / notch utility for macOS
- Adding a module (media, HUD, shelf, agents, camera) to an existing notch app
- Auditing alignment, hover timing, or focus-stealing behavior
When not to use
- Standard document-based macOS apps — see the macos-design skill (its
layout-and-windowing.mdspoke) - Hiding the physical notch without a panel app — see ecosystem-landscape.md
- Linux/GNOME notch clones — out of scope
Topic router
| 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 |
Common task bundles
| 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 |
Spoke index
| 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 |
Related skills
- the macos-design skill (separate plugin) — general native macOS design (windows, HIG, Liquid Glass)
- macos-design spoke
appkit-patterns.md— AppKit panels and safe areas - macos-design spoke
accessibility.md— Reduce Motion, permissions