Back to search
data2motion
SkillGitHub
Data2Motion - AI Data Animation Skill for Animated Charts
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/nolangz--data2motion)HTML
<a href="/listings/nolangz--data2motion"><img src="/api/listings/nolangz--data2motion/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 37 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: data2motion-lite
- description: Lightweight, script-driven variant of data2motion for turning data into a smooth, on-brand animated chart (one self-contained HTML) — built for a TEXT-ONLY model that cannot see its own output. You never write HTML/CSS/SVG/animation; you extract the data, pick a chart, fill a small JSON spec, and run one build script that owns 100% of the look and the motion, so the result cannot drift from the house template style or lose its smoothness. Use to turn a number/stat/table/CSV/paragraph into a quick animated chart, data reveal, or KPI when you want guaranteed template fidelity with minimal reasoning and no image feedback.
- ---
- # data2motion-lite
- Turn data into a **smooth, on-brand animated chart** in one self-contained HTML file.
- This is the *lite* variant. It assumes **you are a text model that cannot see images**, so it puts **all** of the design and animation into a deterministic script. **You never write HTML, CSS, SVG, or animation code.** You do four things — get the data, pick a chart, write a spec, run the build — and the script makes the result look like the template every single time. Your output cannot drift from the house style or lose its smoothness, because you don't author the pixels: the script does.
- ## Use it in 4 steps
- 1. **Get the data.** From a table, CSV, a paragraph, or a single number — pull out the labels and values. Group them into rows (or series / points, depending on the chart you'll pick).
- 2. **Pick a chart — your call, no rules.** Choose whatever form shows the data best. The supported forms (and the data each needs) are in `references/spec.md`:
- **kpi · bar · column · diverging · line · multiline · area · stacked · scatter · lollipop · dumbbell**.
- If the form you imagined isn't on that list, pick the nearest one that is — **never hand-build a chart type.** The script colours every mark **uniformly** — no single mark is singled out: single-series charts draw all marks in one house colour, multi-series give each series a distinct colour from a categorical palette, and `diverging` colours by sign. (Optional per-row `role` for honest up/down semantic colour is in `references/spec.md`.)
- 3. **Write the spec.** A small JSON file. Copy the shape for your chosen chart from `references/spec.md` and fill in the real numbers, plus `title`, `takeaway`, `source`, and `unit`.
- 4. **Build it — this is the whole deliverable:**
- ```bash
- python3 scripts/build.py spec.json chart_motion.html
- ```
- You get one dependency-free HTML: dark-console surface, Barlow (loaded), the three-colour system, a smooth eased reveal, reduced-motion-safe, with a replay · speed · dark/light · colour-scheme control bar. The build prints `OK` (or an error telling you what to fix in the spec). It's done.
- ## The only rules
- - **Never write the HTML / CSS / SVG / animation yourself.** Produce a spec and run `build.py` — nothing else. The script *is* the guarantee of the look and the smoothness; hand-writing is the single way to break either.
- - If `build.py` errors, **fix the spec** (the message says what's wrong). Do not work around it by hand-authoring a file.
- - Put the real **source and units** in the spec (honesty).
- - **One spec → one chart.** Want another chart? Write another spec and build it.
- That's the whole skill. There is deliberately **no chart-selection theory, no "one chart one story" rule, and no motion principles** — the script already encodes the house style and the smooth easing, so you don't have to reason about any of it. Just give it correct data and a chart name.
- ## Reference
- - `references/spec.md` — the JSON spec format + the data shape each chart type needs. This is the only thing you *need* to read.
- - `showcase/` — two house-template galleries showing the **target look** (open in a browser, not required): **Essential** (`showcase/chart-motion-atlas.html` — the chart × motion catalog, source of the engine your builds use) and the **FT Style Template** (`showcase/packages/ft.html` — the FT poster style your `"style":"ft"` builds reproduce, shown across the FT chart vocabulary). `build.py` already reproduces these styles automatically; the galleries are just so you (or the reader) can see what "on-brand" means. You still pick the chart freely — these are a reference, not a rulebook.
README.md · README · 141 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Data2Motion - AI Data Animation Skill for Animated Charts
- [](https://github.com/nolangz/data2motion/stargazers)
- [](https://github.com/nolangz/data2motion/forks)
- [](SKILL.md)
- [](examples/kpi_arr.html)
- Data -> chart -> motion -> standalone HTML.
- [SEO landing page](docs/index.html) · [README preview](showcase/index.html) · [Chart motion atlas](showcase/chart-motion-atlas.html) · [Spec format](references/spec.md) · [Skill instructions](SKILL.md) · Reference sibling: [Pixel2Motion](https://github.com/nolangz/pixel2motion)
- Data2Motion is an AI data animation skill for turning JSON data, KPIs, rankings, trends, and small datasets into polished animated chart HTML. This repository ships the Lite engine: a script-driven Codex and Claude skill that takes one compact JSON spec, chooses from a fixed chart vocabulary, and exports a dependency-free HTML file with the Data2Motion house style, replay controls, reduced-motion support, and deterministic QA hooks.
- 中文:Data2Motion 的 Lite 版本是一个把数据变成动态图表 HTML 的 AI skill。你只需要给出数据和图表类型,脚本负责版式、颜色、动效、控制条和可复现渲染,适合快速把一个数字、趋势、排名、对比或占比做成可上线的 data story。
- Recommended review order: the README preview page, the chart motion atlas, the example outputs, and then the spec format.
- ## Data-to-Motion Gallery
- Open the local preview page at `showcase/index.html` to browse the launch-style README page, built examples, and visual templates. Open `docs/index.html` for the SEO landing page intended for GitHub Pages.
- | Motion output | What it demonstrates |
- |---|---|
- | [`examples/kpi_arr.html`](examples/kpi_arr.html) | One big KPI number with a small supporting trend. |
- | [`examples/multiline_biomass.html`](examples/multiline_biomass.html) | Multi-line comparison with direct labels and smooth draw-on motion. |
- | [`showcase/chart-motion-atlas.html`](showcase/chart-motion-atlas.html) | Essential dark-console chart and motion vocabulary. |
- | [`showcase/packages/ft.html`](showcase/packages/ft.html) | Light editorial FT-style template for poster-like data stories. |
- ## Why Lite
- A text-only model cannot reliably inspect its own visual output. Data2Motion Lite moves the look and motion into `scripts/build.py`, so the agent writes only a small JSON spec and the script owns the rendering.
- The result is intentionally constrained:
- - One JSON file in, one standalone HTML file out.
- - No hand-authored HTML, CSS, SVG, or animation per chart.
- - A fixed chart vocabulary: `kpi`, `bar`, `column`, `diverging`, `line`, `multiline`, `area`, `stacked`, `scatter`, `lollipop`, `dumbbell`.
- - Two launch-ready styles: `essential` dark console and `ft` light editorial.
- - Built-in replay, speed, freeze, `?static=1`, and `?t=<ms>` hooks.
- ## Deliverables
- - `chart_motion.html`: standalone animated chart page generated from a JSON spec.
- - `spec.json`: the data, chart type, title, takeaway, source, unit, duration, style, and optional scale settings.
- - `showcase/index.html`: README-style launch page for presenting the project.
- - `docs/index.html`: SEO landing page and waitlist entry for Data2Motion and the upcoming commercial motion platform.
- - `showcase/chart-motion-atlas.html`: Essential house-style reference.
- - `showcase/packages/ft.html`: FT-style reference template.
- - `references/spec.md`: the contract every input spec follows.
- ## Workflow
- 1. Read `references/spec.md` and pick the closest chart type.
- 2. Write a compact JSON spec with real numbers and a source.
- 3. Build the output:
- ```bash
- python3 scripts/build.py examples/kpi_arr.json chart_motion.html
- ```
- 4. Open `chart_motion.html` in a browser.
- 5. Use `?static=1` for the final frame or `?t=<ms>` for deterministic frame checks.
- ## Example Spec
- ```json
- {
- "chart": "kpi",
- "title": "ARR reached $12.4M",
- "takeaway": "ARR climbed 42% year over year after the enterprise launch.",
- "source": "Company dashboard - FY2026",
- "unit": "M",
- "value_format": "0.0",
- "value": 12.4,
- "kpi_label": "annual recurring revenue",
- "sparkline": [7.1, 8.3, 9.6, 10.8, 12.4],
- "duration": 1400,
- "style": "essential"
- }
- ```
- ## How It Differs From Full Data2Motion
- | | Data2Motion full | Data2Motion Lite |
- |---|---|---|
- | Target model | Strong multimodal agent | Any text-only agent |
- | Chart selection | Guided by editorial and perceptual rules | User or agent picks from a fixed list |
- | Motion design | Brief-led choreography and visual QA | Encoded in the generator |
- | Output | Full data-motion package with evidence | One spec and one HTML output |
- | Best use | High-stakes custom data story | Fast, repeatable animated chart |
- ## Requirements
- - Python 3.10+
- - A modern browser for viewing generated HTML
- - Optional: Chrome or Playwright if you want deterministic screenshots from `?static=1` and `?t=<ms>`
- No runtime JavaScript dependencies are required in the generated chart HTML.
- ## Repository Layout
- - `SKILL.md`: Codex-facing instructions for using this skill.
- - `scripts/build.py`: deterministic chart-to-HTML generator.
- - `references/spec.md`: accepted JSON schema and chart examples.
- - `examples/`: ready-to-run input specs and generated outputs.
- - `showcase/`: README preview, chart-motion atlas, FT-style template, and publishable assets.
- - `docs/`: GitHub Pages SEO landing page, crawler metadata, and waitlist assets.
- ## GitHub SEO
- Recommended GitHub About settings:
- - **Description:** `AI data animation skill that turns JSON data into standalone animated chart HTML for data storytelling, dashboards, reports, and launch visuals.`
- - **Website:** `https://nolangz.github.io/data2motion/`
- - **Topics:** `data-visualization`, `animated-charts`, `data-storytelling`, `dataviz`, `svg-animation`, `html-animation`, `ai-tools`, `generative-ai`, `codex-skill`, `claude-skill`, `charts`, `dashboard`, `reporting`, `storytelling`, `github-pages`, `javascript`, `python`
- Search keywords this repository intentionally targets: AI data animation, animated charts, data storytelling, chart motion, data visualization animation, standalone chart HTML, SVG chart animation, Codex skill, Claude skill, and JSON to chart.
- ## Publishing Checklist
- - Confirm `README.md`, `SKILL.md`, `references/`, `scripts/`, `examples/`, and `showcase/` are committed.
- - Keep caches, local virtual environments, generated temp frames, and dependency directories out of git.
- - Enable GitHub Pages from branch `main`, folder `/docs`, to publish the SEO landing page.
- - After creating the GitHub repository, add the remote and push:
- ```bash
- git remote add origin git@github.com:<owner>/data2motion-lite.git
- git branch -M main
- git push -u origin main
- ```
- ## More From Nolanlai
- [nolanlai.com](https://www.nolanlai.com)
- <img src="showcase/assets/wechat-qr.jpg" width="360" alt="vibe-creators group QR code">
- 扫码进群交流 vibe-creators群
- Scan the QR code to join the vibe-creators group.
- Built with Codex.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.