Skip to content
Back to search

designer-skills

MarketplaceWorks with Claude CodeGitHub

Design-process skills for Claude Code by Julian Oczkowski.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/julianoczkowski-designer-skills/badge.svg)](/listings/julianoczkowski-designer-skills)

HTML

<a href="/listings/julianoczkowski-designer-skills"><img src="/api/listings/julianoczkowski-designer-skills/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.

npx skills add julianoczkowski/designer-skills

The interactive CLI will walk you through which skills to install, which agents to target, and whether to install at project or global scope. Works with Claude Code, Cursor, Codex, Windsurf, and 40+ other agents.

Claude Code plugin

If you use Claude Code, you can install all 8 skills as a plugin directly from this repo:

/plugin marketplace add julianoczkowski/designer-skills
/plugin install designer-skills@designer-skills

The skills then load automatically. Claude invokes them based on each skill's description, or you can call one explicitly, e.g. `/designer-skills:design-brief`.

Installs track the latest commit on `main`, so you always get the newest skills and fixes. To pull updates later:

/plugin update designer-skills@designer-skills

To try it locally before installing, run `claude --plugin-dir /path/to/designer-skills`.

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.

.claude-plugin/marketplace.json · Manifest · 25 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "designer-skills",
  3. "owner": {
  4. "name": "Julian Oczkowski"
  5. },
  6. "description": "Design-process skills for Claude Code by Julian Oczkowski.",
  7. "plugins": [
  8. {
  9. "name": "designer-skills",
  10. "source": "./",
  11. "description": "Design-process skills: briefs, information architecture, design tokens, design review, frontend design, task breakdown, grill-me, and the full design-flow orchestrator.",
  12. "author": {
  13. "name": "Julian Oczkowski"
  14. },
  15. "homepage": "https://github.com/julianoczkowski/designer-skills",
  16. "license": "Apache-2.0",
  17. "keywords": [
  18. "design",
  19. "skills",
  20. "ui",
  21. "ux"
  22. ]
  23. }
  24. ]
  25. }
