xiaopu-ai

web-design: Create Consistent Web Pages with Claude Code

web-design is a Claude Code skill for designing web pages with a spec-first workflow. It turns a PRD, reference URL, screenshot, or keywords into an editable DESIGN.md before generating code that follows the approved spec.

Stars
807
Forks
81
Stars, last 30 days
+30
Last commit
4 months ago
Contributors
0

Our take

Quietno commits in the last 90 days

Health score

18/100

How it is scored
Activity
31
Community
0
Issues
21
Pull requests
20

+30 stars in the last 30 days

  • Fewer contributors than 100% of the projects we track

This is a focused Claude Code skill with a clear spec-first workflow, though its recent development has been quiet and its adoption should be evaluated against your own design process.

Good fit if

  • You use Claude Code and want a structured design spec before page generation.
  • Your inputs include PRDs, screenshots, or reference sites and you want the resulting spec to remain editable.
  • You want generated code checked against a reference or a documented quality checklist.

Look elsewhere if

  • You need a standalone design application rather than a Claude Code skill.
  • Your workflow requires a framework-specific implementation or integrations not described by the project.
  • You need evidence of active recent development: the project has had no commits in the last 90 days.
All health signals
Last commit2026-06-24 (4 months ago)
Commits, last 90 days0
Releases, last 12 months1 (latest v0.1.0, 2026-04-16)
Contributors0
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age7 months

Checked on 2026-10-30 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

820

Forks

82

Change since Nov 16, 2026: +1 stars·0 forks

Overview

web-design is a skill for Claude Code that helps teams turn design inputs into consistent web pages. It addresses a common workflow problem: generating code before the design decisions are clear, which can lead to inconsistent layouts and visuals.

The skill first creates a portable, editable DESIGN.md from inputs such as a PRD, reference URL, screenshot, or keywords. After approval, it generates code against that spec, with a self-audit checklist and a comparison to the reference when a URL is provided.

Key Features

  • Accepts a PRD, reference URL, screenshot, keywords, or brand name as design inputs.
  • Uses a fallback chain when inputs are sparse.
  • Produces a nine-section DESIGN.md covering colors, typography, components, layout, motion, depth, guidance, responsiveness, and accessibility.
  • Keeps the design spec editable by hand and portable across AI tools.
  • Generates web code after the spec is approved.
  • Audits generated work against a quality checklist and, when possible, the reference URL.
  • Includes scripts for crawling pages with Playwright, extracting static design tokens, and fetching Unsplash images.

Use Cases

  • A designer or developer can turn an existing screenshot or site into a design spec before building a matching page.
  • A product team can provide a PRD and brand name to establish shared design guidance before implementation.
  • A solo developer can use the spec as an editable source of truth while generating pages with Claude Code.
  • A team building several related pages can use one spec to keep their visual decisions consistent.

What you need

Detected in the repository

  • Python (main language on GitHub)

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install the skill in your Claude Code skills directory:

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

See the README for usage details and instructions for running the landing page locally.

Considerations

  • The project is still early: it has one release, and the measured health status is Quiet because there have been no commits in the last 90 days.
  • The project is specifically a Claude Code skill. The README does not describe support for other coding agents as an installable skill, even though it describes the design spec as portable across AI tools.
  • The README describes a checklist and reference comparison, but does not provide measured results or claim that generated pages will meet a particular quality level.
  • The repository is MIT-licensed, which permits broad reuse subject to the license terms.

Found this useful?

Share it with someone who would like web-design.