Back to Blogs
15 min readApr 17, 2026

Claude Design by Anthropic Labs: What It Means for Developers & How to Set Up CLAUDE.md and Skills

A practical, developer-first breakdown of Claude Design from Anthropic Labs, plus a copy-paste guide to wiring your repo with CLAUDE.md and Agent Skills so your SaaS ships design-to-code faster.

claude designanthropic labsclaude opus 4.7claude design systemdesign to codeclaude code integration

Anthropic just launched Claude Design under a new division called Anthropic Labs and if you build SaaS products, this is one of those releases that quietly changes how a small team ships.

Most "AI design tools" aim at designers. Claude Design aims at the gap between design and code. It's the place where most SaaS projects lose two weeks of momentum.

This post is written from a developer's seat. Not hype, not a feature dump. Here's what Claude Design actually is, what it changes for engineering teams, and how to pair it with two things you should be doing in your repo today: a proper CLAUDE.md and Agent Skills.

Let's get into it.

What Claude Design Actually Is

Claude Design is a conversational design surface powered by Claude Opus 4.7. You describe what you want, it builds it. You tweak, it refines. When you are happy, it hands off to Claude Code as a bundle that already understands your design system.

It is currently in research preview for Claude Pro, Max, Team, and Enterprise plans.

The short version:

  • Start from text, a DOCX / PPTX / XLSX, a reference codebase, or elements captured from a live website
  • It reads your team's repo and design files and reverse-engineers a design system - colors, typography, components
  • You refine with inline comments, direct text edits, and sliders for spacing, color, and layout
  • You share inside your org with view or edit permissions
  • You export to Canva, PDF, PPTX, HTML, or a Claude Code handoff bundle

That last one is the interesting part for engineering.

Why This Matters for SaaS Builders

If you have shipped a SaaS product with a small team, you know the real cost is not design or engineering in isolation. It is the handoff tax.

StageTraditional WorkflowClaude Design Workflow
Idea → MockFigma, 2-3 daysConversation, ~30 minutes
Mock → SpecDesigner writes notesSystem already lives in the design
Spec → CodeDev re-interprets in JSXClaude Code receives handoff bundle
QA on design fidelityPixel diffing argumentsBundle already references your tokens
IterationAnother Figma roundAdjust sliders, re-export

The wins are not "designer replaced." The wins are:

  1. Fewer translation steps between what stakeholders saw and what the dev actually builds
  2. Design system consistency enforced by default because Claude reads your tokens
  3. Faster prototype → interactive cycles, including voice, video, and 3D where relevant
  4. Handoff bundles that land in Claude Code with context already loaded

If you are a solo dev or a 3-person startup, this is the difference between a weekend and a sprint.

What Anthropic Labs Signals

Claude Design is the first public product under Anthropic Labs, Anthropic's experimental product division. Read that carefully:

  • It is research preview - expect rough edges
  • It is a signal, not a final product - the direction is "Claude ships real surfaces, not just chat"
  • Expect more Labs releases that sit on top of Claude's capabilities with opinionated UX

For developers the signal is clear: Anthropic is committing to the design-to-code seam. Plan accordingly.

Claude Design Features, Explained for Developers

1. Design System Ingestion

You point Claude at your codebase and design files. It builds an internal representation of your tokens, components, and typography scale.

What this means for you:

  • Your tailwind.config.ts, CSS variables, and existing component library become a source of truth
  • New screens are generated against that system, not against generic "AI style"
  • If your system is weak, the ingestion will be weak - invest in tokens

2. Multi-Input Starting Points

Start from:

  • A plain description ("an onboarding wizard for a tax SaaS targeting Indian SMBs")
  • A document dump (DOCX, PPTX, XLSX)
  • A GitHub repo URL
  • A captured element from a live website

The last one is quietly useful. Capture a competitor's pricing table, feed it in, and generate a variant in your system.

3. Refinement Controls

Three knobs:

  • Inline comments - like commenting on a Google Doc, but on a design
  • Direct text editing - you can just type over copy
  • Sliders - spacing, color, layout adjustments applied across the whole design

