# Artifacts

> Persist, version, and iterate on LLM-generated UI (widgets, HTML, markdown). Load when the user wants to save, find, update, or iterate on a previously-rendered widget — anything that should outlive the chat scrollback.

- **Type:** Skill
- **Install:** `agentstack add skill-personalclaw-personalclaw-artifacts`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [PersonalClaw](https://agentstack.voostack.com/s/personalclaw)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [PersonalClaw](https://github.com/PersonalClaw)
- **Source:** https://github.com/PersonalClaw/PersonalClaw/tree/main/src/personalclaw/skills/bundled/artifacts
- **Website:** https://personalclaw.dev

## Install

```sh
agentstack add skill-personalclaw-personalclaw-artifacts
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Artifacts (`@personalclaw-core/artifact_*`)

An **Artifact** is a named, versioned piece of generated content — a widget,
HTML tool, dashboard, markdown doc, SVG, or JSON — that persists beyond the chat
scrollback and can be reopened and iterated on by name in a later session. The
Artifacts library lists them; each lives at `/artifacts/` in the dashboard.

Without artifacts, a widget you render scrolls away and is gone. With them, the
user can say "iterate on that dashboard" three days later and you can fetch the
current version, change it, and save a new checkpoint.

## Mental model

- **slug** — the stable handle (e.g. `sales-dashboard`). Derived from the name,
  or you pass an explicit one. Everything references an artifact by slug.
- **version** — every `artifact_update` snapshots a new numbered version (like a
  commit). The live version is what `/artifacts/` shows; old snapshots are
  kept up to `MAX_VERSIONS = 50` (FIFO-pruned beyond that).
- **kind** — `widget` (default), `html`, `markdown`, `svg`, `json`, `text`,
  `infographic` (AntV declarative DSL → SVG — see the `infographic-syntax` skill),
  `document` (editorial long-form HTML — see the `editorial-document` skill).

## Tools

| Tool | Use |
|---|---|
| `artifact_list` | List saved artifacts (name/slug/kind/version/tags). Filter by `tag`, `kind`, or text `q`. |
| `artifact_save` | Save new content. Returns the **slug** — the handle for later. |
| `artifact_get` | Fetch content by `slug` (pass `version=N` for a historical snapshot; omit for live). |
| `artifact_update` | Update by `slug` → new version snapshot. New content, or metadata only. |
| `artifact_versions` | List the numbered snapshots of a slug. |
| `artifact_delete` | Delete an artifact + its history by slug (does not touch any source file). |

`artifact_save`/`artifact_update` take content inline via `content=` or from a
file via `content_file=` (absolute path — a Workspace/cwd file).

## Rules (follow these)

1. **Always `artifact_list` before `artifact_save(kind="widget")`.** Check
   whether a matching widget already exists. If it does, `artifact_update` it
   instead of creating a near-duplicate.

2. **Re-emitting a saved widget requires its slug.** When you render the HTML of
   a saved artifact again in chat, put its slug on the tag so the dashboard links
   the rendered widget back to the library entry:
   `…`.

3. **Iterate-without-a-slug decision tree.** The user says "iterate on that" but
   you don't have a slug:
   - It was saved earlier this session → you have the slug; `artifact_get` →
     change → `artifact_update`.
   - It was rendered but never saved → **save it yourself now** (`artifact_save`),
     then iterate. Never tell the user "it wasn't saved, so I can't iterate" —
     saving is your job, do it silently.
   - You're unsure which artifact → `artifact_list` (filter by `q`/`kind`) and
     pick by name, or ask only if genuinely ambiguous.

4. **Metadata-only updates don't bump content.** Changing just `description`/`tags`
   via `artifact_update` is fine and still snapshots — but don't re-send identical
   content just to touch metadata.

## Don't

- Don't save throwaway one-off widgets the user didn't ask to keep. Cost
  discipline: a quick chart inline is fine unsaved.
- Don't create a second artifact when one already covers it — update instead.
- Don't delete an artifact to "replace" it — `artifact_update` is the replace.
- Don't reference a slug you haven't confirmed exists (`artifact_get`/`list` first).

## Worked example

> **User:** "Save this as the team dashboard." *(after you rendered a widget)*

1. `artifact_list(kind="widget", q="team dashboard")` → none.
2. `artifact_save(name="Team Dashboard", kind="widget", content="")`
   → returns `slug="team-dashboard"`.
3. Tell the user: saved → `/artifacts/team-dashboard`.

> **User (next day):** "Add a burndown chart to the team dashboard."

1. `artifact_get(slug="team-dashboard")` → current HTML.
2. Add the chart (Chart.js from jsDelivr — see the `widgets` skill for CSP/theme).
3. `artifact_update(slug="team-dashboard", content="")` → new version.
4. Re-render in chat with `…`.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [PersonalClaw](https://github.com/PersonalClaw)
- **Source:** [PersonalClaw/PersonalClaw](https://github.com/PersonalClaw/PersonalClaw)
- **License:** MIT
- **Homepage:** https://personalclaw.dev

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-personalclaw-personalclaw-artifacts
- Seller: https://agentstack.voostack.com/s/personalclaw
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.