platform-design-skills — Claude Code skill for interface design
platform-design-skills is a Claude Code skill for creating and reviewing interfaces against Apple HIG, Material Design 3, and WCAG 2.2. It includes guidance for eight platforms.
MIT 207 installs ★ 35 updated 2026-10-21
npx skills add podo/design-agent-skills --skill platform-design-skills -a claude-codeWhat platform-design-skills does
The package contains separate skills for iOS, iPadOS, macOS, watchOS, visionOS, tvOS, Android, and the web. They cover platform conventions such as navigation, touch target sizing, typography, component behavior, and accessibility.
Install the complete set or select skill names after --skill. For Claude Code, run npx skills add podo/design-agent-skills --skill platform-design-skills -a claude-code. There is a naming collision between web-design-guidelines and the skill of the same name from vercel-skills; installing both overwrites one of them. This package does not provide deep SwiftUI implementation guidance.
What it helps with
- Check whether navigation fits a target platform
- Choose suitable touch target sizes
- Align typography and component behavior with platform conventions
- Review web and mobile interfaces for accessibility requirements
Example prompts for the agent
- Review this iOS screen against Apple HIG.
- Suggest Android navigation and touch target sizes for this app.
- Check this web page against WCAG 2.2 accessibility guidance.
How to install platform-design-skills
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill platform-design-skills -a claude-code2Manually: put the files in place
~/.claude/skills/platform-design-skills/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/platform-design-skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill platform-design-skills -a codex2Manually: put the files in place
.agents/skills/platform-design-skills/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill platform-design-skills -a cursor2Manually: put the files in place
.cursor/skills/platform-design-skills/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/platform-design-skills2Manually: put the files in place
.github/skills/platform-design-skills/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill platform-design-skills -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/platform-design-skillsManually: put the files in place
.devin/skills/platform-design-skills/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill platform-design-skills -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about platform-design-skills
How do I install platform-design-skills in Claude Code?
Run npx skills add podo/design-agent-skills --skill platform-design-skills -a claude-code. The skill is placed at ~/.claude/skills/platform-design-skills/SKILL.md.
What does platform-design-skills do?
It helps an agent create or assess interfaces using Apple HIG, Material Design 3, and WCAG 2.2 guidance. The package provides a separate skill for each supported platform.
Which platforms does platform-design-skills cover?
It includes iOS, iPadOS, macOS, watchOS, visionOS, tvOS, Android, and the web, with a dedicated skill for each.
Source text
SKILL.md · MIT
--- name: platform-design-skills description: | Design rules from Apple HIG, Material Design 3, and WCAG 2.2 for cross-platform apps, one skill per platform: iOS, iPadOS, macOS, watchOS, visionOS, tvOS, Android, and web accessibility and platform conventions. triggers: - "platform design" - "Apple HIG rules" - "Material Design" - "cross-platform design" - "platform conventions" - "HIG guidelines" - "MD3 design" das: category: visual-components upstream: "https://github.com/ehmo/platform-design-skills" version: latest install: false --- # platform-design-skills > Catalogue stub — full package: [ehmo/platform-design-skills](https://github.com/ehmo/platform-design-skills) <!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block --> ## Decision tree 1. **Is the full skill already installed?** This package installs 8 skills (`ios-design-guidelines`, `ipados-design-guidelines`, `macos-design-guidelines`, `watchos-design-guidelines`, `visionos-design-guidelines`, `tvos-design-guidelines`, `android-design-guidelines`, `web-design-guidelines`); checking the first. - Global: `f=~/.agents/skills/ios-design-guidelines/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/ios-design-guidelines/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `ios-design-guidelines`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/platform-design-skills ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add ehmo/platform-design-skills --skill ios-design-guidelines ipados-design-guidelines macos-design-guidelines watchos-design-guidelines visionos-design-guidelines tvos-design-guidelines android-design-guidelines web-design-guidelines -g -y ``` **Project:** ```bash npx skills add ehmo/platform-design-skills --skill ios-design-guidelines ipados-design-guidelines macos-design-guidelines watchos-design-guidelines visionos-design-guidelines tvos-design-guidelines android-design-guidelines web-design-guidelines -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Heads-up** - **License:** MIT - **Name collision:** `web-design-guidelines` is also written by `vercel-skills` (its install or its catalogue pointer); installing both overwrites the earlier one. <!-- das:install:end --> ## Invoke after install - Skill names: `ios-design-guidelines`, `ipados-design-guidelines`, `macos-design-guidelines`, `watchos-design-guidelines`, `visionos-design-guidelines`, `tvos-design-guidelines`, `android-design-guidelines`, `web-design-guidelines`. Use the one that matches the target platform. - Trigger phrases: "platform design", "HIG rules", "Material Design 3", "cross-platform" ## What it does Design rules distilled from Apple's Human Interface Guidelines, Google's Material Design 3, and WCAG 2.2, shipped as one skill per platform. Each one helps you evaluate, improve, or create interfaces that follow platform conventions: correct touch targets, navigation patterns, typography scales, component behaviors, and accessibility requirements for iOS, iPadOS, macOS, watchOS, visionOS, tvOS, Android, and the web. To install only some of them, run the install command with just those names after `--skill`. ## When NOT to use - Deep SwiftUI implementation guidance → use `swiftui-patterns` or `swiftui-claude-skills` - The full HIG audit with a doctor-style workflow → use `apple-hig-skills` or `hig-doctor` - Material 3 in depth → use `material-3-skill`
© podo · MIT · podo/design-agent-skills