Tufte-style charts

skill · published by agentleFS · version 1 · approved by frdchang@gmail.com on 2026-10-12

Clean, directly labelled charts from a JSON spec that read in light and dark mode: stacks, lines, slopegraphs, small multiples.

Mount

examples/readme-sections/stack.spec.json

{
 "_note": "README section headings in five public repos, each README read at the end of the year. themes.data.json comes from text-rule-trends/examples/readme-sections.",
 "data": "themes.data.json",
 "title": "API entries took a growing share of these READMEs",
 "subtitle": [
  "Five popular JavaScript and Python projects. Section headings per README went from {total_from:.1f} in {p_from} to {total_to:.1f} in {p_to},",
  "and entries for single API calls grew as a share while usage and how-to sections shrank."
 ],
 "key": "151 headings in 6 kinds and 4 themes. Colour by share of a README, {p_from} → {p_to}: [red]red[/] grew, [blue]blue[/] shrank, grey within 15%.",
 "ylabel": "average # headings / README",
 "share_label": "share of a README’s headings, {p_from} → {p_to}",
 "count_label": "READMEs",
 "y_step": 4,
 "arrow": ["{change_pct:+.0f}%: {total_from:.1f} → {total_to:.1f} headings"],
 "footnote": [
  "Data: every version of the README in chalk/chalk, expressjs/cors, sindresorhus/ky, pallets/itsdangerous and jshttp/mime-types (collected 2026-10-11).",
  "Each README as it stood on Dec 31 of the year; a heading is a #, ## or ### line. Headings were embedded (bge-small), grouped by k-means into 6 kinds,",
  "and grouped by hand into 4 themes. Five repos are an example, not a sample. Between bins, interpolated."
 ]
}