К основному содержанию
скилл CX Codex

live-artifact — скилл для Claude Code: что делает

Скилл live-artifact для Claude Code создаёт обновляемые HTML-артефакты с данными из проекта или коннектора. Создаёт дашборды, отчёты и синхронизируемые представления.

Apache-2.0 123 установок ★ 108 855 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add nexu-io/open-design --skill live-artifact -a claude-code
Открыть на GitHub

Что делает live-artifact

Скилл собирает живой OpenDesign-артефакт: HTML-шаблон, нормализованные данные и метаданные источника. В проекте используются template.html, data.json, artifact.json и provenance.json; итоговый index.html генерирует daemon. Шаблон поддерживает привязки значений и повторение одного элемента списка через data-od-repeat.

Перед регистрацией скилл требует убрать из сохраняемых JSON ключи и значения, связанные с токенами, ключами API, cookies и заголовками авторизации. Для источников он использует локальные данные или daemon-коннекторы, а регистрацию и обновление выполняет через обёртки OpenDesign. index.html нельзя использовать как исходный файл: его получают из template.html и data.json.

Скилл доступен для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Для работы нужны возможности shell и file_write.

Какие задачи решает

  • собрать HTML-дашборд из данных проекта
  • подготовить отчёт с обновляемым шаблоном
  • связать представление с локальным источником или коннектором
  • сохранить происхождение данных и заметки о преобразованиях

Примеры запросов агенту

  • Собери живой дашборд из данных проекта с обновляемым template.html.
  • Создай отчёт, который можно будет обновить из подключённого коннектора.
  • Подготовь синхронизируемое представление и сохрани описание источника в provenance.json.

Как установить live-artifact

1Через Skills CLI (Vercel)

npx skills add nexu-io/open-design --skill live-artifact -a claude-code

2Вручную: положить файлы

~/.claude/skills/live-artifact/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/live-artifact/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о live-artifact

Как установить live-artifact в Claude Code?

Выполните npx skills add nexu-io/open-design --skill live-artifact -a claude-code. Файл скилла появится по пути ~/.claude/skills/live-artifact/SKILL.md.

Что делает live-artifact?

Он создаёт HTML-артефакт OpenDesign, который связывает шаблон с данными и метаданными источника. Такой артефакт можно позже обновлять без переделки представления.

Какие файлы создаёт live-artifact?

Основные файлы — template.html, data.json, artifact.json и provenance.json. index.html daemon получает из шаблона и данных.

Исходный текст

SKILL.md · Apache-2.0
---
name: live-artifact
description: |
  Create refreshable, auditable OpenDesign artifacts backed by connector or local data.
  Trigger when the user asks for live dashboards, refreshable reports, synced views, or reusable data-backed artifacts.
triggers:
  - "live artifact"
  - "live dashboard"
  - "refreshable dashboard"
  - "live report"
  - "refreshable report"
  - "synced view"
  - "可刷新"
  - "实时看板"
od:
  mode: prototype
  scenario: live
  preview:
    type: html
    entry: index.html
    reload: debounce-100
  design_system:
    requires: true
  outputs:
    primary: index.html
    secondary:
      - template.html
      - artifact.json
      - data.json
      - provenance.json
  capabilities_required:
    - shell
    - file_write
---

# Live Artifact Skill

Create an OpenDesign live artifact: a project-scoped, previewable HTML artifact whose data can later be refreshed without redesigning the presentation.

## Resource map

```
live-artifact/
├── SKILL.md
└── references/
    ├── artifact-schema.md      ← `references/artifact-schema.md`: artifact files, DTO shape, template binding rules
    ├── connector-policy.md     ← `references/connector-policy.md`: connector safety, redaction, credential boundaries
    └── refresh-contract.md     ← `references/refresh-contract.md`: source metadata, refresh execution, snapshots
```

## Current status

Use the references in this directory as the source of truth for the live artifact file contract. Prefer daemon wrapper commands over raw HTTP when registering or updating live artifacts.

## When to use this skill

Use this skill when the user asks for a data-backed view that should remain useful after the first render, for example a live dashboard, refreshable report, synced status page, auditable data view, or artifact that can later be refreshed from local/project data or connectors.

Before creating files, decide whether the user actually wants a live artifact or a normal static artifact:

- Use a live artifact when the user mentions refresh, sync, recurring updates, connector-backed data, source/provenance tracking, dashboards, reports, or reusable data-backed views.
- Use a normal static artifact when the user only wants a one-off HTML/mockup/image/file and does not need refresh, source metadata, or data/provenance panels.
- If the intent is ambiguous, ask one short question: “Should this be refreshable/live, or just a static artifact?”

## Workflow

