Platform Design Skills

# Platform Design Skills: setup notes

This kit holds setup notes written by Mindket. It does not contain the eight skills, their rule indexes or the Apple HIG PDF that the repository also holds. Those install from ehmo’s repository: https://github.com/ehmo/platform-design-skills

License: MIT. The repository’s LICENSE names no copyright holder after the year 2026. Full text: https://github.com/ehmo/platform-design-skills/blob/main/LICENSE

Platform Design Skills is a community project by ehmo. It is not made or endorsed by Apple, Google, W3C or Anthropic. It distills their public guidelines into rules for coding agents, and the guidelines stay theirs.

The pages these notes came from: the README (https://github.com/ehmo/platform-design-skills/blob/main/README.md), the repository’s AGENTS.md and CHANGELOG.md, and the eight SKILL.md files under https://github.com/ehmo/platform-design-skills/tree/main/skills. The installer’s facts come from the README of the skills command line it names, Vercel Labs’ skills repository (https://github.com/vercel-labs/skills), and from its docs/commands.md and docs/agents.md. Facts about where Claude Code loads skills come from Claude Code’s own skills page (https://code.claude.com/docs/en/skills). Mindket copied every command and ran none of them.

## What it is

Eight skills for coding agents, one per platform. Each holds numbered or coded rules with code in that platform’s language, so an agent can check a screen or write one against them. The README says there are 450+ rules in all.

| Skill name | Platform | Guideline behind it |
|---|---|---|
| ios-design-guidelines | iPhone | Apple Human Interface Guidelines |
| ipados-design-guidelines | iPad | Apple Human Interface Guidelines |
| macos-design-guidelines | Mac | Apple Human Interface Guidelines |
| watchos-design-guidelines | Apple Watch | Apple Human Interface Guidelines |
| visionos-design-guidelines | Apple Vision Pro | Apple Human Interface Guidelines |
| tvos-design-guidelines | Apple TV | Apple Human Interface Guidelines |
| android-design-guidelines | Android | Material Design 3 |
| web-design-guidelines | Web | WCAG 2.2 and MDN |

Source: the repository’s AGENTS.md table, and the name line at the top of each SKILL.md. The README calls the folders ios, ipados, macos, watchos, visionos, tvos, android and web.

## Who does what

- You: run the install line, then ask Claude to build or review a screen in plain words.
- The installer: puts the skill folders where your agent reads them, as links to one shared copy or as separate copies. It is a separate program, not the maker’s.
- Claude (or another agent): reads a skill when your request matches its description, then checks your code against the rules or writes new code that follows them. The rules are text, so nothing in the pack runs code or checks a screen for you.

## Files in this kit

- setup/skills-cli.md: the README’s one install line, and what the installer asks and how to pick skills, scope and agents
- setup/claude-code.md: installing for Claude Code, where the skills land, and checking them
- setup/other-agents.md: Codex, Cursor, Gemini CLI, GitHub Copilot and the other agents the installer names
- setup/first-run.md: the README’s example prompts, what each skill covers, and what to double check

## What you need first

- An agent that reads Agent Skills, such as Claude Code, Codex, Cursor or Gemini CLI.
- Node.js 22.20 or newer, since the installer’s README says so. The install line runs through npx.
- A project in git or a plain folder, if you want a project-only install. A global install needs none.
- No account, no API key and no other software for the pack.

## What installs where

- Project install, the installer’s default: the skill folders go in your project, in the agent’s own skills folder. For Claude Code that is .claude/skills/.
- Global install, with the -g option: the folders go in your home directory. For Claude Code that is ~/.claude/skills/.
- Each skill folder holds a SKILL.md with the rules, a metadata.json, an AGENTS.md and a rules folder. The repository’s AGENTS.md says that folder holds _sections.md, an index of the rules by category.

## Your data

The skills are text. They tell the agent what the guidelines say and send nothing anywhere. The installer downloads the repository from GitHub. Its README says it collects anonymous usage data, and that setting DISABLE_TELEMETRY=1 or DO_NOT_TRACK=1 turns that off. What you give Claude, such as your code and screenshots, goes to Claude as in any other Claude work.

## Update and remove

The maker’s README gives no update or removal step. The installer’s README gives npx skills update and npx skills remove, shown in setup/skills-cli.md.

README.md  5 KB
setup/claude-code.md  3 KB
setup/first-run.md  4 KB
setup/other-agents.md  2 KB
setup/skills-cli.md  3 KB