# Sk Design Chart

> Chart authoring for sk-design: turn a reader's comparison into one catalog form, copy its file and ship a standalone HTML chart.

- Skill: `michelkerkmeester/sk-design-chart` (Agent Skill, multi-file: 127 files)
- Install (CLI): `npx get-skill add michelkerkmeester/sk-design-chart`
- Raw SKILL.md: https://api.skillmd.com/api/skills/michelkerkmeester/sk-design-chart/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: MichelKerkmeester (https://skillmd.com/u/michelkerkmeester)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/michelkerkmeester/sk-design-chart

---


# Create Chart

`sk-design-chart` is the chart-authoring workflow packet of the `sk-design` parent hub. It produces a standalone HTML chart from a corpus of chart forms that lives inside this packet.

---

## 1. WHEN TO USE

### Activation Triggers

Use this packet when the request involves:

- Building a chart that plots data: a ranked comparison, a part-to-whole split, a time series, a distribution, a relationship or a matrix.
- Deciding which chart form answers the comparison a reader needs to make.
- Choosing or applying one of the packet's three stock colour systems, or a provenance-gated design-md delivery.
- Applying a local v3 `DESIGN.md` Style Reference to a chart delivery.
- Adding a chart form to the corpus, or checking that the corpus still renders.

Keyword triggers: `create a chart`, `plot the data`, `data visualization`, `treemap`, `waterfall chart`, `heatmap`, `box plot`, `histogram`, `chart catalog`, `chart colour system`, `standalone html chart`, `measured site's look`, `theme a chart`.

### When NOT to Use

Use a sibling packet when:

- The artifact explains a structure rather than plotting values. A flow, an architecture, a sequence or a state machine is `sk-design-diagram` work.
- The request is about the prose around a chart rather than the chart. That is `sk-create-readme` or `sk-create-quality-control`.
- The request asks to extract interface design values from a site. Extraction belongs to `sk-design-md-generator`; applying an already extracted local `DESIGN.md` stays here.

The boundary against `sk-design-diagram` is the one that actually gets tested, because that packet already names bar, line, scatter and radar in its own selection guide. The split is what the artifact carries. A diagram carries a structure a reader follows. A chart carries values a reader compares.

The hub router splits the packets by name. `sk-design-diagram` documents these bare type names:

- `bar chart`
- `line chart`
- `scatter plot`
- `radar chart`
- `gantt chart`
- `org chart`

This packet answers form names that diagram has no file for, such as:

- `treemap`
- `waterfall chart`
- `heatmap`
- `box plot`
- `histogram`

It also answers these data-qualified phrasings:

- `bar chart of`
- `line chart of`
- `scatter plot of`

If you name a bare type and ask for a diagram, the request reaches both packets. The router asks you which one you mean instead of guessing.

`radar chart` is the one name where the split by name and the split by artifact disagree, and the
two documents used to answer it differently with nothing saying so. By name it goes to
`sk-design-diagram`, which has a radar file and a type reference for it. By artifact it is values a
reader compares, which is this side of the line, and `catalog.md` section 6 records why this corpus
draws no radar and what answers the same comparison instead: `parallel-axes`, one scale per axis
rather than every dimension normalised onto one radial scale. Both hold, in that order. The name
routes to the diagram packet; a reader who arrives here comparing entities across several measures
is handed `parallel-axes` rather than sent away. The disagreement is recorded rather than resolved,
because resolving it means moving a file between packets and that is a decision about the hub.

### Packet Boundary

This packet may create and edit chart artifacts, its own corpus and its own validator. It does not own the `sk-design` hub identity, and it never carries its own `graph-metadata.json` or `description.json`.

---

## 2. SMART ROUTING

The `sk-design` hub resolves a chart request here through `mode-registry.json`: the request plots values, names a chart form, or asks to theme a chart.
Below that point the packet routes on the comparison a reader needs to make, and selects packet-local resources only.
`references/catalog.md` loads first, because it resolves that comparison to one row, and the row names the form file under `assets/templates/` to copy whole.
A request that names a `DESIGN.md`, a style reference or a measured site's look loads `references/design-md-theming.md` and runs `scripts/apply-design-md.cjs`.
Read [`ROUTER.md`](./ROUTER.md) before selecting skill-local resources; open only the matched files.

---

## 3. HOW IT WORKS

The workflow is template-first, and that is a constraint rather than a preference. A chart assembled from a form file renders the way that file already rendered. A chart written freehand does not, and the failure shows up in a browser rather than in a check.

