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:

1. .artifacts/DESIGN.md
2. ~/.artifact-designer/DESIGN.md
3. 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]