Skip to content
Back to search

app-design-skill

SkillWorks with Claude CodeGitHub

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/takasurazeem--app-design-skill/badge.svg)](/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

i

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
  1. # app-design: a design-first skill for coding agents
  2. 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).
  3. 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:
  4. | Phase | Output |
  5. |---|---|
  6. | 1. Product brief | `PRODUCT.md`: the person, the job, content ranges, platforms, scope |
  7. | 2. Structure | `STRUCTURE.md`: objects, screen list, navigation per platform, flows, state matrix |
  8. | 3. Visual direction | `DIRECTION.md`: 2–3 rendered directions, rejected ones recorded |
  9. | 4. Design system | `DESIGN.md`, `KITS.md`, `tokens/tokens.json` (W3C DTCG; light, dark, increased contrast) |
  10. | 5. Screens | every screen in every state, size, mode and text size, with real content |
  11. | 6. Prototype & review | clickable prototype, `REVIEW.md` with rubric and checklists |
  12. | 7. Handoff | `HANDOFF.md`: build order, acceptance criteria per screen, rules for the coding agent |
  13. ## Preview
  14. 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.
  15. **iOS habit tracker** (Today, habit detail in dark mode, new habit, iPad)
  16. <p>
  17. <img src="docs/screenshots/habit-tracker/today-light-iphone.png" width="170" alt="Today list on iPhone, light">
  18. <img src="docs/screenshots/habit-tracker/detail-dark-iphone.png" width="170" alt="Habit detail on iPhone, dark">
  19. <img src="docs/screenshots/habit-tracker/addFilled-light-iphone.png" width="170" alt="New habit form on iPhone">
  20. <img src="docs/screenshots/habit-tracker/today-light-ipad.png" width="250" alt="Today on iPad">
  21. </p>
  22. **Bakery order dashboard, Next.js + shadcn/ui** (orders list, order detail in dark mode, new order)
  23. <p>
  24. <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>
  25. </p>
  26. <p>
  27. <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>
  28. <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>
  29. </p>
  30. 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.
  31. ## The non-negotiable rule
  32. **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.
  33. ## What's included
  34. - `SKILL.md`: the process, checkpoints and working habits
  35. - `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
  36. - `scripts/contrast_check.py`: checks every declared color pair in every mode; exits non-zero on failure (CI-friendly)
  37. - `scripts/build_tokens.py`: one `tokens.json` → CSS custom properties, SwiftUI, Jetpack Compose and WinUI XAML
  38. - `assets/templates/`: every phase document plus a starter token file
  39. - `assets/prototype/`: a prototype viewer (device frames, state switcher, light/dark/contrast toggles), a screen template and a design-system specimen
  40. - `evals/`: three test cases (iOS+Android habit tracker, Next.js+shadcn/ui dashboard, macOS+Windows notes app)
  41. ## Install
  42. Personal (all projects):
  43. ```bash
  44. git clone https://github.com/takasurazeem/app-design-skill.git /tmp/app-design-skill && cp -R /tmp/app-design-skill/app-design ~/.claude/skills/
  45. ```
  46. Per project: copy `app-design/` into `.claude/skills/` in the repo. Then ask your agent to "design the app before we build it".
  47. Requires Python 3 for the scripts. Optional: a design-tool MCP (OpenPencil, Figma, Penpot) for kit-based screens; Xcode / Android Studio for native previews.
  48. ## Test results
  49. Side-by-side runs against a no-skill baseline (9 graded checks per case):
  50. | Case | With skill | Without skill |
  51. |---|---|---|
  52. | iOS + Android habit tracker | 9/9 | 5/9 |
  53. | Next.js + shadcn/ui order dashboard | 9/9 | 8/9 |
  54. 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.
  55. ## Credits
  56. This skill is written fresh but builds on ideas from these open-source skills and guidelines. Thank you to their authors:
  57. - [anthropics/skills](https://github.com/anthropics/skills): `frontend-design`
  58. - [pbakaus/impeccable](https://github.com/pbakaus/impeccable)
  59. - [nextlevelbuilder/ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill)
  60. - [Leonxlnx/taste-skill](https://github.com/Leonxlnx/taste-skill)
  61. - [Dammyjay93/interface-design](https://github.com/Dammyjay93/interface-design)
  62. - [emilkowalski/skills](https://github.com/emilkowalski/skills)
  63. - [ehmo/platform-design-skills](https://github.com/ehmo/platform-design-skills)
  64. - [vercel-labs/web-interface-guidelines](https://github.com/vercel-labs/web-interface-guidelines)
  65. - Apple Human Interface Guidelines, Material Design 3, Fluent 2, GNOME HIG, KDE HIG, WCAG 2.2
  66. See [`app-design/SOURCES.md`](app-design/SOURCES.md) for what each one contributed.
  67. ## License
  68. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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