The sliders propagate. If you nudge corner radius on one card, every card in the design updates. This is the thing Figma never cracked without plugins.

4. Collaboration and Sharing

  • Org-scoped URLs
  • View or edit permissions
  • Group conversations with Claude on the same design

Your PM, designer, and two devs can all be in the same thread, arguing with Claude in real time. Surprisingly effective.

5. Export Formats

Canva, PDF, PPTX, HTML, and - the one that matters - the Claude Code handoff bundle.

The bundle is not a zip of PNGs. It is a structured context package: design tokens, component hierarchy, copy, intent notes, and prompts that Claude Code can continue from.

This is the bridge.

The Handoff Bundle: Why Developers Should Care

The traditional Figma handoff problem:

  1. Designer delivers a frame
  2. Dev opens it in Figma, inspects styles
  3. Dev builds in code, re-deriving measurements
  4. Dev misses a spacing token, PR review catches it, iteration loop
  5. Design system drifts over time

The Claude Design bundle changes step 3 and 4. Claude Code receives the bundle, already knows your token names, and generates JSX that references them - not hardcoded hex values.

Your job becomes reviewing generated code, not translating visual intent.

Setting Up Your Repo: CLAUDE.md and Skills

Claude Design only shines if your repo is a good citizen. That means two files most teams skip: CLAUDE.md and Agent Skills.

Here is exactly how to set them up.

Step 1: Create a CLAUDE.md at the Project Root

CLAUDE.md is your project's instruction manual for Claude. It lives at the repo root and is loaded automatically by Claude Code - and is read by Claude Design when it ingests your repo.

Think of it as:

  • Onboarding doc for a new senior engineer
  • Constitution your agent respects across every session
  • The opinionated truth about your stack
# Project: Websyro SaaS## Stack- Next.js 15 (App Router, Server Components by default)- TypeScript strict mode- Tailwind v4 with design tokens in `app/globals.css`- shadcn/ui components in `components/ui`- Drizzle ORM + Postgres (Supabase)- Better Auth for sessions## Design System- Primary tokens live in `app/globals.css` under `@theme`- All spacing uses the `--space-*` scale, never hardcoded px- Component primitives live in `components/ui`- Feature components live in `components/{domain}`## Conventions- Server Components by default; mark `'use client'` only when needed- No `any` types. Prefer `unknown` + narrowing- File names are kebab-case, components are PascalCase- Route handlers live in `app/api/{route}/route.ts`- Error boundaries at every route segment## Testing- Vitest for unit, Playwright for e2e- Run `bun test` before committing- Integration tests hit a real test DB, never mocks## Don't Do- Do not introduce a new state library. We use Zustand + React Query- Do not add CSS-in-JS. Tailwind only- Do not skip the `pnpm lint` step in PRs## When Claude Design hands off- Generated components must import tokens from `app/globals.css`- Every new component gets a Storybook story in `stories/`- Accessibility: all interactive elements need ARIA labels and keyboard support

That file, alone, raises the quality of every Claude interaction in your repo by ~40% in practice.

Step 2: Add Agent Skills

Skills are modular, progressively-loaded instructions. Claude only reads them when the task matches. This is where long, specific runbooks go.

Create the directory:

mkdir -p .claude/skills

Each skill is a Markdown file with frontmatter:

---name: handle-claude-design-handoffdescription: Use when the user provides a Claude Design handoff bundle URL or zip. Walks through ingesting tokens, scaffolding components, and wiring Storybook stories.---# Handling a Claude Design Handoff## Inputs- A handoff bundle URL from Claude Design, or an extracted folder- The target route or feature area## Steps1. Read `tokens.json` from the bundle and reconcile with `app/globals.css`   - Warn if a new token conflicts with an existing one   - Never overwrite existing tokens silently2. For each component in `components/` inside the bundle:   - Scaffold the file in `components/{domain}/`   - Import tokens, not hex values   - Add a Storybook story in `stories/`3. Generate route files only if the bundle includes route intent4. Run `bun test` and `bun lint` before marking done5. Report: what was created, what was skipped, what needs human review## Guardrails- Never run `rm -rf` on existing design tokens- Always confirm before overwriting a component file that already exists- If the bundle includes a dependency, prompt the user before adding it

Step 3: Skills You Should Actually Ship

Here is a starter pack that pays for itself the first week. Each lives in .claude/skills/:

SkillWhen It FiresWhat It Does
handle-claude-design-handoffClaude Design bundle receivedIngests tokens, scaffolds components
create-api-route"Add an endpoint for..."Generates route handler, Zod schema, test
add-db-migration"Add a column" or "create table"Drizzle migration + rollback + seed update
ship-feature-flag"Behind a flag"Adds flag, wires toggle, documents rollout
write-changelog-entryPR is ready to mergeGenerates changelog entry from diff

Step 4: Verify the Wiring

From your repo root:

# Confirm Claude sees your setupclaude code# Inside the session:# "What skills are available?"# "What does CLAUDE.md say about our design tokens?"

If both answers are specific and correct, you are wired.

A Realistic SaaS Workflow with Claude Design

Let's walk through what a Tuesday actually looks like.

9:00 AM - PM describes a new onboarding flow in Slack

You paste the description into Claude Design with: "Target our SaaS dashboard's design system. Repo: github.com/acme/app."

9:15 AM - Claude Design produces three variants

All three use your tokens. You drop two, comment on the third: "Make the progress indicator persistent, move CTA below the form."

9:25 AM - Designer joins the thread

She nudges the corner radius and bumps body text up a step. Changes propagate across all four screens.

9:40 AM - Export handoff bundle

You click export, get a Claude Code bundle link.

9:45 AM - In your terminal

claude code# "Apply the handoff bundle at <url> to the /onboarding route.#  Follow the handle-claude-design-handoff skill."

10:30 AM - Components scaffolded, stories generated, tests passing

You review the diff. 80% is fine. You tweak copy on one screen, fix an edge case in the validation. Commit.

11:00 AM - PR opened, CI green

One morning. Not one sprint.

This is not science fiction. It is a skills setup, a tight CLAUDE.md, and discipline about where to trust the tool and where to review.

Where Claude Design Falls Short (As of Today)

Being honest as a developer - it is research preview. Known rough edges:

  • Brand nuance is hit or miss. If your brand has a strong voice, expect to re-edit copy
  • Complex data-heavy screens (dense tables, admin dashboards) need more back-and-forth than marketing pages
  • Animation and micro-interactions are still better authored in code
  • Figma muscle memory is real - adoption curve is 1-2 weeks even for eager teams
  • Accessibility audits still need a human pass, especially for color contrast in generated palettes

Do not replace your designer with it. Augment.

Action List for This Week

If you want to benefit from Claude Design without waiting for GA:

  1. Create or upgrade CLAUDE.md - 30 minutes, enormous leverage
  2. Scaffold .claude/skills/ with the starter pack above
  3. Consolidate design tokens in one file if they are scattered
  4. Try a single screen through Claude Design this week - a marketing page is a low-risk start
  5. Review the generated code carefully - treat it like a junior PR, not an oracle

That sequence unlocks 80% of the value without rewiring your stack.

The Bigger Picture

Anthropic Labs shipping Claude Design is a signal: the line between intent and shipped UI is shortening fast. The teams that win the next two years are not the teams with the most AI tools - they are the teams with the best repository context.

A strong CLAUDE.md. Targeted skills. Clean design tokens. Clear conventions.

Get those four right, and every new Anthropic Labs release becomes a compounding advantage. Skip them, and every new release is noise.

The tooling is arriving. The question is whether your repo is ready to receive it.

Building a SaaS and want help wiring your repo for AI-native workflows? We set up CLAUDE.md, skills, and design-to-code pipelines for agencies and product teams. Contact Websyro Agency for a free consultation.

Already on Claude Pro or Team? Claude Design is in your dashboard today - start with one marketing page and see the handoff bundle for yourself.

Related Blogs

View all