Huashu Design — HTML-Native Design Skill

Skill by ara.so — Daily 2026 Skills collection.

Huashu Design turns natural-language requests into deliverable designs — interactive prototypes, animated slides, motion exports, and infographics — entirely in HTML/CSS/JS, no Figma or GUI required. Install it once into your agent; from then on say what you want and receive a finished file.

Installation

npx skills add alchaincyf/huashu-design

Compatible with Claude Code, Cursor, Codex, OpenClaw, Hermes, and any agent that reads

SKILL.md

What It Produces

Repository Structure

huashu-design/
├── SKILL.md                  # Agent-facing spec (the real instructions)
├── assets/
│   ├── animations.jsx        # Stage + Sprite + Easing + interpolate APIs
│   ├── ios_frame.jsx         # iPhone 15 Pro bezel (Dynamic Island, Home bar)
│   ├── android_frame.jsx
│   ├── macos_window.jsx
│   ├── browser_window.jsx
│   ├── deck_stage.js         # HTML slide engine
│   ├── deck_index.html       # Multi-file deck assembler
│   ├── design_canvas.jsx     # Side-by-side variant display
│   ├── showcases/            # 24 prebuilt examples (8 scenes × 3 styles)
│   └── bgm-*.mp3             # 6 scene-matched background tracks
├── references/
│   ├── animation-pitfalls.md
│   ├── design-styles.md      # 20 design philosophies detail
│   ├── slide-decks.md
│   ├── editable-pptx.md
│   ├── critique-guide.md
│   └── video-export.md
├── scripts/
│   ├── render-video.js       # HTML → MP4 via Playwright
│   ├── convert-formats.sh    # MP4 → 60fps interpolation + GIF
│   ├── add-music.sh          # Mux BGM into MP4
│   ├── export_deck_pdf.mjs
│   ├── export_deck_pptx.mjs
│   └── html2pptx.js          # DOM computedStyle → real PPTX objects
└── demos/                    # 9 capability demos (c*/w* series)

Core Concepts

1. Junior Designer Workflow (Default Mode)

The agent never starts blind. Before any task it:

1. Shows a one-shot question list — waits for batch answers before touching code
2. Writes

   assumptions

   ,

   placeholders

   , and

   reasoning

   comments inside the HTML
3. Shows an early skeleton (even gray boxes) — gets approval
4. Fills content → generates variations → adds Tweaks panel — shows each step
5. Runs Playwright visual check before final delivery

2. Brand Asset Protocol (Mandatory for Named Brands)

When the task involves a specific brand (Stripe, Linear, Anthropic, your company):

<brand>.com/brand

brand.<brand>.com

<brand>.com/press

grep

#xxxxxx

brand-spec.md

var(--brand-*)

Never guess brand colors from memory. Always extract from downloaded assets.

/* brand-spec.md output example */
:root {
  --brand-primary:   #635BFF;   /* Stripe violet — freq: 847 */
  --brand-secondary: #0A2540;   /* Stripe navy   — freq: 312 */
  --brand-accent:    #00D924;   /* Stripe green  — freq: 89  */
}

3. Design Direction Advisor (Fallback)

Triggered when the request is too vague to start. The agent:

• Picks 3 directions from different schools out of 5 schools × 20 philosophies
• Returns each with: representative works, mood keywords, reference designers
• Generates 3 parallel visual demos for the user to choose
• Then enters the Junior Designer main flow

The 5 schools and 20 philosophies live in

references/design-styles.md

4. Motion Design Engine

The animation system uses four composable primitives from

assets/animations.jsx

// Stage: defines total duration and canvas
const stage = useStage({ duration: 5000, width: 1920, height: 1080 });

// Sprite: a timed element (appears at t=500ms, lasts 2000ms)
const logo = useSprite({ start: 500, duration: 2000 });

// interpolate: map time → value with easing
const x = interpolate(stage.t, [0, 1000], [−200, 0], Easing.easeOutExpo);
const opacity = interpolate(stage.t, [0, 500], [0, 1], Easing.linear);

// Render
return (
  <div style={{
    transform: `translateX(${x}px)`,
    opacity,
    ...logo.style,   // visibility gating included
  }}>
    {children}
  </div>
);

5. Anti-AI-Slop Rules

Avoid the visual least-common-denominator:

• ❌ Purple gradients, emoji icons, left border-accent cards, SVG-drawn human faces, Inter as display font
• ✅

  text-wrap: pretty

  , CSS Grid layouts, curated serif display fonts,

  oklch()

  color space, actual whitespace

Starter Patterns

iOS App Prototype

<!-- Uses assets/ios_frame.jsx internally -->
<!-- Agent generates a self-contained HTML file like this: -->

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>AI Pomodoro — Prototype</title>
  <style>
    :root {
      --ios-width: 393px;
      --ios-height: 852px;
      --brand-primary: #FF3B30;
    }

    body {
      display: flex;
      justify-content: center;
      align-items: center;
      min-height: 100vh;
      background: #1a1a1a;
      font-family: -apple-system, BlinkMacSystemFont, "SF Pro Display", sans-serif;
    }

    .device {
      width: var(--ios-width);
      height: var(--ios-height);
      background: #000;
      border-radius: 54px;
      box-shadow:
        0 0 0 2px #3a3a3a,
        0 0 0 6px #1a1a1a,
        0 40px 80px rgba(0,0,0,0.8);
      overflow: hidden;
      position: relative;
    }

    /* Dynamic Island */
    .dynamic-island {
      position: absolute;
      top: 12px;
      left: 50%;
      transform: translateX(-50%);
      width: 126px;
      height: 37px;
      background: #000;
      border-radius: 20px;
      z-index: 100;
    }

    /* Screen states */
    .screen { display: none; width: 100%; height: 100%; }
    .screen.active { display: flex; flex-direction: column; }

    /* Navigation */
    [data-go] { cursor: pointer; }
  </style>
</head>
<body>
  <div class="device">
    <div class="dynamic-island"></div>

    <!-- Screen: Home -->
    <div class="screen active" id="screen-home">
      <div style="flex:1; display:flex; flex-direction:column; align-items:center;
                  justify-content:center; padding: 60px 32px 0; background:#fff;">
        <div style="font-size:72px; font-weight:700; color:var(--brand-primary);
                    font-variant-numeric:tabular-nums;">25:00</div>
        <div style="margin-top:8px; color:#6e6e73; font-size:17px;">Focus Session</div>
        <button data-go="screen-running"
          style="margin-top:48px; background:var(--brand-primary); color:#fff;
                 border:none; border-radius:50%; width:80px; height:80px;
                 font-size:32px; cursor:pointer;">▶</button>
      </div>
    </div>

    <!-- Screen: Running -->
    <div class="screen" id="screen-running">
      <div style="flex:1; display:flex; flex-direction:column; align-items:center;
                  justify-content:center; padding:60px 32px 0; background:#fff;">
        <div style="font-size:72px; font-weight:700; color:var(--brand-primary);">24:59</div>
        <button data-go="screen-home"
          style="margin-top:48px; background:#f2f2f7; color:#000;
                 border:none; border-radius:20px; padding:16px 40px;
                 font-size:17px; cursor:pointer;">Stop</button>
      </div>
    </div>
  </div>

  <script>
    // State-driven navigation
    document.querySelectorAll('[data-go]').forEach(el => {
      el.addEventListener('click', () => {
        document.querySelectorAll('.screen').forEach(s => s.classList.remove('active'));
        document.getElementById(el.dataset.go)?.classList.add('active');
      });
    });
  </script>
</body>
</html>

HTML Slide Deck

<!-- Single-file deck with keyboard navigation -->
<!DOCTYPE html>
<html>
<head>
  <style>
    * { margin: 0; padding: 0; box-sizing: border-box; }
    body { background: #0a0a0a; font-family: "Inter", sans-serif; }

    .deck { width: 100vw; height: 100vh; }
    .slide {
      display: none;
      width: 100%;
      height: 100%;
      padding: 80px;
      flex-direction: column;
      justify-content: center;
    }
    .slide.active { display: flex; }

    /* Progress bar */
    .progress {
      position: fixed;
      bottom: 0; left: 0;
      height: 3px;
      background: var(--accent, #635BFF);
      transition: width 0.3s ease;
    }
  </style>
</head>
<body>
  <div class="deck">
    <div class="slide active" style="background:#0a0a0a; color:#fff;">
      <h1 style="font-size:clamp(2rem,6vw,5rem); font-weight:800; line-height:1.1;
                 text-wrap:pretty;">The Future of AI Design</h1>
      <p style="margin-top:24px; font-size:1.25rem; color:#888;">May 2026</p>
    </div>

    <div class="slide" style="background:#fff; color:#0a0a0a;">
      <h2 style="font-size:3rem; font-weight:700;">Key Insight</h2>
      <p style="margin-top:32px; font-size:1.5rem; line-height:1.6;
                max-width:60ch; text-wrap:pretty;">
        Design tools are disappearing. The interface is the conversation.
      </p>
    </div>
  </div>

  <div class="progress" id="progress"></div>

  <script>
    const slides = document.querySelectorAll('.slide');
    let current = 0;

    function go(n) {
      slides[current].classList.remove('active');
      current = Math.max(0, Math.min(n, slides.length - 1));
      slides[current].classList.add('active');
      document.getElementById('progress').style.width =
        `${((current + 1) / slides.length) * 100}%`;
    }

    document.addEventListener('keydown', e => {
      if (e.key === 'ArrowRight' || e.key === ' ') go(current + 1);
      if (e.key === 'ArrowLeft') go(current - 1);
    });

    go(0);
  </script>
</body>
</html>

Tweaks Panel (Design Variants)

<script>
  // Parameterized design system with localStorage persistence
  const TWEAKS = {
    colorScheme: { options: ['midnight', 'warm', 'ocean'], default: 'midnight' },
    typeScale:   { options: ['compact', 'comfortable', 'spacious'], default: 'comfortable' },
    density:     { options: ['dense', 'balanced', 'airy'], default: 'balanced' },
  };

  const themes = {
    midnight: { '--bg': '#0a0a0a', '--fg': '#ffffff', '--accent': '#635BFF' },
    warm:     { '--bg': '#faf6f0', '--fg': '#1a1208', '--accent': '#d4793a' },
    ocean:    { '--bg': '#f0f7ff', '--fg': '#0a1628', '--accent': '#0066cc' },
  };

  function applyTweak(key, value) {
    localStorage.setItem(`tweak-${key}`, value);
    if (key === 'colorScheme') {
      Object.entries(themes[value]).forEach(([prop, val]) =>
        document.documentElement.style.setProperty(prop, val));
    }
  }

  // Restore on load
  Object.keys(TWEAKS).forEach(key => {
    const saved = localStorage.getItem(`tweak-${key}`) || TWEAKS[key].default;
    applyTweak(key, saved);
  });
</script>

Video Export Pipeline

# 1. Render HTML animation to MP4
node scripts/render-video.js \
  --input  ./animation.html \
  --output ./out/animation.mp4 \
  --fps    25 \
  --duration 10000

# 2. Upscale to 60fps with frame interpolation
bash scripts/convert-formats.sh \
  --input  ./out/animation.mp4 \
  --fps    60 \
  --output ./out/animation-60fps.mp4

# 3. Export palette-optimized GIF
bash scripts/convert-formats.sh \
  --input  ./out/animation.mp4 \
  --format gif \
  --width  800 \
  --output ./out/animation.gif

# 4. Add background music
bash scripts/add-music.sh \
  --video ./out/animation.mp4 \
  --audio ./assets/bgm-cinematic.mp3 \
  --output ./out/animation-final.mp4

// render-video.js uses Playwright internally
const { chromium } = require('playwright');

async function renderVideo({ input, output, fps = 25, duration = 10000 }) {
  const browser = await chromium.launch();
  const page = await browser.newPage({ viewport: { width: 1920, height: 1080 } });

  await page.goto(`file://${path.resolve(input)}`);

  // Frame-by-frame capture
  const frames = [];
  const totalFrames = Math.ceil((duration / 1000) * fps);

  for (let i = 0; i < totalFrames; i++) {
    await page.evaluate(t => window.__seekTo?.(t), (i / fps) * 1000);
    frames.push(await page.screenshot({ type: 'png' }));
  }

  await browser.close();
  // Encode frames → MP4 via ffmpeg
  await encodeFrames(frames, output, fps);
}

PPTX Export (Real Text Boxes)

# Export HTML deck to editable PowerPoint
node scripts/export_deck_pptx.mjs \
  --input  ./deck.html \
  --output ./deck.pptx

# Export to PDF (vector)
node scripts/export_deck_pdf.mjs \
  --input  ./deck.html \
  --output ./deck.pdf

The

html2pptx.js

getComputedStyle()

5-Dimension Expert Critique

Ask: "Do a 5-dimension design critique of this file"

The agent scores 0–10 on:

Output: SVG radar chart + structured

Keep / Fix / Quick Wins

Prompt Examples That Work Well

# Prototype
"Make a clickable iOS prototype for an AI journaling app — 4 core screens"

# Slide deck
"Create a 10-slide pitch deck for a B2B SaaS product, suggest 3 style directions"

# Animation
"Animate this product launch sequence, 30 seconds, export MP4 with music"

# Infographic
"Visualize this dataset as a magazine-quality infographic, export PNG 300dpi"

# Critique
"Critique this design file across all 5 dimensions and give me a fix list"

# Vague request (triggers advisor)
"I need something that looks premium for my fintech app"

Troubleshooting

Agent generates generic purple-gradient AI slop The skill's anti-slop rules are in

SKILL.md

npx skills add

SKILL.md

Brand colors look wrong The brand asset protocol requires live extraction. Tell the agent: "Re-run the brand asset protocol for [Brand] — download the SVG from their press page and grep the hex values."

MP4 export fails Playwright must be installed:

npx playwright install chromium

brew install ffmpeg

apt install ffmpeg

PPTX text shows as images not text boxes Use

html2pptx.js

<h1>

<p>

<span>

Animation is choppy at 25fps Run the 60fps interpolation step in

convert-formats.sh

requestAnimationFrame

--fps 60

Tweaks panel doesn't persist across sessions The panel uses

localStorage

file://

npx serve .

Design Philosophies Quick Reference

20 philosophies live in

references/design-styles.md

Always pick directions from different schools to give the client a genuine choice.

Key Constraints

• No layer-editable PPTX-to-Figma round-trip
• No 3D, physics simulation, or particle systems
• Completely blank-brand designs land at ~60–65/100; provide any brand asset to push toward 80+
• MP4 export requires local Playwright + FFmpeg