1. **Resolve scope and data source without blocking on connected connectors**
   - Identify the preview goal, audience, data freshness expectations, and whether refresh should be possible later.
   - If the user explicitly names a connector/source such as Notion, GitHub, Slack, or Google Drive, do not ask “where should the data come from?” before checking daemon connector tools.
   - Prefer local/project sources or daemon connector tools when available.
   - Do not call provider APIs directly when a daemon connector/wrapper exists.
   - If connector data is needed, first list connectors with `"$OD_NODE_BIN" "$OD_BIN" tools connectors list --format compact`. If the named connector is present with `status: "connected"`, choose an appropriate read-only `auto` tool from its catalog and execute it through the connector wrapper.
   - For Notion specifically, a connected `notion` connector plus a user brief that names Notion is enough to start with `notion.notion_search` using a query derived from the requested artifact/topic. Use `notion.notion_fetch_database` only when the user supplied a database id or the search result clearly identifies one.
   - Ask the user a data-source question only when no matching connected connector exists, multiple connected candidates fit equally well, or the requested artifact has no usable topic/query to search for. If you must ask, be specific: ask for the page/database/topic or permission to search broadly, not “where is the Notion data source?”

2. **Author the source files**
   - Write `template.html` as the human-designed HTML template. The daemon hydrates it with `data.json` using the `html_template_v1` binding contract — stay inside it or hydration fails and the raw template ships with visible `{{…}}` tokens:
     - Scalars: `{{data.path.to.value}}`. Paths start with `data`, dot-separated; numeric array indexes are allowed (`{{data.kpis.0.value}}`). Every binding must resolve to a single string/number, not an object or array.
     - Lists: repeat one element with `data-od-repeat="item in data.items"`, then bind loop-scoped fields inside it as `{{item.label}}` (or `{{item}}` for a scalar array). One level only; `data.*` still works inside the repeat for globals.
     - Do NOT hand-loop in a `<script>` (scripts are stripped from previews), and do NOT reference a bare loop variable like `{{metric.value}}` without a matching `data-od-repeat` scope — that binding is unresolvable. Nested repeats, conditionals, filters, helpers, and raw/triple-brace interpolation are unsupported.
   - Write `data.json` as the canonical preview data used by those bindings — real values, not placeholders.
   - Write `artifact.json` with the live artifact metadata, preview declaration, document declaration, and safe source descriptors.
   - Write `provenance.json` with concise source notes, timestamps, non-sensitive connector references, and transformation notes.
   - Do not author `index.html` as source. The daemon derives `index.html` from `template.html` and `data.json`.

3. **Keep data compact and preview-oriented**
   - Store only normalized values needed by the preview.
   - Summarize large lists, provider responses, or logs before writing them into `data.json`.
   - Stay within the bounded JSON rules in `references/artifact-schema.md`.

4. **Apply safety rules before registration**
   - Never store credentials, OAuth tokens, API keys, cookies, auth headers, raw provider responses, HTTP envelopes, full payloads, or secret-like fields in `artifact.json`, `data.json`, `provenance.json`, or source metadata.
   - Avoid forbidden key names such as `raw`, `rawResponse`, `payload`, `body`, `headers`, `cookie`, `authorization`, `token`, `secret`, `credential`, and `password` anywhere in persisted JSON.
   - Use escaped `html_template_v1` interpolation only. Raw/unescaped HTML interpolation is not allowed.

5. **Register or update through daemon wrappers**
   - Use the OpenDesign daemon wrapper commands via `"$OD_NODE_BIN" "$OD_BIN"` instead of raw `curl`, bare `node`, or bare `od`:

     ```bash
     "$OD_NODE_BIN" "$OD_BIN" tools live-artifacts create --input artifact.json
     "$OD_NODE_BIN" "$OD_BIN" tools live-artifacts list --format compact
     "$OD_NODE_BIN" "$OD_BIN" tools live-artifacts update --artifact-id "$ARTIFACT_ID" --input artifact.json
     ```

   - The wrapper reads injected `OD_NODE_BIN`, `OD_BIN`, `OD_DAEMON_URL`, and `OD_TOOL_TOKEN`; do not print, persist, or override token values.
   - Do not include or invent `projectId`; the daemon derives project/run scope from the token.
   - Use raw HTTP only for daemon development/debugging when explicitly requested.

