/ Directory / Playground / Huashu Design
← All servers ↗ GitHub
● Community alchaincyf ⚡ Instant

Huashu Design

by alchaincyf · alchaincyf/huashu-design

HTML-native design skill for Claude — high-fidelity prototypes, slides, animations, MP4 export, 20 design principles.

Huashu Design (华术) is a Claude Code skill that treats HTML/CSS as the design canvas. Ship prototypes, slide decks, and animated explainers without Figma. Includes 20 pinned design principles, 5-dimension review, and MP4 rendering. Framework-agnostic; works from a vibe brief.

▶ Watch demo 📦 Install 💡 Use Cases

Why use it

Key features

Live Demo

What it looks like in practice

ready

Install

Author repository · Claude Skills documentation

Use Cases

Real-world ways to use Huashu Design

Rapidly prototype a product landing page in HTML

👤 Founders, designers preferring code over Figma ⏱ ~60 min intermediate

When to use: You have a brief and want a clickable, measurable prototype, not a static mock.

Flow
  1. Anchor style
    Use huashu-design. Brief: minimal B2B SaaS landing, Swiss-influenced, serif headings, one accent color. Generate layout plan following your 20 principles.✓ Copied
    → Layout plan cites specific principles applied
  2. Build
    Produce HTML/CSS. Single file. Responsive. No JS frameworks.✓ Copied
    → Single-file deliverable that passes basic a11y
  3. 5-dim review
    Run the 5-dimension review on what you just shipped. Where does it fall short?✓ Copied
    → Critical self-review, not hype

Outcome: A prototype you can A/B test or iterate on without leaving code.

Pitfalls
  • Skill reverts to generic "hero + features + CTA" template — Pin the style ref (Swiss, Bauhaus, editorial) in every prompt
Combine with: filesystem

Build an animated explainer and export to MP4

👤 Devs/creators shipping a product video ⏱ ~120 min advanced

When to use: You want an 30-second explainer for your product but can't justify After Effects.

Flow
  1. Storyboard
    Use huashu-design. Storyboard a 30s explainer for my product: problem (8s) / solution (14s) / CTA (8s).✓ Copied
    → Frame-by-frame plan
  2. Animate in HTML
    Implement each scene as a CSS keyframe animation. Render as a single HTML with a timeline.✓ Copied
    → HTML plays cleanly in browser
  3. Export
    Render to 1080p MP4.✓ Copied
    → MP4 written to disk; duration matches

Outcome: A shippable MP4 explainer from a prompt, no video editing software.

Pitfalls
  • Fonts render differently in headless Chrome — Bundle web fonts; don't rely on system fonts
Combine with: filesystem · after-effects

Combinations

Pair with other MCPs for X10 leverage

huashu-design-skill + after-effects

Storyboard in HTML, finish in AE for broadcast quality

Draft in huashu-design; export frames for AE compositing.✓ Copied
huashu-design-skill + filesystem

Save iterations alongside the brief

Create /designs/landing-v1/ through v3/ and keep both.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
plan_layout brief, style_ref Every new design 0
generate_html plan Build from plan 0
review_5d html Self-review after building 0
render_mp4 html, duration Animated deliverable 0

Cost & Limits

What this costs to run

API quota
N/A
Tokens per call
High-fi designs produce a lot of HTML — keep scope tight
Monetary
Free
Tip
Generate in small passes: structure first, styling second, polish third

Security

Permissions, secrets, blast radius

Minimum scopes: filesystem-write
Credential storage: None
Data egress: None

Troubleshooting

Common errors and fixes

MP4 render fails (ffmpeg missing)

brew install ffmpeg — the skill uses it for frame stitching

Verify: `ffmpeg -version`
Design looks generic

You didn't pin a style reference — always name one (Swiss, Bauhaus, Pentagram, …)

Review gives happy feedback on bad design

Explicit prompt: "be critical; list what's wrong first"

Alternatives

Huashu Design vs others

AlternativeWhen to use it insteadTradeoff
cc-frontend-skillYou want an opinionated voice rather than a methodologyLess structured review process
FigmaTeam workflow requires FigmaNot code; not animatable the same way

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills

Continue exploring

Related tools and workflows

Choose another guide for your workflow, or explore a collection.

Browse all topic collections → · See 29 new official additions →