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.mdStyle 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-diagramwork. - The request is about the prose around a chart rather than the chart. That is
sk-create-readmeorsk-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 localDESIGN.mdstays 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 chartline chartscatter plotradar chartgantt chartorg chart
This packet answers form names that diagram has no file for, such as:
treemapwaterfall chartheatmapbox plothistogram
It also answers these data-qualified phrasings:
bar chart ofline chart ofscatter 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 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.
- Read the request and name the comparison the reader needs to make.
- Open
references/catalog.mdand resolve that comparison to one row. - Copy the file that row names. Do not rewrite its render code.
- Swap the data block for the reader's data.
- Apply one colour system from the default reference's palette. One per artifact.
- Keep the result a single self-contained file. It opens in a browser with no install step.
- Run the corpus check before reporting the result:
node scripts/check-corpus.cjsover the packet, andnode scripts/check-corpus.cjs --extra <dir>over a delivery written outside it. Both must printRESULT: 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-mddelivery 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.cjsover the packet,scripts/check-corpus.cjs --extra <dir>over a delivery written outside it, and requireRESULT: PASSEDfrom 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.mdanswers the comparison the reader needs. - The request wants a structure rather than values, which puts it on the
sk-design-diagramside 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.mdcan produce a deterministic, provenance-bearing delivery without changing stock forms or palettes. - The corpus check printed
RESULT: PASSEDover the packet, and--extra <dir>printed it over the delivered file.
7. INTEGRATION POINTS
- Input: chart requests routed from the
sk-designhub. - Output: a standalone HTML chart.
- Neighbour:
sk-design-diagramowns 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- what this packet is and how to navigate it.references/README.md- the reference index for the catalog, the colour systems and the template contract.scripts/README.md- what the corpus validator checks.../sk-design-diagram/SKILL.md- the structural-visual packet on the other side of this boundary.../SKILL.md- the hub that routes here.