6. **Use connector wrappers for connector data**
   - Discover available connectors and tools:

     ```bash
     "$OD_NODE_BIN" "$OD_BIN" tools connectors list --format compact
     ```

   - Execute a read-only connector tool with a JSON object input file:

     ```bash
     "$OD_NODE_BIN" "$OD_BIN" tools connectors execute --connector "$CONNECTOR_ID" --tool "$TOOL_NAME" --input input.json
     ```

   - Persist only the compact normalized fields needed by the preview plus non-sensitive connector references (`connectorId`, `toolName`, `accountLabel`). Never persist connector credentials, transport metadata, or raw provider output.
   - Do not ask for connector secrets or duplicate setup. If `status` is `connected`, use the listed tools; if it is not connected, tell the user to connect it in the UI.
   - See `references/connector-policy.md` for listing/execution and credential boundaries, and `references/refresh-contract.md` for read-only refresh source metadata.

7. **Report concise results**
   - On success, return the artifact ID/title and note that `index.html` is daemon-derived.
   - On validation failure, fix the source files and retry through the wrapper. Do not bypass validation.

## Required files

Every live artifact creation flow must produce these source files before registration:

- `template.html` — declared skill output and source template for the preview.
- `data.json` — compact, canonical preview data.
- `artifact.json` — create/update input for daemon validation.
- `provenance.json` — safe source and transformation summary.

`index.html` is the primary preview entry declared in frontmatter, but it is derived daemon output rather than agent-authored source.

© nexu-io · Apache-2.0 · nexu-io/open-design

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
design-artifact plannotator Скилл design-artifact для Claude Code задаёт правила генерации аккуратных HTML-документов и отчётов, избавляя вёрстку от типовых клише ИИ. CX Codex +1 2 100установок dashboard-designer community Скилл dashboard-designer для Claude Code помогает спроектировать дашборд: выбрать KPI, расположить блоки и настроить визуальную иерархию. Запускается на запросы о структуре панели мониторинга или выборе BI-инструмента. CX Codex +1 109установок data-viz-renderer zebbern Скилл data-viz-renderer для Claude Code превращает JSON-данные в HTML/SVG-инфографику. Включается по запросам на графики, диаграммы и дашборды. CX Codex +1 ★ 4 719звёзд репо structured-artifact haowjy Скилл structured-artifact для сборки структурированных HTML-артефактов: помогает агенту решить, как подать материал, и только потом выбрать инструменты. CX Codex +1 443установок build-dashboard официальный anthropics Скилл build-dashboard для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который собирает интерактивный HTML-файл с графиками, фильтрами и таблицами. Открывается прямо в браузере без сервера и зависимостей. CX Codex +1 9 700установок cmux-artifact manaflow-ai Скилл cmux-artifact для Claude Code и других агентов, который собирает HTML-отчёты о проверках и открывает их рядом с рабочим терминалом. Собирает логи, скриншоты и тайминги в один файл и показывает его в браузере. CX Codex +1 708установок

Из того же набора140

Весь набор →
web-prototype-taste-editorial Скилл web-prototype-taste-editorial для прототипирования одностраничных сайтов в духе Notion, Linear или премиум-документации: тёплый монохром, серифный заголовок и гротеск в теле, волосяные линии 1px, пастельные чипы, щедрое пространство. CX Codex +1 172установок web-prototype-taste-soft Скилл web-prototype-taste-soft задаёт агенту правила вёрстки лендингов под Apple и Linear. Настраивает двойные рамки карточек, мягкие тени и анимации. CX Codex +1 166установок web-prototype-taste-brutalist Скилл web-prototype-taste-brutalist учит агента собирать прототипы в стилистике швейцарского индустриального плаката: газетный фон, тяжёлый гротеск, красный акцент, нулевые радиусы. CX Codex +1 165установок html-ppt-taste-editorial Скилл html-ppt-taste-editorial создаёт HTML-презентации формата 16:9 в стиле печатного издания: тёплый кремовый фон, три семейства шрифтов, волосяные линии и один приглушённый акцент. CX Codex +1 162установок html-ppt-taste-brutalist Скилл html-ppt-taste-brutalist для Claude Code задаёт оформление HTML-презентаций в стиле ЭЛТ-терминала. Он включается при создании докладов об инцидентах, проверках безопасности и разборе инфраструктуры. CX Codex +1 159установок open-design-landing-deck Скилл open-design-landing-deck собирает постраничную HTML-презентацию: слайд на экран, стрелки, свайп, сетка миниатюр по ESC. Для питча, конференции или внутреннего ревью. CX Codex +1 139установок kami-deck Скилл kami-deck превращает исследование в HTML-презентацию для лабораторного совещания: со структурой слайдов, метриками, оговорками и следующим экспериментом. CX Codex +1 133установок kami-landing Скилл kami-landing генерирует одностраничный HTML-документ в эстетике бумаги kami: тёплый пергаментный фон, чернильно-синий акцент, антиква одной насыщенности, нулевые зависимости. CX Codex +1 132установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой