app-design-skill
Design-first Agent Skill for Claude Code: design mobile, web and desktop apps (brief, flows, tokens, every screen and state, prototype, handoff) before coding, reusing official Apple/Material/Fluent kits and your component library.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/takasurazeem--app-design-skill)HTML
<a href="/listings/takasurazeem--app-design-skill"><img src="/api/listings/takasurazeem--app-design-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Personal (all projects):
git clone https://github.com/takasurazeem/app-design-skill.git /tmp/app-design-skill && cp -R /tmp/app-design-skill/app-design ~/.claude/skills/
Per project: copy `app-design/` into `.claude/skills/` in the repo. Then ask your agent to "design the app before we build it".
Requires Python 3 for the scripts. Optional: a design-tool MCP (OpenPencil, Figma, Penpot) for kit-based screens; Xcode / Android Studio for native previews.
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 · 97 lines
- # app-design: a design-first skill for coding agents
- An [Agent Skill](https://docs.claude.com/en/docs/claude-code/skills) for Claude Code (and other agents that read `SKILL.md` skills) that **designs an app completely before any feature code is written**: mobile (iOS, iPadOS, Android), web, and desktop (macOS, Windows, Linux).
- A coding agent given a vague brief invents a generic UI. This skill makes it produce a `design/` folder that later coding sessions build from:
- | Phase | Output |
- |---|---|
- | 1. Product brief | `PRODUCT.md`: the person, the job, content ranges, platforms, scope |
- | 2. Structure | `STRUCTURE.md`: objects, screen list, navigation per platform, flows, state matrix |
- | 3. Visual direction | `DIRECTION.md`: 2–3 rendered directions, rejected ones recorded |
- | 4. Design system | `DESIGN.md`, `KITS.md`, `tokens/tokens.json` (W3C DTCG; light, dark, increased contrast) |
- | 5. Screens | every screen in every state, size, mode and text size, with real content |
- | 6. Prototype & review | clickable prototype, `REVIEW.md` with rubric and checklists |
- | 7. Handoff | `HANDOFF.md`: build order, acceptance criteria per screen, rules for the coding agent |
- ## Preview
- Designs produced by the skill in its test runs, rendered from real components: SwiftUI system controls in the iOS Simulator, and the shadcn/ui CLI's own components in the browser.
- **iOS habit tracker** (Today, habit detail in dark mode, new habit, iPad)
- <p>
- <img src="docs/screenshots/habit-tracker/today-light-iphone.png" width="170" alt="Today list on iPhone, light">
- <img src="docs/screenshots/habit-tracker/detail-dark-iphone.png" width="170" alt="Habit detail on iPhone, dark">
- <img src="docs/screenshots/habit-tracker/addFilled-light-iphone.png" width="170" alt="New habit form on iPhone">
- <img src="docs/screenshots/habit-tracker/today-light-ipad.png" width="250" alt="Today on iPad">
- </p>
- **Bakery order dashboard, Next.js + shadcn/ui** (orders list, order detail in dark mode, new order)
- <p>
- <a href="docs/screenshots/bakery-orders/list-default-light-web1440.png"><img src="docs/screenshots/bakery-orders/list-default-light-web1440.png" width="810" alt="Orders list at 1440 px, light"></a>
- </p>
- <p>
- <a href="docs/screenshots/bakery-orders/detail-default-dark-web1440.png"><img src="docs/screenshots/bakery-orders/detail-default-dark-web1440.png" width="400" alt="Order detail at 1440 px, dark"></a>
- <a href="docs/screenshots/bakery-orders/new-filled-light-web1440.png"><img src="docs/screenshots/bakery-orders/new-filled-light-web1440.png" width="400" alt="New order form at 1440 px, light"></a>
- </p>
- Each test run also produced every state (empty, loading, error, offline, overflow, dialogs), dark and increased-contrast modes, the largest text sizes, and phone-to-desktop widths. Click a web screenshot for full size.
- ## The non-negotiable rule
- **Reuse real components, never redraw them.** Native screens come from the official Apple, Material 3, Fluent/Windows and GNOME/KDE kits (or native previews with real system controls). Web screens use the project's component library (shadcn/ui, MUI, Radix, Fluent UI, …). Anything custom must be justified, and the review fails screens that redraw a kit or library component.
- ## What's included
- - `SKILL.md`: the process, checkpoints and working habits
- - `references/`: discovery, structure, visual direction, design system, craft, accessibility (WCAG 2.2), critique rubric, handoff, tools (official kits, OpenPencil, Figma, Penpot, HTML prototypes, native previews), and platform guides for iOS/iPadOS, Android, macOS, Windows, Linux, web and cross-platform
- - `scripts/contrast_check.py`: checks every declared color pair in every mode; exits non-zero on failure (CI-friendly)
- - `scripts/build_tokens.py`: one `tokens.json` → CSS custom properties, SwiftUI, Jetpack Compose and WinUI XAML
- - `assets/templates/`: every phase document plus a starter token file
- - `assets/prototype/`: a prototype viewer (device frames, state switcher, light/dark/contrast toggles), a screen template and a design-system specimen
- - `evals/`: three test cases (iOS+Android habit tracker, Next.js+shadcn/ui dashboard, macOS+Windows notes app)
- ## Install
- Personal (all projects):
- ```bash
- git clone https://github.com/takasurazeem/app-design-skill.git /tmp/app-design-skill && cp -R /tmp/app-design-skill/app-design ~/.claude/skills/
- ```
- Per project: copy `app-design/` into `.claude/skills/` in the repo. Then ask your agent to "design the app before we build it".
- Requires Python 3 for the scripts. Optional: a design-tool MCP (OpenPencil, Figma, Penpot) for kit-based screens; Xcode / Android Studio for native previews.
- ## Test results
- Side-by-side runs against a no-skill baseline (9 graded checks per case):
- | Case | With skill | Without skill |
- |---|---|---|
- | iOS + Android habit tracker | 9/9 | 5/9 |
- | Next.js + shadcn/ui order dashboard | 9/9 | 8/9 |
- Baselines missed loading/error states beyond the main screen, per-screen acceptance criteria and build order, contrast on secondary text, justification for custom components, and text-scaling specs. With the skill, runs also produced rendered screens (simulator screenshots, real shadcn/ui renders at four widths) and token builds rather than prose only. The cost is roughly 3–5× the time and tokens of a baseline run.
- ## Credits
- This skill is written fresh but builds on ideas from these open-source skills and guidelines. Thank you to their authors:
- - [anthropics/skills](https://github.com/anthropics/skills): `frontend-design`
- - [pbakaus/impeccable](https://github.com/pbakaus/impeccable)
- - [nextlevelbuilder/ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill)
- - [Leonxlnx/taste-skill](https://github.com/Leonxlnx/taste-skill)
- - [Dammyjay93/interface-design](https://github.com/Dammyjay93/interface-design)
- - [emilkowalski/skills](https://github.com/emilkowalski/skills)
- - [ehmo/platform-design-skills](https://github.com/ehmo/platform-design-skills)
- - [vercel-labs/web-interface-guidelines](https://github.com/vercel-labs/web-interface-guidelines)
- - Apple Human Interface Guidelines, Material Design 3, Fluent 2, GNOME HIG, KDE HIG, WCAG 2.2
- See [`app-design/SOURCES.md`](app-design/SOURCES.md) for what each one contributed.
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.