When the request names a `DESIGN.md`, a style reference or a measured site's look, route the
application branch to `scripts/apply-design-md.cjs`. It reads the v3 headings documented by
`references/design-md-theming.md`, derives both grounds from local values, and writes themed
copies only after the corpus gates pass. A request that asks for themed charts without naming a
reference runs it with `--default`, the evilcharts reference carried at `assets/style-reference/evilcharts/`. If the request asks to create the Style Reference itself,
route that extraction to `sk-design-md-generator`; this packet owns application, not extraction.

1. Read the request and name the comparison the reader needs to make.
2. Open `references/catalog.md` and resolve that comparison to one row.
3. Copy the file that row names. Do not rewrite its render code.
4. Swap the data block for the reader's data.
5. Apply one colour system from the default reference's palette. One per artifact.
6. Keep the result a single self-contained file. It opens in a browser with no install step.
7. Run the corpus check before reporting the result: `node scripts/check-corpus.cjs` over the packet, and `node scripts/check-corpus.cjs --extra <dir>` over a delivery written outside it. Both must print `RESULT: PASSED`.

### What the corpus holds

Use one file for each form.

The corpus contains twenty-nine chart forms across six question families: comparison, composition, time, distribution, relationship and matrix. `references/catalog.md` is the index. The corpus check reads it in both directions:

- A row that names a missing file fails.
- A file with no catalog row also fails.

There are no gallery pages to lift a block out of, because a chart reaches a reader as a delivery and a gallery ships every other form's demo data alongside the requested one. If no row answers your question, report the gap instead of improvising a form.

The corpus shares a measured visual register for card anatomy, type scale, bare axes, bar and line geometry, positioned HTML tooltip cards and keyed legend chips. Each template accepts `?scheme=light` or `?scheme=dark` and sets `data-scheme` before it paints, because a capture on a dark machine has no other way to see the light rendering.

---

## 4. RULES

### ✅ ALWAYS

- Copy a form file that already renders, and change only its data block.
- Apply exactly one colour system per artifact; a `design-md` delivery is accepted only with its provenance comment and both inline gate checks.
- Produce a single self-contained file that opens with no install step.
- Run the corpus check before reporting a result: `scripts/check-corpus.cjs` over the packet, `scripts/check-corpus.cjs --extra <dir>` over a delivery written outside it, and require `RESULT: PASSED` from both.
- Author every chart and every palette in this packet.

### ❌ NEVER

- Never copy a template, a fragment or a snippet from an outside chart library into this packet. The corpus is authored here, and content under a license this repository cannot grant onward must not enter the tree.
- Never write a chart freehand when a form for its question exists.
- Never mix two colour systems in one artifact.
- Never act as a separate advisor identity and never carry packet-level identity metadata.

### ⚠️ ESCALATE IF

- No row in `references/catalog.md` answers the comparison the reader needs.
- The request wants a structure rather than values, which puts it on the `sk-design-diagram` side of the boundary.
- The corpus validator fails on a form you did not change.

---

## 5. REFERENCES

- `README.md` - packet overview and navigation.
- `references/README.md` - the reference index, which routes to the catalog, the colour systems and the template contract.
- `../mode-registry.json` - authoritative packet registration.
- `../hub-router.json` - parent routing policy.
- `../ROUTER.md` - stage-two leaf selection.

---

## 6. SUCCESS CRITERIA

- The artifact is one self-contained file that opens in a browser.
- The file traces back to one named row in `references/catalog.md`.
- One colour system is applied throughout.
- A local `DESIGN.md` can produce a deterministic, provenance-bearing delivery without changing stock forms or palettes.
- The corpus check printed `RESULT: PASSED` over the packet, and `--extra <dir>` printed it over the delivered file.

---

## 7. INTEGRATION POINTS

- Input: chart requests routed from the `sk-design` hub.
- Output: a standalone HTML chart.
- Neighbour: `sk-design-diagram` owns structural visuals, and the two are separated by what the artifact carries rather than by which one was asked first.

---

## 8. RELATED RESOURCES

- [`README.md`](./README.md) - what this packet is and how to navigate it.
- [`references/README.md`](./references/README.md) - the reference index for the catalog, the colour systems and the template contract.
- [`scripts/README.md`](./scripts/README.md) - what the corpus validator checks.
- [`../sk-design-diagram/SKILL.md`](../sk-design-diagram/SKILL.md) - the structural-visual packet on the other side of this boundary.
- [`../SKILL.md`](../SKILL.md) - the hub that routes here.

