🧭 Decision Guide
Why trending now: The materials show that the repository entered GitHub Trending daily on 2026-10-27 with 251 new stars. The README also highlights version 3.0, the MIT license, 84 styles, the six-to-three workflow, and HTML, PPTX, MP4, and GIF deliverables. These may explain the attention, but the materials do not prove a specific causal reason.
Try it if you
-
You use Claude Code, Cursor, or Codex and want HTML, MP4, or editable PPTX from one prompt.The README sections “装上就能用” and “能做什么” list these agents and deliverables.
-
You need to compare six visual directions before selecting three for full development.README “3.0:三个方向更敢” and references/directions.md specify “six candidates → thumbnails → choose three.”
-
You need a clickable App/Web prototype and accept single-file HTML delivery with Playwright verification.README “能做什么” lists “single-file HTML, clickable, Playwright verification,” while the Demo gallery names the iPhone 15 Pro frame.
-
You want design, rendering, and MP4/PDF/PPTX export to run locally without sending data to the author’s server.README “安全与数据流” states that the core pipeline is 100% local, with zero network and zero keys, and no telemetry.
Skip it if you
-
Your deliverable requires importing layered PPTX into Figma or Keynote and moving text positions afterward.README “Limitations” explicitly says layered-editable PPTX to Figma is unsupported and text positions cannot be edited in Keynote.
-
Your project fundamentally depends on Framer Motion-level animation, physics simulation, or particle systems.README “Limitations” says these capabilities are outside the skill’s boundary.
-
You have no brand assets but require consistently high-fidelity design from a blank slate.README “Limitations” says quality falls to 60–65 points for a completely blank brand.
-
You only want to install SKILL.md and do not intend to keep references, assets, scripts, and demos.README “装上就能用” says the four subdirectories contain 99 references and are all required.
Requirements
- An agent supporting skills, such as Claude Code, Codex, or Cursor.
- Installation uses npx skills; CLI versions ≤1.5.15 have a single-file sync bug fixed in 1.5.19.
- A complete installation must include SKILL.md, references/, assets/, scripts/, and demos/.
- Optional cloud capabilities such as Doubao TTS and AI visual review require your own key and explicit --yes confirmation on first use.
- Animation export involves local capabilities such as Node and ffmpeg; the README lists capabilities.py for detection.
First step (verbatim from README)
npx skills add alchaincyf/huashu-design
Watch out
-
If the installation directory contains only SKILL.md, upgrade the skills CLI or use git clone instead.README “装上就能用” identifies the single-file sync bug in CLI ≤1.5.15 and provides skills@latest and git clone commands.
-
Cloud scripts are outside the default local pipeline; Doubao TTS and AI visual review use official vendor APIs.README “安全与数据流” says cloud capabilities are optional and located in scripts/cloud/.
-
Distinguish HTML decks from editable PPTX: the README explicitly limits Figma-style layer editing for PPTX.README sections “能做什么” and “Limitations.”
-
Do not treat the 60–65-point result for a blank brand as a stable high-fidelity outcome.README “Limitations” directly gives the 60–65 range.
Alternatives
-
Claude Design:Choose it when you need a browser GUI, canvas operations, or Figma export rather than a conversational skill inside Claude Code.README “和Claude Design的关系”
Not stated in the README
- The README does not specify minimum Node.js, Python, or ffmpeg versions.
- The README does not specify the required versions of Claude Code, Cursor, or Codex.
- The README provides no export-time benchmarks for MP4, GIF, or PPTX on different hardware.
- The README does not specify the exact models, pricing, or resource limits for API usage and parallel agents.
- The README does not quantify Playwright verification coverage or browser compatibility.
💡 Deep Analysis
6
No
Our workflow uses PowerPoint and Figma, and every element must remain freely movable and editable by layer. Can huashu-design’s editable PPTX replace native design files?
No, not as a replacement for native Figma or PowerPoint files. The README explicitly limits PPTX editability and identifies HTML as the primary delivery format.
- “The relationship with Claude Design” lists HTML, MP4, GIF, editable PPTX, and PDF as outputs, but that does not imply full design-file interoperability.
- The Limitations section explicitly says it does not support layer-level editable PPTX-to-Figma conversion and that the output cannot be dragged into Keynote to change text positions.
- The capability table promises that PPTX retains “text boxes,” which is closer to partial structural preservation than complete layer, layout, and effect editing.
- The project insight notes that font, layout, animation, transparency, and interaction may be lost during PPTX, PDF, or video conversion.
It is suitable for quickly producing an HTML deck and a partially editable presentation draft. If the acceptance criterion is element-by-element refinement by a designer, keep a native Figma or PowerPoint workflow.
- Limitations: does not support layer-level editable PPTX to Figma
- Limitations: outputs HTML and cannot be dragged into Keynote to reposition text
- What it can do: HTML deck plus editable PPTX with text boxes retained
- Project insight: PPTX, PDF, and video conversion may lose fonts, layout, animation, transparency, and interaction
No
I have no logo, color palette, UI screenshots, or reference works. I can provide only a vague one-line request, yet I expect consistently 90-level high-fidelity web pages. Can huashu-design meet that quality constraint?
No, not as a system that reliably produces 90-level high-fidelity work from a blank brand. The README explicitly acknowledges that quality falls to roughly 60–65 points when starting with no brand context.
- The introduction says that providing a logo, palette, and UI screenshots lets the skill understand the brand; without them, the six thumbnails, three real directions, and 84-style library are only a fallback.
- The Limitations section directly states that quality drops to 60–65 points for a completely blank brand and calls designing high-fidelity work from nothing a last resort.
- The Junior Designer workflow depends on assumptions, placeholders, reasoning, and multiple early show-and-tell steps; one vague sentence cannot replace that context.
- The project insight also says that without brand assets, references, or explicit content constraints, outputs may become generic or “AI slop.”
It can still help explore an initial brand direction, but it does not meet your required quality floor. You would need to provide brand context or accept an exploratory rather than production-ready role.
- README introduction: give the skill brand assets such as a logo, palette, and UI screenshots so it can understand the brand
- Limitations: quality drops to 60–65 points for a completely blank brand
- Limitations: creating high-fidelity work from nothing is a last resort
- Project insight, common pitfalls: without brand assets, references, or clear content constraints, quality may fall to about 60–65 points
npx skills add alchaincyf/huashu-design
Yes
I use Claude Code to build an AI Pomodoro iOS prototype with four core screens and genuinely clickable flows. Is huashu-design more suitable than writing static pages directly?
Yes, because it combines a single-file HTML prototype, device framing, and interaction validation in one agent workflow instead of producing only static screenshots.
- The “What it can do” section lists App/Web interactive prototypes with “single-file HTML, real iPhone bezel, clickable, and Playwright validation,” with a typical duration of 10–15 minutes.
- The installation section gives an almost identical example: “做个 AI 番茄钟 iOS 原型,4 个核心屏幕要真能点击”.
- The “Junior Designer Workflow” requires showing assumptions, placeholders, and early drafts, then checking the browser flow with Playwright before delivery. This fits validating screen transitions and key paths.
The output is still an HTML prototype, not a Swift or SwiftUI project ready for App Store submission. Native navigation, permissions, and real-device behavior must be implemented separately.
- What it can do: Interactive prototype (App / Web) | single-file HTML, real iPhone bezel, clickable, Playwright-validated
- Installation section: “做个 AI 番茄钟 iOS 原型,4 个核心屏幕要真能点击”
- Core mechanisms: inspect the browser with Playwright before delivery
- Project insight: supports single-file HTML prototypes, state-driven multi-screen switching, and Playwright interaction validation
npx skills add alchaincyf/huashu-design
Yes
We need to compare multiple visual directions for every project, and five of our last six deliveries used sans-serif headlines. We want the system to detect repeated colors and page skeletons and actively vary the direction. Is huashu-design suitable?
Yes, because the six-to-three exploration flow, appearance ledger, and factual design check directly address your need for direction comparison and repetition control.
- The README’s 3.0 description says to generate six thumbnails first and then turn three into real designs. The capability table further describes three design logics with two candidates each, enabling side-by-side comparison instead of committing to one concept.
- In the “Tonight’s Dinner” case, the appearance ledger noticed that five of the last six deliveries used sans-serif headlines, so the new version selected a serif typeface.
- In the “Thirty-Six Views of Mount Fuji” case, the design check noticed that two first screens used the same artwork and replaced the asset in one version. This shows that the check can lead to a concrete fix rather than only a vague aesthetic comment.
- The project insight says
design_lintchecks repeated colors and repeated skeletons across versions and produces Keep, Fix, and Quick Wins guidance.
It can reduce visual repetition, but the appearance ledger is a limited local record of prior work, not a complete team design system or long-term aesthetic model.
- 3.0 release notes: generate six thumbnails first, then make three into real designs
- 3.0 case, Tonight’s Dinner: five of the last six deliveries used sans-serif headlines, so this version selected a serif
- 3.0 case, Thirty-Six Views of Mount Fuji: the design check found the same artwork on two first screens and replaced one
- Project insight: design_lint checks repeated colors and skeletons and outputs Keep, Fix, and Quick Wins
npx skills add alchaincyf/huashu-design
Yes
I want to turn a piece of logic into a 60-second animation and export MP4, GIF, and a 60fps-interpolated version. I can install Node, a browser, and ffmpeg locally, but I do not need 3D, particles, or physics. Is huashu-design suitable?
Yes, because your animation falls within the medium-complexity timeline model of Stage and Sprite, and the requested formats are explicitly supported.
- The “Motion Design Engine” section lists Stage, Sprite, useTime, useSprite, interpolate, and Easing, and says one command can export MP4, GIF, 60fps-interpolated output, and a music-backed final video.
- The capability table lists timeline animation outputs as MP4 at 25fps or interpolated 60fps, palette-optimized GIF, and background music, with a typical duration of 8–12 minutes.
- The security and data-flow section says the design, rendering, and MP4 export path runs 100% locally with zero network access and zero keys by default.
- The Limitations section excludes Framer Motion-level complex 3D, physics simulation, and particle systems; your requirements do not cross that boundary.
The real prerequisite is a working local browser, Node, ffmpeg, and consistent font environment. The README does not promise identical encoding results across machines.
- Demo gallery, Motion Design Engine: Stage + Sprite timeline model and MP4 / GIF / 60fps interpolation / BGM
- What it can do: timeline animation with MP4, GIF, 60fps interpolation, and BGM in 8–12 minutes
- Security and data flow: the core path runs 100% locally with zero network and zero keys
- Limitations: Framer Motion-level complex animation, 3D, physics, and particles are out of scope
npx skills add alchaincyf/huashu-design
Yes
We want to give unreleased logos, color palettes, and UI screenshots to Claude Code for web and PPT direction exploration, but brand materials cannot be uploaded to the author’s server. Does huashu-design satisfy a local-first constraint?
Yes for the core local workflow, provided you do not enable cloud TTS or AI video review and do not ask the agent to capture external reference websites.
- The “Security and Data Flow” section explicitly says design, rendering, and MP4/PDF/PPTX export run 100% locally with zero network access, zero keys, and no telemetry.
- New local taste records and the appearance ledger are written only to
~/.huashu-design/and are never uploaded, which fits keeping brand context and prior visual choices local. - Cloud capabilities are isolated under
scripts/cloud/, use your own key, and require explicit--yesconfirmation on first use, so they are not part of the default outbound path. - The README also says external URLs are accessed only when the agent is asked to capture reference works for a reference board, making external references an additional data boundary.
This satisfies the requirement that assets not be sent to the author’s server, but it does not automatically satisfy enterprise-wide controls for every model API, cache, browser request, or outbound connection.
- Security and Data Flow: the core path runs 100% locally with zero network, zero keys, and no telemetry
- Security and Data Flow: local records are stored in `~/.huashu-design/` and never uploaded
- Security and Data Flow: cloud capabilities are under `scripts/cloud/` and require explicit `--yes` confirmation
- Security and Data Flow: reference URLs are accessed only when the agent captures reference works
npx skills add alchaincyf/huashu-design
✨ Highlights
-
Version 3.0 creates six thumbnails before developing three full directions
-
An HTML-native library with 84 styles and specimens
-
Exports MP4, GIF, PPTX, PDF, and PNG deliverables
-
Core design, rendering, and export run 100% locally
-
The repository has only 2 contributors and 10 recent commits
🔧 Engineering
-
Install with npx skills add and generate HTML, prototypes, and animations in Claude Code
-
The Stage + Sprite engine supports MP4, GIF, and 60fps interpolation exports
-
Playwright verifies clickable iPhone 15 Pro prototypes
-
design_lint.py provides design checks, collision detection, and an appearance ledger
⚠️ Risks
-
PPTX layers cannot be dragged into Figma or edited in Keynote by position
-
Framer Motion-level animation, physics, and particle systems are out of scope
-
Starting a brand from a blank slate can reduce quality to 60–65 points
-
skills CLI versions ≤1.5.15 may sync only the SKILL.md file
👥 For who?
-
Terminal-oriented designers and developers using Claude Code, Cursor, or Codex
-
Teams needing HTML, PPTX, or app prototypes in 10–25 minutes
-
Users needing Playwright-verified multi-screen iPhone 15 Pro prototypes
-
Users exploring web, PPT, or infographic directions with 84 style specimens