OpenParable
Skip to content
← Back to skills

Artifact Designer

Design
artifact-designer

Artifact Designer is an Agent Skill for design published in the latitude-dev/latitude-llm repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/latitude-dev/latitude-llm/blob/HEAD/.agents/skills/artifact-designer/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/artifact-designer, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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.

Temporary publishing uses Wrangler with isolated Cloudflare auth and may expire unless claimed.

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]