/ Verzeichnis / Playground / web-design
● Community KAOPU-XiaoPu ⚡ Sofort

web-design

von KAOPU-XiaoPu · KAOPU-XiaoPu/web-design

Spec first, code second — web-design forces a 9-section DESIGN.md from your PRD/URL/screenshot before Claude writes a line of CSS.

web-design is a Claude Code skill that fixes the 'random-ish AI web page' problem. Give it a PRD, reference URL, screenshot, or even a brand name; it extracts design cues and produces a 9-section DESIGN.md covering color, typography, components, layout, motion, depth, accessibility, and responsive behavior. Only then does it generate code — matched to the spec and audited for consistency. Portable: the same spec produces coherent output across AI tools.

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

web-design-skill.replay ▶ bereit
0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "web-design-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/KAOPU-XiaoPu/web-design",
        "~/.claude/skills/web-design"
      ],
      "_inferred": false
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "web-design-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/KAOPU-XiaoPu/web-design",
        "~/.claude/skills/web-design"
      ],
      "_inferred": false
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "web-design-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/KAOPU-XiaoPu/web-design",
        "~/.claude/skills/web-design"
      ],
      "_inferred": false
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "web-design-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/KAOPU-XiaoPu/web-design",
        "~/.claude/skills/web-design"
      ],
      "_inferred": false
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "web-design-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/KAOPU-XiaoPu/web-design",
        "~/.claude/skills/web-design"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json
{
  "context_servers": {
    "web-design-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/KAOPU-XiaoPu/web-design",
          "~/.claude/skills/web-design"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add web-design-skill -- git clone https://github.com/KAOPU-XiaoPu/web-design ~/.claude/skills/web-design

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: web-design

Build a landing page with a real design system in under an hour

👤 Solo founders, indie hackers, early-stage PMs ⏱ ~45 min beginner

Wann einsetzen: You need a landing page for a product and don't want to commission or pay for Figma work.

Voraussetzungen
  • Claude Code installed — npm install -g @anthropic-ai/claude-code
  • web-design skill installed — git clone https://github.com/KAOPU-XiaoPu/web-design ~/.claude/skills/web-design
Ablauf
  1. Feed the brand
    /web-design — build a landing page for 'Lumo', a B2B SaaS for event logistics. Reference: stripe.com's layout; vibe: calm, competent.✓ Kopiert
    → Skill generates DESIGN.md with 9 sections; shows it before coding
  2. Edit the spec, not the code
    In DESIGN.md, change primary color to #2E6BE6 and headings to Inter Tight. Regenerate the page from the updated spec.✓ Kopiert
    → Code regenerated to match edits; no random extra changes
  3. Audit
    Run the skill's audit step — flag any component that doesn't match DESIGN.md tokens.✓ Kopiert
    → Audit report with per-component pass/fail

Ergebnis: A landing page that looks designed, not 'AI-ed'. Portable DESIGN.md you can hand to a designer later for refinement.

Fallstricke
  • Spec is ignored on the second page — Always regenerate 'from DESIGN.md'; don't ask Claude to add a page without spec reference
  • Reference URL too generic (e.g. 'apple.com') — Point at something in your product's category; vague references yield vague specs
Kombinieren mit: filesystem · hue-brand-skill

Rebrand an existing site coherently, not as a search-and-replace

👤 Teams doing a visual refresh ⏱ ~90 min intermediate

Wann einsetzen: Marketing handed you new brand tokens and you don't want to touch 300 components by hand.

Ablauf
  1. Import tokens into DESIGN.md
    Update DESIGN.md with these new colors and typography. Leave layout/motion/components sections alone.✓ Kopiert
    → Clean diff on DESIGN.md
  2. Regenerate styles
    Regenerate the globals and component styles from DESIGN.md. Do not touch component structure.✓ Kopiert
    → Style-only diff; zero structural changes
  3. Audit and fix stragglers
    Audit across src/components. Any hardcoded colors/fonts not from the spec?✓ Kopiert
    → List of offenders; patches applied

Ergebnis: Coherent rebrand; no ghost-old-color surprises two weeks later.

Fallstricke
  • Hardcoded hex scattered across the codebase — Audit catches them; make fixing part of the rebrand, not 'later'
Kombinieren mit: filesystem · hue-brand-skill

Turn a screenshot into a layout starter

👤 Anyone who saw a site they like and wants a starting point for their own (not a copy) ⏱ ~30 min intermediate

Wann einsetzen: You have a screenshot of a reference site and want a coherent starter, not a pixel clone.

Ablauf
  1. Provide the screenshot
    Attached: screenshot of [reference.png]. Extract the design cues to DESIGN.md (vibe only — don't clone).✓ Kopiert
    → DESIGN.md with cues inferred from the image, not literal pixel values
  2. Set your content
    Override content in DESIGN.md's 'Narrative' section with my product's copy.✓ Kopiert
    → Spec keeps the structural cues but with your content
  3. Generate
    Generate a Next.js + Tailwind starter from DESIGN.md.✓ Kopiert
    → Code compiles; matches the spec; original enough to not be a clone

Ergebnis: A starter inspired by but distinct from the reference — ethically and visually.

Fallstricke
  • Temptation to ask for an exact clone — Don't — the skill is designed to extract cues, not reproduce; asking for clones degrades output
Kombinieren mit: hue-brand-skill

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

web-design-skill + hue-brand-skill

hue extracts brand tokens; web-design places them in DESIGN.md

Use hue on stripe.com, then bake those tokens into web-design's DESIGN.md for our new landing page.✓ Kopiert
web-design-skill + interactive-slides-skill

Use DESIGN.md's tokens to style an investor deck

Generate the investor deck (interactive-slides) using our web-design DESIGN.md tokens for consistency.✓ Kopiert
web-design-skill + filesystem

Edit DESIGN.md on disk with normal tools; regenerate code on save

After my edits to DESIGN.md, regenerate the affected components.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
/web-design PRD | URL | screenshot | brand name → DESIGN.md (editable) Any new page or rebrand pass — always spec-first Moderate Claude calls (vision if screenshot)

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
None beyond normal Claude usage
Tokens pro Aufruf
First pass (spec + code) is token-heavy; subsequent edits are cheap (regenerate just the diff)
Kosten in €
Free (MIT-style)
Tipp
Lock in DESIGN.md first; then regenerate only the sections you change

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: None
Datenabfluss: None — local skill; any external calls are Claude's normal ones

Fehlerbehebung

Häufige Fehler und Lösungen

Generated code ignores DESIGN.md

Re-invoke with explicit 'from DESIGN.md' framing; the skill expects spec-first calls, not 'make a hero section'

Prüfen: Check the skill output — it should cite DESIGN.md sections
Spec section empty for brand keywords only

Add 1–2 reference URLs to seed the cues; brand name alone is too sparse

Prüfen: Re-run with 'reference: …' added
Audit flags many false positives

Audit compares against DESIGN.md tokens; if tokens are loose, audit feels strict. Tighten DESIGN.md color/type values before re-running.

Alternativen

web-design vs. andere

AlternativeWann stattdessenKompromiss
hue (brand extraction)You need the brand tokens; not a full web-page workflowNo code generation; produces a design system to feed elsewhere
ui-ux-pro-max-skillYou want a large style library with built-in palettes and industry rulesBigger surface; less spec-first
Hand-write TailwindYou want total controlSlow; inconsistent without a spec

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen