Skip to content
Back to search

platform-design-skills

Platform design skill pack: 300+ rules for Apple HIG, Material Design 3, and WCAG 2.2 across iOS, iPadOS, macOS, watchOS, visionOS, tvOS, Android, and Web.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ehmo-platform-design-skills/badge.svg)](/listings/ehmo-platform-design-skills)

HTML

<a href="/listings/ehmo-platform-design-skills"><img src="/api/listings/ehmo-platform-design-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add ehmo/platform-design-skills

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 157 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Platform Design Skills
  2. Platform design skill pack: 450+ rules for Apple HIG, Material Design 3, and WCAG 2.2 across iOS, iPadOS, macOS, watchOS, visionOS, tvOS, Android, and Web.
  3. Built by scraping the [Apple Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines) (a compiled [PDF version](Apple_HIG.pdf) is included in this repo) and distilling it — along with Material Design 3 and WCAG 2.2 — into succinct but exhaustive skill files. Use them to evaluate, improve, or create your designs.
  4. ## Available Skills
  5. ### ios
  6. Apple Human Interface Guidelines for iPhone. 67+ rules covering navigation, layout, accessibility, gestures, and iOS-specific components like tab bars, sheets, and Dynamic Island.
  7. **Use when:**
  8. - Building SwiftUI or UIKit interfaces for iPhone
  9. - Reviewing iOS app code for HIG compliance
  10. - Choosing between iOS navigation patterns
  11. - Implementing accessibility, Dark Mode, Dynamic Type
  12. ### ipados
  13. Apple HIG for iPad, covering multitasking, pointer support, sidebar navigation, keyboard shortcuts, and Stage Manager. Extends the iOS skill with iPad-specific patterns.
  14. **Use when:**
  15. - Building iPad-optimized interfaces
  16. - Implementing Split View, Slide Over, Stage Manager support
  17. - Adding pointer/trackpad and keyboard shortcut support
  18. - Designing responsive layouts for iPad screen sizes
  19. ### macos
  20. Apple HIG for Mac apps. Covers menu bars, window management, toolbars, keyboard-driven interaction, and the expectations of desktop power users.
  21. **Use when:**
  22. - Building macOS apps with SwiftUI or AppKit
  23. - Implementing menu bars, toolbars, and sidebars
  24. - Adding keyboard shortcuts and window management
  25. - Designing for Catalyst or native macOS
  26. ### watchos
  27. Apple HIG for Apple Watch. Covers glanceable interfaces, Digital Crown, complications, Always On display, and wrist-optimized interactions.
  28. **Use when:**
  29. - Building watchOS apps or complications
  30. - Designing for small screens and short interactions
  31. - Implementing health/fitness features on Watch
  32. ### visionos
  33. Apple HIG for Apple Vision Pro. Covers spatial UI, eye and hand input, windows, volumes, immersive spaces, and ornaments.
  34. **Use when:**
  35. - Building visionOS apps with RealityKit or SwiftUI
  36. - Designing for spatial computing and indirect gestures
  37. - Implementing immersive experiences
  38. ### tvos
  39. Apple HIG for Apple TV. Covers focus-based navigation, Siri Remote, Top Shelf, and living room viewing distances.
  40. **Use when:**
  41. - Building tvOS apps
  42. - Implementing focus-based navigation with Siri Remote
  43. - Designing for 10-foot viewing experiences
  44. ### android
  45. Google Material Design 3 guidelines for Android. Covers Material You, dynamic color, navigation patterns, components, and Android-specific patterns.
  46. **Use when:**
  47. - Building Android apps with Jetpack Compose or XML layouts
  48. - Reviewing Android code for Material Design compliance
  49. - Implementing Material You and dynamic color
  50. - Choosing between Android navigation patterns
  51. ### web
  52. Web platform best practices covering responsive design, accessibility (WCAG), performance, progressive enhancement, and modern CSS/HTML patterns.
  53. **Use when:**
  54. - Building web interfaces with any framework
  55. - Auditing sites for accessibility compliance
  56. - Implementing responsive, performant web layouts
  57. - Reviewing web UI code for best practices
  58. ## Installation
  59. ```bash
  60. npx skills add ehmo/platform-design-skills
  61. ```
  62. ## Contributing (Pull Requests)
  63. - Fork the repository and create a feature branch from the default branch.
  64. - Keep PRs focused to one theme (one platform, one major design area, or one format rule set).
  65. - Update affected skill docs in `skills/<platform>/SKILL.md` and keep `metadata.json` entries aligned when behavior changes.
  66. - If adding or changing rule coverage, ensure:
  67. - platform skill descriptions remain accurate,
  68. - source signals in the skill files are still correct,
  69. - and examples still reflect current platform behavior.
  70. - In the PR description include:
  71. - what changed,
  72. - why this matters for AI output quality,
  73. - and a short before/after usage sample.
  74. - Suggested PR title format: `feat: ...`, `fix: ...`, `docs: ...`.
  75. Example PR checklist:
  76. - [ ] Scope matches the PR title
  77. - [ ] One platform or one rule family per PR
  78. - [ ] No broken relative links in touched files
  79. - [ ] AGENTS/skill assumptions still stated clearly
  80. - [ ] README and skill metadata remain consistent
  81. ## Usage
  82. Skills activate automatically when agents detect platform-relevant tasks.
  83. ```
  84. Review this SwiftUI view for iOS HIG compliance
  85. ```
  86. ```
  87. Check this Android Compose screen against Material Design
  88. ```
  89. ```
  90. Audit this web page for accessibility
  91. ```
  92. ## Skill Structure
  93. Each skill contains:
  94. - `SKILL.md` — Agent instructions with frontmatter metadata
  95. - `metadata.json` — Version, references, and abstract
  96. - `rules/` — Individual rule files with examples
  97. - `AGENTS.md` — Quick context for agent consumption
  98. ## Sources
  99. ### Platform-normative sources
  100. - Apple Human Interface Guidelines (2025) — developer.apple.com/design/human-interface-guidelines
  101. - Material Design 3 — m3.material.io
  102. - Web Content Accessibility Guidelines (WCAG) 2.2 — w3.org/WAI/WCAG22/quickref
  103. - MDN Web Docs — developer.mozilla.org
  104. ### Supporting HCI references
  105. These are secondary references used to sharpen guidance around recognition over recall, visible waiting states, and input effort. They do not override Apple HIG, Material, or WCAG.
  106. - Stuart K. Card, Thomas P. Moran, and Allen Newell, *The Psychology of Human-Computer Interaction* (1983) — https://archive.org/details/psychologyofhuma0000card
  107. - Allen Newell and Stuart K. Card, *Prospects for Psychological Science in Human-Computer Interaction* (includes Model Human Processor summary and operating principles) — https://iiif.library.cmu.edu/file/Newell_box00042_fld03533_doc0001/Newell_box00042_fld03533_doc0001.pdf
  108. - Tiffany Jastrzembski and Neil Charness, *The Model Human Processor and the Older Adult: Parameter Estimation and Validation Within a Mobile Phone Task* (2007 / PMC) — https://pmc.ncbi.nlm.nih.gov/articles/PMC4591021/
  109. - Human Processor Model overview (discovery/reference pointer) — https://en.wikipedia.org/wiki/Human_processor_model
  110. ## License
  111. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.