artifact-designer

name artifact-designer description Create, validate, preview, and publish self-contained HTML artifacts. Use for dashboards, reports, timelines, prototypes, diff walkthroughs, benchmark viewers, decision docs, and existing HTML files that need previewing or publishing. Use direct file commands for user-provided HTML; scaffold only when creating a new artifact. Artifact Designer Use this skill for HTML artifacts and HTML publishing. Core rule If the user points to an existing .html or .htm file, operate on that file directly. Do not: create a new artifact copy it into .artifacts/ wrap it in the template enforce Artifact UI design classes Use the helper's --file commands. Existing HTML file Validate: node <skill-dir>/scripts/artifact.mjs validate --file path/to/file.html --strict Preview: node <skill-dir>/scripts/artifact.mjs preview --file path/to/file.html --open Publish: node <skill-dir>/scripts/artifact.mjs publish --file path/to/file.html --target temporary Add --name <worker-name> only when the user asks for a stable Worker name. File validation checks publish safety and platform limits. It does not check for .artifact-* classes or bundled design tokens. New artifact Use this path only when the user asks you to create or redesign an artifact. If artifact tools are available, use them: artifact_create({ title, instructions, kind, id? }) artifact_validate({ id, strict: true }) artifact_preview({ id, open: true }) artifact_publish({ id, target: "cloudflare-temporary", confirmPublic: true }) Otherwise use the helper: node <skill-dir>/scripts/artifact.mjs create --title "Title" --instructions "..." --kind report node <skill-dir>/scripts/artifact.mjs validate -- id < id > --strict node <skill-dir>/scripts/artifact.mjs preview -- id < id > --open node <skill-dir>/scripts/artifact.mjs publish -- id < id > --target temporary Generated artifacts live in: .artifacts/<id>/source/index.html Edit source/index.html ; rebuild/validate before previewing or publishing. Design rules for new artifacts Design priority: .artifacts/DESIGN.md ~/.artifact-designer/DESIGN.md references/design-system.md and references/artifact-theme.css Requirements for new artifacts: single index.html unless Markdown is requested semantic HTML inside <main class="artifact-shell"> use bundled .artifact-* classes before custom CSS no external scripts, stylesheets, fonts, images, or APIs no fetch , XMLHttpRequest , or WebSocket inline only small local-interaction JavaScript prefer HTML/CSS/SVG visuals keep each file under 5 MiB use restrained UI: whitespace, clear hierarchy, crisp borders use mono text for code, IDs, metrics, timestamps, and table numbers add copy/export controls for interactive decision surfaces Publishing Do not publish unless the user asks. Publishing creates a public URL. Do not publish secrets, credentials, customer data, or proprietary data unless the user confirms it is safe. Before publishing, the helper checks wrangler whoami . If Wrangler is installed and authenticated, publish to that existing Cloudflare account, including when the requested target is temporary . This creates a normal account-owned Worker and does not emit a claim URL. If no authenticated Wrangler session is available, temporary publishing uses isolated Cloudflare auth and may expire unless claimed. Permanent publishing still requires Cloudflare authentication. Helper commands node scripts/artifact.mjs create --title "Title" [--instructions "..." ] [--kind report] [-- id slug] [--format html|md] node scripts/artifact.mjs validate -- id slug [--strict] node scripts/artifact.mjs validate --file path/to/file.html [--strict] node scripts/artifact.mjs preview -- id slug [--open] node scripts/artifact.mjs preview --file path/to/file.html [--open] node scripts/artifact.mjs publish -- id slug [--target temporary|permanent] [--domain example.com] node scripts/artifact.mjs publish --file path/to/file.html [--target temporary|permanent] [--domain example.com] [--name worker-name] node scripts/artifact.mjs list node scripts/artifact.mjs import-url --url https://... [--title "Title" ] [-- id slug]