rlaope/oh-my-hermes / .claude/agent-skills/omh-apple-design
omh-apple-design
Verified[omh] Designing or reviewing an iOS, macOS or Apple UI.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.3 KB |
| references/materials-and-accessibility.md | markdown | 2.4 KB |
| references/platform-foundations.md | markdown | 2.8 KB |
| references/product-visual-production.md | markdown | 5.0 KB |
| references/review-playbook.md | markdown | 2.4 KB |
| references/web-production-libraries.md | markdown | 4.4 KB |
references/platform-foundations.md
View on GitHub# Apple Platform Foundations
## Source record
- Apple guidance, accessed 2026-09-05: https://developer.apple.com/design/human-interface-guidelines/
- Apple guidance, accessed 2026-09-05: https://developer.apple.com/design/human-interface-guidelines/designing-for-ios
- Apple guidance, accessed 2026-09-05: https://developer.apple.com/design/human-interface-guidelines/designing-for-ipados
- Apple guidance, accessed 2026-09-05: https://developer.apple.com/design/human-interface-guidelines/designing-for-macos
- Apple guidance, accessed 2026-09-05: https://developer.apple.com/tutorials/data/design/human-interface-guidelines/typography.json
- Apple guidance, accessed 2026-09-05: https://developer.apple.com/sf-symbols/
- Apple guidance, accessed 2026-09-05: https://developer.apple.com/fonts/
## Frame the brief first
Record mode (`design`, `review`, or `improve`), target OS and current version,
framework, input method, surface and state, current brand/design tokens, and
whether the result is native Apple, Apple-inspired web, or another platform.
Treat a supplied screen, capture, or code path as an **observation** only for
what it shows; label any inferred intent or user behavior as a **hypothesis**.
Make two to four directions before visual production when no direction is
already selected.
## Native iOS and iPadOS
Prefer current system controls and semantic, adaptive colors over manually
recreated controls or hard-coded appearances. Use text styles and Dynamic Type
on iOS and iPadOS; design safe-area, adaptive-window, navigation, keyboard,
pointer, and VoiceOver behavior around the actual target. Standard SwiftUI,
UIKit, and AppKit components follow current SDK behavior, so avoid manual
backgrounds that fight them. Check current API availability for the deployed
platform rather than making a future-version assertion.
## macOS
macOS does **not** support Dynamic Type. Use macOS system styles, application
text-scaling choices, and adaptive layout instead. Keep menu, keyboard,
pointer, window, and VoiceOver behavior native to the selected macOS target;
do not transplant iOS interaction assumptions into a Mac window.
## Apple-inspired web
This is inspiration, not native equivalence. Use system-font fallbacks rather
than embedding system fonts; use appropriately licensed icons rather than
assuming SF Symbols license coverage. Require responsive reflow and zoom,
semantic HTML, visible focus, WCAG review, reduced-motion and
reduced-transparency behavior, and an opaque fallback. Do not equate points
with CSS pixels or prescribe one universal spacing, type, or blur recipe.
## Boundary
This reference covers iOS, iPadOS, macOS, and Apple-inspired web first. Route
other Apple targets to their current official platform documentation. A brief
or direction is prepared guidance, not observed implementation, accessibility
PASS, visual PASS, or Apple certification.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |