Skip to content
Back to search

interface-design

MarketplaceWorks with Claude CodeGitHub

Design engineering for Claude Code. Craft, memory, and enforcement for consistent UI.

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/dammyjay93-interface-design/badge.svg)](/listings/dammyjay93-interface-design)

HTML

<a href="/listings/dammyjay93-interface-design"><img src="/api/listings/dammyjay93-interface-design/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.

Recommended: skills.sh

Use the installer shown on the [interface-design skills.sh page](https://www.skills.sh/dammyjay93/interface-design/interface-design):

npx skills add https://github.com/dammyjay93/interface-design --skill interface-design

The CLI detects supported agents and installs the skill in the right place. Useful variants:

# Install globally for the current detected agent
npx skills add https://github.com/dammyjay93/interface-design --skill interface-design -g

# Install for a specific agent
npx skills add https://github.com/dammyjay93/interface-design --skill interface-design --agent claude-code -g
npx skills add https://github.com/dammyjay93/interface-design --skill interface-design --agent codex -g

# Install for all supported agents
npx skills add https://github.com/dammyjay93/interface-design --skill interface-design --agent '*' -g -y

# Preview available skills without installing
npx skills add https://github.com/dammyjay93/interface-design --skill interface-design --list

Review installed skills before use. Skills run with the same permissions as your coding agent.

Agent Notes

Claude Code

Recommended install:

npx skills add https://github.com/dammyjay93/interface-design --skill interface-design --agent claude-code -g

This installs the core skill to `~/.claude/skills/interface-design`. Claude Code can auto-invoke it when relevant, and you can invoke it directly as `/interface-design`.

Claude Code plugin install is still supported if you prefer Claude Code's marketplace/plugin flow:

/plugin marketplace add Dammyjay93/interface-design
/plugin menu

Select `interface-design` from the menu, then restart Claude Code.

Codex

Recommended install:

npx skills add https://github.com/dammyjay93/interface-design --skill interface-design --agent codex -g

The skills CLI installs Codex skills to `~/.agents/skills/interface-design`, which Codex scans. Restart Codex, or start a fresh Codex thread, if the skill does not appear immediately.

Use the Codex slash command when available, invoke the skill explicitly in prompts, or let Codex invoke it when the request is clearly product UI work: - `/interface-design` - `use interface-design to build this dashboard` - `use interface-design design-review on the settings page`

Other Skill-Compatible Agents

Use the same CLI with an agent target:

npx skills add https://github.com/dammyjay93/interface-design --skill interface-design --agent <agent-name> -g

Compatibility Matrix

| Agent | Install | Skill support | Slash commands | Notes | |-------|---------|---------------|----------------|-------| | Claude Code | `npx skills add ... --agent claude-code -g` | Yes | `/interface-design` | Plugin marketplace remains supported | | Codex | `npx skills add ... --agent codex -g` | Yes | `/interface-design` | Slash command and natural language both work | | All supported agents | `npx skills add ... --agent '*' -g -y` | Depends on agent | Depends on agent | Good for multi-agent setups |

Manual Fallback

If you cannot use `npx`, copy the core skill folder manually:

git clone https://github.com/Dammyjay93/interface-design.git
cd interface-design

# Claude Code
mkdir -p ~/.claude/skills
cp -R .claude/skills/interface-design ~/.claude/skills/

# Codex / shared agent-skills location
mkdir -p ~/.agents/skills
cp -R .claude/skills/interface-design ~/.agents/skills/

Restart the target agent after manual installation.

---

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 · 26 lines

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

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "interface-design",
  4. "metadata": {
  5. "description": "Design engineering for Claude Code. Build interfaces with craft, visual hierarchy, and a strict design review."
  6. },
  7. "owner": {
  8. "name": "Damola Akinleye",
  9. "url": "https://github.com/Dammyjay93"
  10. },
  11. "plugins": [
  12. {
  13. "name": "interface-design",
  14. "description": "Design engineering for Claude Code. Build production-grade interfaces with strong visual hierarchy, review craft against an approval bar, and strip AI design slop. Maintains design decisions across sessions.",
  15. "version": "2026.6.20.1332",
  16. "author": {
  17. "name": "Damola Akinleye",
  18. "url": "https://github.com/Dammyjay93"
  19. },
  20. "source": "./",
  21. "category": "design",
  22. "homepage": "https://github.com/Dammyjay93/interface-design",
  23. "tags": ["design", "design-system", "ui", "craft", "hierarchy", "review", "consistency", "tokens"]
  24. }
  25. ]
  26. }
README.md · README · 372 lines

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

  1. # Interface Design
  2. <p align="center">
  3. <strong>Craft · Memory · Consistency</strong>
  4. </p>
  5. <p align="center">
  6. Build interfaces with intention. Remember decisions across sessions. Maintain systematic consistency.
  7. </p>
  8. <p align="center">
  9. <em>For interface design — dashboards, apps, tools, admin panels. Not for marketing sites.</em>
  10. </p>
  11. <p align="center">
  12. <a href="#installation">Install</a> ·
  13. <a href="#how-it-works">How It Works</a> ·
  14. <a href="https://interface-design.dev/examples.html">Examples</a> ·
  15. <a href="https://interface-design.dev">Website</a>
  16. </p>
  17. ---
  18. ## What This Does
  19. When you build UI with a coding agent, design decisions get made: spacing values, colors, depth strategy, surface elevation. Without structure, those decisions drift across sessions.
  20. **Interface Design helps you:**
  21. 1. **Craft** — Principle-based design that produces professional, polished interfaces with real visual hierarchy
  22. 2. **Visual direction** — When an image-generation tool is available, explore direction boards, UI references, and critique paintovers
  23. 3. **Memory** — Save decisions to `.interface-design/system.md`, then reload them when the skill runs
  24. 4. **Consistency** — UI changes follow the same principles throughout the session
  25. Make choices once. Apply them consistently.
  26. ## Before & After
  27. **Without interface-design:**
  28. - Every session starts from scratch
  29. - Button heights drift (36px, 38px, 40px...)
  30. - Random spacing values (14px, 17px, 22px...)
  31. - No consistency across components
  32. **With interface-design:**
  33. - System loads automatically when the skill runs
  34. - Direction boards and paintovers when an image-generation tool is available
  35. - Patterns reused (Button: 36px, Card: 16px pad)
  36. - Spacing on grid (4px, 8px, 12px, 16px)
  37. - Consistent depth and surface treatment throughout
  38. See the difference: **[interface-design.dev/examples.html](https://interface-design.dev/examples.html)**
  39. ---
  40. ## Installation
  41. ### Recommended: skills.sh
  42. Use the installer shown on the [interface-design skills.sh page](https://www.skills.sh/dammyjay93/interface-design/interface-design):
  43. ```bash
  44. npx skills add https://github.com/dammyjay93/interface-design --skill interface-design
  45. ```
  46. The CLI detects supported agents and installs the skill in the right place. Useful variants:
  47. ```bash
  48. # Install globally for the current detected agent
  49. npx skills add https://github.com/dammyjay93/interface-design --skill interface-design -g
  50. # Install for a specific agent
  51. npx skills add https://github.com/dammyjay93/interface-design --skill interface-design --agent claude-code -g
  52. npx skills add https://github.com/dammyjay93/interface-design --skill interface-design --agent codex -g
  53. # Install for all supported agents
  54. npx skills add https://github.com/dammyjay93/interface-design --skill interface-design --agent '*' -g -y
  55. # Preview available skills without installing
  56. npx skills add https://github.com/dammyjay93/interface-design --skill interface-design --list
  57. ```
  58. Review installed skills before use. Skills run with the same permissions as your coding agent.
  59. ### Agent Notes
  60. #### Claude Code
  61. Recommended install:
  62. ```bash
  63. npx skills add https://github.com/dammyjay93/interface-design --skill interface-design --agent claude-code -g
  64. ```
  65. This installs the core skill to `~/.claude/skills/interface-design`. Claude Code can auto-invoke it when relevant, and you can invoke it directly as `/interface-design`.
  66. Claude Code plugin install is still supported if you prefer Claude Code's marketplace/plugin flow:
  67. ```bash
  68. /plugin marketplace add Dammyjay93/interface-design
  69. /plugin menu
  70. ```
  71. Select `interface-design` from the menu, then restart Claude Code.
  72. #### Codex
  73. Recommended install:
  74. ```bash
  75. npx skills add https://github.com/dammyjay93/interface-design --skill interface-design --agent codex -g
  76. ```
  77. The skills CLI installs Codex skills to `~/.agents/skills/interface-design`, which Codex scans. Restart Codex, or start a fresh Codex thread, if the skill does not appear immediately.
  78. Use the Codex slash command when available, invoke the skill explicitly in prompts, or let Codex invoke it when the request is clearly product UI work:
  79. - `/interface-design`
  80. - `use interface-design to build this dashboard`
  81. - `use interface-design design-review on the settings page`
  82. #### Other Skill-Compatible Agents
  83. Use the same CLI with an agent target:
  84. ```bash
  85. npx skills add https://github.com/dammyjay93/interface-design --skill interface-design --agent <agent-name> -g
  86. ```
  87. ### Compatibility Matrix
  88. | Agent | Install | Skill support | Slash commands | Notes |
  89. |-------|---------|---------------|----------------|-------|
  90. | Claude Code | `npx skills add ... --agent claude-code -g` | Yes | `/interface-design` | Plugin marketplace remains supported |
  91. | Codex | `npx skills add ... --agent codex -g` | Yes | `/interface-design` | Slash command and natural language both work |
  92. | All supported agents | `npx skills add ... --agent '*' -g -y` | Depends on agent | Depends on agent | Good for multi-agent setups |
  93. ### Manual Fallback
  94. If you cannot use `npx`, copy the core skill folder manually:
  95. ```bash
  96. git clone https://github.com/Dammyjay93/interface-design.git
  97. cd interface-design
  98. # Claude Code
  99. mkdir -p ~/.claude/skills
  100. cp -R .claude/skills/interface-design ~/.claude/skills/
  101. # Codex / shared agent-skills location
  102. mkdir -p ~/.agents/skills
  103. cp -R .claude/skills/interface-design ~/.agents/skills/
  104. ```
  105. Restart the target agent after manual installation.
  106. ---
  107. ## How It Works
  108. ### The Flow
  109. When an agent uses interface-design:
  110. **If system.md exists:**
  111. ```
  112. ✓ Reads skill files and principles
  113. ✓ Loads .interface-design/system.md
  114. ✓ Applies established patterns
  115. ✓ Keeps design choices explicit
  116. ✓ Offers to save new patterns
  117. ```
  118. **If no system.md:**
  119. ```
  120. 1. Reads skill files and principles
  121. 2. Assesses project context
  122. 3. Suggests direction, asks for confirmation
  123. 4. Keeps design choices explicit while building
  124. 5. Builds with consistent principles
  125. 6. Offers to save system
  126. ```
  127. ### Example: First Session
  128. ```
  129. You: "Build a user dashboard with metrics cards"
  130. Agent:
  131. This feels like a data-heavy dashboard — I'd suggest:
  132. - Depth: Borders-only (clean, technical)
  133. - Surfaces: Subtle elevation shifts
  134. - Spacing: 8px base
  135. Does this direction fit?
  136. [You: y]
  137. Depth: borders-only
  138. Surfaces: 7% → 9% → 11% lightness scale
  139. Borders: rgba(255,255,255,0.06)
  140. Spacing: 8px base
  141. [Builds dashboard with consistent depth, spacing, surfaces]
  142. Want me to save these patterns to .interface-design/system.md?
  143. [You: y]
  144. ✓ System saved
  145. ```
  146. ### Example: Second Session
  147. ```
  148. You: "Add a settings page"
  149. Agent:
  150. ✓ Loaded system.md
  151. Depth: borders-only
  152. Surfaces: using established scale
  153. Borders: rgba(255,255,255,0.06)
  154. Spacing: 8px base
  155. [Builds settings page matching existing system]
  156. Want me to save any new patterns?
  157. ```
  158. The system **remembers** across sessions.
  159. ---
  160. ## System File
  161. After establishing direction, your decisions live in `.interface-design/system.md`:
  162. ```markdown
  163. # Design System
  164. ## Direction
  165. Personality: Precision & Density
  166. Foundation: Cool (slate)
  167. Depth: Borders-only
  168. ## Tokens
  169. ### Spacing
  170. Base: 4px
  171. Scale: 4, 8, 12, 16, 24, 32
  172. ### Colors
  173. --foreground: slate-900
  174. --secondary: slate-600
  175. --accent: blue-600
  176. ## Patterns
  177. ### Button Primary
  178. - Height: 36px
  179. - Padding: 12px 16px
  180. - Radius: 6px
  181. - Usage: Primary actions
  182. ### Card Default
  183. - Border: 0.5px solid
  184. - Padding: 16px
  185. - Radius: 8px
  186. ```
  187. This file is loaded by the interface-design skill when relevant. Claude Code and Codex use it to maintain consistency.
  188. ---
  189. ## Agent Usage
  190. ### Claude Code
  191. With the skills.sh install, invoke the skill directly or let Claude Code auto-invoke it:
  192. ```text
  193. /interface-design
  194. use interface-design to build this dashboard
  195. use interface-design to audit this settings page
  196. ```
  197. If you installed through the Claude Code plugin flow, two command files in `.claude/commands` give you focused review passes:
  198. ```bash
  199. /interface-design:design-review # Strict craft + hierarchy review, with an approval bar
  200. /interface-design:design-deslop # Fast, diff-scoped pass that strips visual slop from a branch
  201. ```
  202. `design-review` is the design counterpart to a deep code-quality review — it judges focal point, hierarchy, typography, color, surfaces, states, and motion against the bar of a top design team, then tells you what to fix. `design-deslop` is the counterpart to a code-deslop pass — it finds the obvious tells of generated UI (generic tokens, defaulted fonts, timid palettes, identical cards, missing states, harsh borders) and cleans them up in place.
  203. ### Codex Invocation
  204. Codex uses the same skill content and can invoke it through the slash command or natural language:
  205. ```text
  206. /interface-design
  207. use interface-design to build this dashboard
  208. use interface-design design-review on the settings page
  209. use interface-design design-deslop on this branch
  210. ```
  211. For visual direction work, when an image-generation tool is available the skill can produce direction boards, UI reference mockups, screenshot paintovers, and project-bound raster assets.
  212. ---
  213. ## Design Directions
  214. The skill infers direction from project context, but you can customize:
  215. | Direction | Feel | Best For |
  216. |-----------|------|----------|
  217. | **Precision & Density** | Tight, technical, monochrome | Developer tools, admin dashboards |
  218. | **Warmth & Approachability** | Generous spacing, soft shadows | Collaborative tools, consumer apps |
  219. | **Sophistication & Trust** | Cool tones, layered depth | Finance, enterprise B2B |
  220. | **Boldness & Clarity** | High contrast, dramatic space | Modern dashboards, data-heavy apps |
  221. | **Utility & Function** | Muted, functional density | GitHub-style tools |
  222. | **Data & Analysis** | Chart-optimized, numbers-first | Analytics, BI tools |
  223. ---
  224. ## Examples
  225. See live examples at **[interface-design.dev/examples.html](https://interface-design.dev/examples.html)**
  226. For system file templates, see `reference/examples/`:
  227. - **[system-precision.md](reference/examples/system-precision.md)** — Dashboard/admin interfaces
  228. - **[system-warmth.md](reference/examples/system-warmth.md)** — Collaborative/consumer apps
  229. ---
  230. ## Migration from claude-design-skill
  231. **This repo was renamed from `claude-design-skill`.**
  232. All old URLs redirect automatically.
  233. **If you installed the old skill:**
  234. ```bash
  235. # Uninstall old
  236. rm -rf ~/.claude/skills/design-principles
  237. # Install the current skill
  238. npx skills add https://github.com/dammyjay93/interface-design --skill interface-design --agent claude-code -g
  239. ```
  240. Your system.md files (if any) continue to work. Rename `.ds-engineer/` to `.interface-design/` if you have not already.
  241. ---
  242. ## Philosophy
  243. **Decisions compound.** A spacing value chosen once becomes a pattern. A depth strategy becomes an identity.
  244. **Consistency beats perfection.** A coherent system with "imperfect" values beats a scattered interface with "correct" ones.
  245. **Memory enables iteration.** When you can see what you decided and why, you can evolve intentionally instead of drifting accidentally.
  246. ---
  247. ## License
  248. MIT — See [LICENSE](LICENSE)
  249. ---
  250. <p align="center">
  251. <a href="https://interface-design.dev">Website</a> · <a href="https://github.com/Dammyjay93/interface-design">GitHub</a>
  252. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

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