Skip to content
SkillMixed6,857 tokens in use

Apple Design Skill

A design reviewer for agents, grounded in 123 Apple Human Interface Guidelines pages, for iOS, macOS, Flutter, React Native, Tauri and Electron apps.

3,645 stars on the repositorydickwu/apple-design-skill
npx skills add dickwu/apple-design-skill
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing Apple Design Skill costs

248tokens idle
6,857tokens in use
25,096tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Mixed

Script-ledMixedModel-led

Scripts do part of the work and the model's judgement does the rest.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/pull-hig.mjs.

Touches

networkdetectedwrites filesdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter8/15
  • Structure25/25
  • Examples9/15
  • Output15/15
  • Size11/15
  • Resources14/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Fair
  • File that was not read−15

    a file the skill ships that was not read, so what it does is unknown

    .cursorrules
  • Hidden characters−20

    characters that render as nothing or reorder the text

    references/hig/icons.md, line 87
  • Reaches the network−10

    does this on the machine, and the frontmatter does not say so

    scripts/pull-hig.mjs, line 141
  • Writes files−8

    does this on the machine, and the frontmatter does not say so

    scripts/pull-hig.mjs, line 146

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity84
  • Maintenance40
  • Community48
  • Maturity32
  • Momentum40

Apple Design Skill turns an agent into a UI reviewer that reads Apple’s Human Interface Guidelines before it judges a screen. It carries 123 guideline pages from developer.apple.com plus a curated Liquid Glass guide, and translates Apple’s vocabulary for SwiftUI, UIKit, AppKit, Flutter, React Native, Tauri and Electron.

A review runs through five lenses in order: accessibility, platform conventions, visual craft, interaction and writing. Each finding gives what is wrong, the guideline file and heading that supports it, and a fix in your framework. A craft lens also asks whether the design has a point of view or looks like a template.

What You Get

  • A structured design review with Summary, Critical, Improvements, Craft notes, What works and Platform notes sections
  • Citations to the guideline file and heading, such as buttons.md under Style, for every finding
  • Measured numbers for contrast, type size and control size in each finding
  • Specialized modes for app icons, dark mode, Liquid Glass, Apple Pay, navigation, iPhone Duo, onboarding, forms, generative AI and widgets
  • An improvement mode that plans a compact token system and a signature element before proposing fixes

Common Use Cases

  • Review a Flutter or React Native screen against iOS conventions
  • Audit a Tauri or Electron app for macOS conventions and accessibility
  • Check a repository for Apple Pay buttons that App Review would reject
  • Make a generic-looking interface more distinctive without breaking platform patterns
  • Check a layout for the two-display iPhone Duo

What Makes It Unique

The guidelines are stored in the skill as Markdown pages in Apple’s own wording, so the agent quotes them from the file it opened. A routing table names which pages to load for what is on screen, and a heritage file traces each current principle to Apple’s archived guidance from 1980 to 2014 and lists advice that has since been replaced. The craft lens names three looks that dominate generated interfaces and asks whether a design chose its palette and type for a reason.

Under The Hood

The agent works from the files in the skill: SKILL.md, the references folder with the guideline pages, a cross-platform translation file, a code-audit file and a heritage file. For a code audit it searches your source with grep-style commands and reads each match. The repository also holds a Node script that re-downloads the guidelines from Apple’s site, about 170 requests, and rewrites the reference files; it is for maintainers and a review does not need it. Without that script the skill reads files and runs nothing on its own.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers