huashu-design Skill for Claude: High-Fidelity HTML Design, Decks and Animation

• Reads your taste notes, lists recent looks to avoid, and checks which tools you have

  Run before every design task. None blocks the work.

  Runs code · Three starter scripts

• Sends the task to the web, deck, infographic, app, motion or critique guide

  Mechanical jobs like HTML to PDF or PPTX, screenshots and text edits skip the three-direction gate.

  Read · Module routing

• Searches the web for named products, versions and events and writes product-facts.md

  Asks you if it finds nothing.

  Write · Fact check first

• Finds and downloads official logos and product images, then writes brand-spec.md

  Triggered for any recognizable brand or product in a design.

  Write · Brand asset protocol

• Makes three real drafts, then stops and waits for your pick

  Exempt only if you say skip, during later iteration in the same project, or for mechanical operations.

  Write · Three-direction gate

• Picks hero assets per direction: real or generated images, textures, data visuals

  Never blocks if an image tool is missing.

  Network · Materials first

• brand-spec.md, direction-approved.md, and a director script for animations over 20s

  direction-approved.md records the options shown and your wording of the choice.

  Write · Gate files

• Renders HTML to MP4, GIF, PDF or PPTX and checks output with Playwright screenshots

  Scripts include render-video.js, export_deck_pptx.mjs and verify.py.

  Runs code · Export and verify

• design_lint.py check, ledger add and learn.py harvest

  Records the look in a local ledger so future projects avoid repeating it.

  Runs code · Closing three scripts

• Reads remote version tags with git ls-remote at most once per 30 days

  Only if the folder is a git clone. It tells you about updates and never updates itself.

  Runs code · Version check

Watch out for

• It runs Python, Node and ffmpeg scripts

  The scripts folder has 41 files. Per SECURITY.md they call ffmpeg, ffprobe, ffplay and Playwright with Chromium for rendering. Install their packages in a project you trust.

• Optional cloud scripts send data to ByteDance

  ai-review-video.py sends segments of your rendered video to Volcengine Ark, and tts-doubao.mjs sends narration text to ByteDance, using your own keys. Both print what they send and need --yes or HUASHU_CLOUD_OK=1.

• It keeps a taste profile outside the project

  learn.py and design_lint.py write ~/.huashu-design/experience.md and ledger.jsonl. These include short verbatim quotes of what you said and each project's absolute path. Delete the folder to forget.

• Reference boards open any URL the agent picks

  ref_board.py screenshots pages through headless Chromium and does not filter targets, so it would also open a local file or localhost address if given one.

• The animation backend can add 19 skills

  The optional hyperframes backend runs npx hyperframes init, which per SECURITY.md installs 19 documentation skills into ~/.claude/skills/. The docs warn first.

• An optional hook can block long video renders

  design-gate-hook.sh is never installed automatically. If you opt in, it blocks long renders until direction-approved.md exists.