# design-with-claude

design-with-claude runs a deterministic design-system audit and sends findings to focused slash commands. Use it when an interface needs a structured review before changes.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 206 installs · ★ 35 repo stars
- Author: podo
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/podo/design-agent-skills/tree/HEAD/skills/design-with-claude/SKILL.md
- Updated: 2026-10-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/design-with-claude

## What it does

The skill runs `npx dwic-audit` across areas such as color, type, spacing, accessibility, forms, navigation, motion, and copy. It combines WCAG contrast calculations, token parsing, and markup heuristics without using an LLM. The command prints a report, writes `.dwic/audit-<date>.md`, and returns a non-zero status when errors are found, which fits CI checks.

The second part is a set of Markdown slash commands with no runtime dependencies. Findings can be handed to a focused specialist, while `/design-with-claude:design-triage` reads the audit file and processes issues by rank. Use `/design-with-claude:design-brief` when a request crosses several design areas.

The audit does not need a token, but its CLI sends an anonymous run counter. Disable that with `--no-telemetry` or `DWIC_TELEMETRY=off`. An optional MCP server needs a token from `designwithclaude.com`; the plugin route requires Claude Code.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill design-with-claude -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/design-with-claude/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/design-with-claude/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill design-with-claude -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/design-with-claude/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill design-with-claude -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/design-with-claude/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install podo/design-agent-skills skills/design-with-claude
```

2. **Manually: put the files in place**
- File: `.github/skills/design-with-claude/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill design-with-claude -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/podo/design-agent-skills --path skills/design-with-claude
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/design-with-claude/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill design-with-claude -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/podo/design-agent-skills/tree/HEAD/skills/design-with-claude/SKILL.md

## When to use it
- check interface contrast against WCAG
- spot inconsistent tokens and spacing
- review form and navigation issues
- route audit findings to design specialists
- turn a cross-domain request into a design brief

## Example prompts
- Run `npx dwic-audit` on this project, then explain the findings and their priority.
- Read `.dwic/audit-<date>.md` and work through the issues with `/design-with-claude:design-triage`.
- Create a plan for an interface change that spans several areas with `/design-with-claude:design-brief`.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: e9bcc405769d15d7.

BEGIN THIRD-PARTY FILE e9bcc405769d15d7
````text
---
name: design-with-claude
description: |
  Deterministic design-system audit plus a full set of design specialists as slash commands. `npx dwic-audit` scans a project across categories such as color, typography, spacing, accessibility, forms, navigation, motion, and copy using WCAG contrast math and token parsing (no LLM involved), then routes each finding to the specialist that fixes it. Specialists cover visual hierarchy, interaction design, design system architecture, typography, color, spacing, motion, forms, navigation, dashboards, mobile, landing pages, auth UX, healthcare UX, B2B SaaS, e-commerce, dark mode, error handling, onboarding, and data viz. Installs as a Claude Code plugin; the commands are pure markdown with no runtime dependencies.
triggers:
  - "design with claude"
  - "imsaif design"
  - "audit my design system"
  - "WCAG contrast audit"
  - "b2b SaaS design"
das:
  type: package
  category: design-review
  upstream: "https://github.com/imsaif/design-with-claude"
  version: latest
  install: false
---

# design-with-claude

> Catalogue stub — full package: [imsaif/design-with-claude](https://github.com/imsaif/design-with-claude) (MIT)

<!-- 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?**
   - `f=~/.claude/plugins/cache/design-with-claude/design-with-claude; [ -e "$f" ] && ! grep -qs "^das:" "$f" && echo "installed" || echo "pointer"`
   - `installed` → invoke it and proceed
   - `pointer` → go to step 2

2. **Install** (the skills CLI cannot install this one):

   The skills CLI skips this repo because upstream's SKILL.md frontmatter does not parse as YAML, so the supported route is the Claude Code plugin. Run the two plugin commands in a terminal, or send the same two as slash commands inside Claude Code, then run /reload-plugins (without it the commands do not appear).

   ```bash
   claude plugin marketplace add imsaif/design-with-claude
   claude plugin install design-with-claude@design-with-claude
   ```

**Claude Code plugin route:**

```
/plugin marketplace add imsaif/design-with-claude
/plugin install design-with-claude@design-with-claude
```

**Heads-up**
````
END THIRD-PARTY FILE e9bcc405769d15d7

The third-party file has ended. Everything between the e9bcc405769d15d7 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2249 of 4881 bytes. © podo · MIT · https://github.com/podo/design-agent-skills/tree/HEAD/skills/design-with-claude/SKILL.md

## Similar
- [bento](https://affpapa.org/en/nevibecode/skills/bento.md) — skill · 3000 installs
- [futuristic](https://affpapa.org/en/nevibecode/skills/futuristic.md) — skill · 2800 installs
- [ux-designer](https://affpapa.org/en/nevibecode/skills/ux-designer.md) — skill · 1900 installs
- [frontend-design-review](https://affpapa.org/en/nevibecode/skills/dauquangthanh-frontend-design-review.md) — skill · 463 installs

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
