HTML Artifact Workflow Kit cho Claude Code & OpenClaw
Bộ prompt và checklist giúp bạn biến output dài của AI thành một workflow HTML artifact dễ đọc, dễ review, có layout rõ ràng và có nút export ngược về agent.

Sản phẩm này là gì
Đây là bộ workflow kit cho người muốn biến output dài của AI thành một bề mặt review trực quan hơn. Thay vì đọc một kế hoạch 2.000 chữ trong Markdown rồi cố dựng cấu trúc trong đầu, bạn dùng prompt router để quyết định khi nào nên giữ Markdown và khi nào nên yêu cầu Claude Code hoặc OpenClaw tạo HTML tự chứa.
Giá trị chính không nằm ở việc “làm trang cho đẹp”. Giá trị nằm ở vòng lặp: agent tạo bề mặt review, người dùng chọn hoặc chỉnh, rồi export quyết định đó thành prompt, JSON, markdown hoặc patch để agent chạy tiếp.

Dành cho ai
- Người dùng Claude Code hoặc OpenClaw thường xuyên tạo plan, spec, digest hoặc báo cáo dài.
- Builder muốn review output của agent bằng giao diện trực quan hơn thay vì đọc một bức tường chữ.
- Team cần chia sẻ kế hoạch, quyết định, sprint note hoặc technical explainer cho người không muốn đọc Markdown thô.
- Người làm prompt/workflow muốn tạo bề mặt chọn lựa rồi export lại thành input tiếp theo cho agent.
Workflow này giúp gì
Chọn đúng định dạng
Prompt router giúp phân biệt khi nào Markdown là đủ và khi nào HTML artifact giúp người đọc hiểu nhanh hơn.
Giảm prompt lan man
Workflow chia artifact thành 4 cấp rõ ràng, tránh yêu cầu agent làm UI phức tạp khi chỉ cần tài liệu đọc.
Giữ review loop rõ
Interactive Review và Throwaway Tool phải có nút copy/export để đưa quyết định ngược lại vào agent.
Dễ dùng lại
ZIP giữ prompt router, template, snippet export, CSS gợi ý và checklist QA để áp dụng lại cho nhiều loại output.
Workflow hoạt động như thế nào
Bước 1. Đưa tài liệu hoặc dữ liệu vào agent
Bạn đưa repo, kế hoạch, digest, bảng dữ liệu hoặc yêu cầu review vào Claude Code/OpenClaw cùng với prompt router trong kit.
Bước 2. Agent chọn cấp artifact
Workflow chia artifact thành 4 cấp: Static Doc, Visual Artifact, Interactive Review và Throwaway Tool. Mỗi cấp có prompt riêng để agent biết nên tạo tài liệu đọc, sơ đồ, bảng tương tác hay mini-tool dùng một lần.
Bước 3. Review bằng HTML khi cần
Nếu output cần layout, so sánh, diagram, toggle, slider hoặc ghi chú lựa chọn, agent tạo một HTML tự chứa để bạn review nhanh hơn.
Bước 4. Export quyết định về agent
Với cấp Interactive Review hoặc Throwaway Tool, nút export phải tạo ra nội dung có thể dán lại vào agent: prompt tiếp theo, JSON, markdown, checklist hoặc patch.

Bạn nhận được gì trong file ZIP
- Prompt router để quyết định dùng Markdown hay HTML.
- 4 prompt theo cấp độ: Static Doc, Visual Artifact, Interactive Review và Throwaway Tool.
- Export button snippet để biến lựa chọn trong HTML thành prompt, JSON, markdown hoặc patch.
- Design system CSS gợi ý cho artifact dễ đọc và bớt cảm giác AI-slop.
- QA checklist để kiểm tra artifact trước khi chia sẻ, lưu trữ hoặc dùng làm bước review.
- Một prompt compact trong Prompt Detail để chạy nhanh, cùng bộ ZIP đầy đủ khi muốn đi sâu hơn.
Khi nào nên dùng HTML thay vì Markdown?
| Hạng mục | Giữ Markdown | Dùng HTML artifact |
|---|---|---|
| Độ dài | Nội dung ngắn, cần diff sạch hoặc cần commit vào repo. | Output dài cần đọc một lần và hiểu nhanh. |
| Cấu trúc | Checklist, tài liệu nguồn, ghi chú kỹ thuật bền vững. | So sánh nhiều phương án, dashboard, diagram hoặc annotated walkthrough. |
| Tương tác | Nội dung không cần lựa chọn hoặc trạng thái người dùng. | Cần slider, toggle, lựa chọn, ghi chú hoặc nút export ngược về agent. |
So sánh workflow gốc và cách chúng tôi triển khai
Gói này được xây từ ý tưởng HTML artifact trong cộng đồng Claude Code, nhưng được đóng gói lại thành bộ thao tác thực dụng hơn cho workflow Chodigi/OpenClaw.
| Hạng mục | Workflow gốc / nguồn tham khảo | Bản triển khai trong gói Chodigi |
|---|---|---|
| Vai trò của Markdown | Markdown vẫn là nguồn bền vững, dễ lưu và dễ diff. | Giữ Markdown cho tài liệu nguồn, checklist và nội dung cần version control. |
| Vai trò của HTML | HTML được dùng như bề mặt đọc/review khi Markdown quá phẳng. | Đưa thành 4 cấp artifact để chọn đúng mức độ: doc, visual, review UI hoặc mini-tool. |
| Export loop | HTML không chỉ để đọc mà còn để giao tiếp lại với agent. | Thêm snippet và checklist để export prompt, JSON, markdown hoặc patch có thể dán lại vào Claude Code/OpenClaw. |
| Cách dùng nhanh | Người dùng cần tự suy ra khi nào nên dùng HTML. | Field Prompt Detail có một prompt compact copy-and-go; ZIP giữ prompt/router/template đầy đủ hơn. |
Giới hạn
- Kit này không biến mọi output thành HTML. Nếu Markdown đủ tốt, nên giữ Markdown.
- HTML artifact tự chứa vẫn cần được review trước khi chia sẻ hoặc dùng làm input tiếp theo.
- Nếu dùng tương tác hoặc mini-tool, phần export phải được kiểm tra để không trả về dữ liệu mơ hồ cho agent.
- Đây là workflow kit thực dụng, không phải sản phẩm chính thức của Anthropic, Claude Code, OpenClaw hay RoboNuggets.
Nguồn tham khảo
Video: Is HTML the New Markdown? (Claude Code)
Channel: Jay E | RoboNuggets
GitHub skill: robonuggets/html-it
Reference gallery: HTML effectiveness examples by Thariq Shihipar

Agent Microapp Console Starter Kit
AI Video Editing Workflow Kit – Agentic Video Workflow cho product promo