README.md · README · 135 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="left">
  2. <img src="design_skills_hero.png" alt="Design Skills — Cursor, GitHub Copilot, Claude" />
  3. </p>
  4. <p align="left">
  5. <a href="https://github.com/julianoczkowski/designer-skills"><img src="https://img.shields.io/github/stars/julianoczkowski/designer-skills?style=flat-square&logo=github" alt="GitHub stars" /></a>
  6. <a href="https://github.com/julianoczkowski/designer-skills"><img src="https://img.shields.io/github/last-commit/julianoczkowski/designer-skills?style=flat-square&logo=github&label=last%20commit" alt="Last commit on GitHub" /></a>
  7. <a href="#the-flow"><img src="https://img.shields.io/badge/skills-8-333?style=flat-square" alt="8 bundled skills" /></a>
  8. <a href="https://github.com/vercel-labs/skills"><img src="https://img.shields.io/badge/Vercel-skills%20CLI-000?style=flat-square&logo=vercel&logoColor=white" alt="Vercel skills CLI" /></a>
  9. <a href="#installation"><img src="https://img.shields.io/badge/package-julianoczkowski%2Fdesigner--skills-0070f3?style=flat-square" alt="Install via npx skills add julianoczkowski/designer-skills" /></a>
  10. <a href="#installation"><img src="https://img.shields.io/badge/agents-Claude%20Code%20%C2%B7%20Cursor%20%C2%B7%20Codex-6e7681?style=flat-square" alt="Claude Code, Cursor, Codex, and other agents" /></a>
  11. </p>
  12. # Designer Skills for Claude Code & Cursor
  13. A collection of agent skills for designers who prototype and build with AI coding tools. These skills encode design process so AI follows a structured path instead of producing random output.
  14. <p align="left">
  15. <a href="https://youtu.be/1pV7bvbaCFg?si=JtVWoBHsb-hrguho" title="Watch on YouTube">
  16. <img src="https://img.youtube.com/vi/1pV7bvbaCFg/maxresdefault.jpg" alt="Designer Skills — walkthrough (YouTube)" width="100%" />
  17. </a>
  18. </p>
  19. <p align="left"><strong>WATCH:</strong> <a href="https://youtu.be/1pV7bvbaCFg?si=JtVWoBHsb-hrguho">https://youtu.be/1pV7bvbaCFg?si=JtVWoBHsb-hrguho</a></p>
  20. ## Installation
  21. ```bash
  22. npx skills add julianoczkowski/designer-skills
  23. ```
  24. The interactive CLI will walk you through which skills to install, which agents to target, and whether to install at project or global scope. Works with Claude Code, Cursor, Codex, Windsurf, and 40+ other agents.
  25. ### Claude Code plugin
  26. If you use Claude Code, you can install all 8 skills as a plugin directly from this repo:
  27. ```
  28. /plugin marketplace add julianoczkowski/designer-skills
  29. /plugin install designer-skills@designer-skills
  30. ```
  31. The skills then load automatically. Claude invokes them based on each skill's description, or you can call one explicitly, e.g. `/designer-skills:design-brief`.
  32. Installs track the latest commit on `main`, so you always get the newest skills and fixes. To pull updates later:
  33. ```
  34. /plugin update designer-skills@designer-skills
  35. ```
  36. To try it locally before installing, run `claude --plugin-dir /path/to/designer-skills`.
  37. ## Security
  38. These files are **instructions for local AI tools**. Treat them like any other project dependency: **review** skills before using them in sensitive or production contexts, and keep your editor, CLI, and API keys on trusted machines. We welcome **responsible disclosure** of anything in this repo that could cause agents to act unsafely; please use the process in [SECURITY.md](SECURITY.md) instead of public issues. Licensing and disclaimer: [LICENSE](LICENSE) (Apache 2.0).
  39. ## The Flow
  40. The skills follow a deliberate sequence. You can use any skill individually, or run **`/design-flow`** to be guided through the entire sequence automatically.
  41. ![Designer skills flow: /design-flow orchestrates grill-me through design-review, with iterate back to grill-me](designer_skills_flow.svg)
  42. 0. **`/design-flow`** -- Run the full workflow as a guided sequence. Orchestrates all skills in order, lets you skip phases, confirms between each step. Start here if you want the complete process.
  43. 1. **`/grill-me`** -- Get interrogated about your plan until every design decision is resolved.
  44. 2. **`/design-brief`** -- Turn the grilling session into a structured design brief. Includes codebase exploration so the AI respects what already exists.
  45. 3. **`/information-architecture`** -- Define the structural skeleton: navigation, content hierarchy, page structure, URL patterns, user flows.
  46. 4. **`/design-tokens`** -- Generate a complete token system (colors, spacing, typography, motion) with light and dark mode palettes, based on the chosen aesthetic philosophy.
  47. 5. **`/brief-to-tasks`** -- Break the brief into an ordered checklist of independently buildable vertical slices.
  48. 6. **`/frontend-design`** -- Build with a named aesthetic philosophy. Mobile-first. Dark mode included. 8 design philosophies with concrete implementation parameters.
  49. 7. **`/design-review`** -- Run a structured critique against the brief. Supports code review and screenshot-based review. Runs on request, not automatically. Use after you have something built.
  50. ## Key Principles
  51. ### Respect Existing Code
  52. Every skill that touches the codebase includes a detailed detection checklist: CSS variables, Tailwind config, UI framework themes, component directories, Storybook stories, token files, font loading, and package.json dependencies. This prevents the AI from generating a new button when one exists, or inventing a color that clashes with the established palette.
  53. ### Mobile-First
  54. The `/frontend-design` skill mandates building mobile layout first (375px), then scaling up with `min-width` media queries. Touch targets, text sizing, and navigation patterns are all specified for mobile.
  55. ### Dark Mode by Default
  56. The `/design-tokens` skill generates both light and dark palettes. The `/frontend-design` skill builds with CSS custom properties that support both `prefers-color-scheme` and manual toggle. The `/design-review` skill checks that dark mode is implemented correctly.
  57. ### You Don't Need to Name a Style
  58. The aesthetic philosophies in `/frontend-design` are a menu, not a requirement. If you name one ("build this in a Dieter Rams style"), the AI follows those parameters. If you describe a vibe ("warm and clean"), it maps to the closest philosophy. If you say nothing, it picks one based on context and tells you which it chose.
  59. ### Your Work Persists
  60. All design documents are saved to a `.design/` folder in your project, organized by feature. Running the flow for different features creates separate subfolders so nothing gets overwritten.
  61. ```
  62. .design/
  63. ├── onboarding-flow/
  64. │ ├── DESIGN_BRIEF.md
  65. │ ├── INFORMATION_ARCHITECTURE.md
  66. │ ├── TASKS.md
  67. │ └── DESIGN_REVIEW.md
  68. └── settings-page/
  69. ├── DESIGN_BRIEF.md
  70. └── TASKS.md
  71. ```
  72. The folder name is derived from the feature being designed. Every skill in the flow reads from and writes to the same subfolder. If you return to a project later, the flow detects which features exist and where you left off.
  73. ## Aesthetic Philosophies (in `/frontend-design`)
  74. The frontend-design skill includes concrete implementation parameters for 8 named design philosophies:
  75. - **Dieter Rams** -- Less but better. Functional. No decoration without purpose.
  76. - **Swiss / International Typographic** -- Grid-locked. Strong type hierarchy. Objective.
  77. - **Japanese Minimalism (Ma)** -- Negative space is content. Quiet. Restrained.
  78. - **Brutalist** -- Raw structure visible. Anti-polish. Content-first.
  79. - **Scandinavian** -- Warmth plus restraint. Rounded. Accessible by default.
  80. - **Art Deco** -- Geometric luxury. Bold symmetry. Statement typography.
  81. - **Neo-Memphis** -- Playful chaos. Clashing color. Anti-corporate.
  82. - **Editorial / Magazine** -- Content-led. Display typography. Print-inspired.
  83. Each philosophy defines specific parameters for typography (font families, scale, spacing), color (palette approach, accent strategy), layout (grid type, composition rules), spacing (base unit, density), motion (duration, easing, what to animate), and detail treatment (borders, shadows, texture).
  84. ## Credits
  85. - Design tree concept from _The Design of Design_ by Frederick P. Brooks Jr.
  86. - Adapted for designers by [Julian Oczkowski](https://youtube.com/@aiforwork_app)
  87. ## Author
  88. <img width="236" height="236" alt="avatar2" src="https://github.com/user-attachments/assets/5677ddb5-6b0b-4054-a70b-a143761dd307" />
  89. Built by **Julian Oczkowski** — I build AI tools for knowledge work.
  90. - 🎥 **[YouTube · @aiforwork_app](https://www.youtube.com/@aiforwork_app)** — walkthroughs and AI-for-work tutorials
  91. - ✍️ **[Medium](https://medium.com/@julian.oczkowski)** — deep dives on product and AI workflows
  92. - 💼 **[LinkedIn](https://www.linkedin.com/in/julianoczkowski/)** — connect and follow along

Ratings and comments

Sign in to rate this skill.

Sign in

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