Glyph kit follows semantic versioning. Before 1.0, a minor version may change the spec format; the change is listed here with what to update.
Focus
M0 M1 M2 M3 M4 Jan 1200 ██ ██ ▒▒ ░░ ░░ Feb 1350 ██ ██ ▒▒ ░░ Mar 1100 ██ ██ ▒▒ Apr 1420 ██ ██ █ 80%+ ▓ 60%+ ▒ 40%+ ░ under 40% ► Every cohort halves between M1 and M2. SAMPLE DATA
The text gets a ► line, so it reads without colour. On screen the focus takes its tone, the rest recedes, and it arrives last.
Colour types
role token light #f7f6f1 words --color-ink ██ #151513 16.9 AAA secondary --color-muted ██ #6b6a64 5.0 AA accent --color-accent ██ #1f4fd6 6.2 AA problems --color-danger ██ #f08080 2.4 fails passes --color-success ██ #0a7a50 5.0 AA lines --color-line ██ #a3a199 2.4 ok Words need 4.5 to 1 (7 for AAA), marks 3, lines 1.5. SAMPLE DATA
Two new types: palette and colour roles. A swatch is drawn in its own colour; the text keeps the value, so it still reads.
Your colours
task 1 ███████ 92% task 2 █████▍ 71% task 3 ██▉ 38% SAMPLE DATA
task 1 ███████ 92% task 2 █████▍ 71% task 3 ██▉ 38% SAMPLE DATA
task 1 ███████ 92% task 2 █████▍ 71% task 3 ██▉ 38% SAMPLE DATA
task 1 ███████ 92% task 2 █████▍ 71% task 3 ██▉ 38% SAMPLE DATA
task 1 ███████ 92% task 2 █████▍ 71% task 3 ██▉ 38% SAMPLE DATA
task 1 ███████ 92% task 2 █████▍ 71% task 3 ██▉ 38% SAMPLE DATA
Five palettes, a theme from one hue, your own colours or your design system's tokens. Problems sit opposite the data and passes differ from them in lightness, so the colours mean something together. The builder's Colours menu has them all.
Editing
1 of 3 done [ █░░ ] █ done The lint passes █ done Sources named to do About 80 columns
glyph-kit read notes.md2 of 3 done [ ██░ ] █ done The lint passes █ done Sources named to do About 80 columns
Change the drawing and read it back, or change the spec and redraw. Only the figure changes; the rest of the file stays as it was.
CONTRIBUTING.md: what's welcome, the rules every change keeps and the checks to run. docs/adding-a-type.md walks through adding a type end to end, using palette.scripts/say.mjs reads lines such as "An email field. A Send button." into a screen spec (glyph-kit say "…"), from one closed list of names for each part, and says which words it couldn't place.check lists every problem at once: a missing source, a colour on one row, the type's own data checks, labels that will be cut and frames that don't close. Problems exit 1; notes don't. Works on a spec, a list of specs or a Markdown file.--with-spec on render --to markdown and export --to md writes the spec after the figure in a folded <details> block; a figure can also name a spec file on the line above it.redraw draws figures again in place. Only each figure's text and description change; the rest of the file stays as it was. redraw --check lists stale figures and exits 1, for CI or a pre-commit hook.read turns an edited drawing back into its spec for tables, token tables, decision logs, QA checklists, now/next/later boards and colour roles. Columns don't have to line up; nothing is written when an edit can't be read exactly. Guide: reference/editing.md."focus": { "on": ["M2"], "tone": "problem", "say": "Every cohort halves between M1 and M2." } names what to look at as it is drawn: a row label, a column heading, both, or any words in the figure. Instead of a colour on one row, which is still refused.► line with the point, so it reads without colour. HTML, decks, SVG, PNG, PDF and the terminal paint the focus in its tone (problem, good or plain) and let the rest of its block recede. In a heatmap, cohort or calendar strip the receded cells keep their ramp colour, dimmed, and a plain focus keeps its own. In HTML and decks the focus arrives last and lands with the inverted flash, and the figure still settles within 600ms.check lists it with everything else.palette: a tonal scale. One column per hue, one row per step, each step's contrast on the page; ▲ marks the first step that reads as words. Steps out of order are named. Four hues fit in 80 cells.colourRoles: what each colour is for. Role, token, light and dark values, each on its own page, and a verdict by use: words need 4.5 to 1 (7 for AAA), marks 3, lines 1.5, the same rule as the theme check.██ followed by its value. HTML, SVG, PNG, PDF and 24-bit terminals draw it in that colour; the text keeps the value, so it still reads.{ "base": "paper", "data": "#1f4fd6", "flag": "#b8421f" }. Put it on a spec, report or deck as theme, or pass --theme theme.json to render, export, deck and live. Guide: reference/colour.md.roles block in design-system.map.json points roles at your tokens. HTML and decks write the token's var(--…) so your CSS wins; SVG, PNG and PDF use its fallback colour. A token with no fallback is refused.--theme halloween: pumpkin data, bruise-purple lines and bone text on near-black, with its own ramp from bruise purple to pumpkin. In every form and in the site's Colours menu.paper becomes oxblood and green, ink coral and mint, phosphor amber and pale green, gilt terracotta and bright gold; phosphor and gilt passes no longer share the data colour. paper's pair also fell under 4.5 to 1 for those readers and now passes. Before and after: docs/palette-lightness.md.check theme.json and check spec.json --theme theme.json list them. docs/theme-rules.md has each palette against the rules.{ "base": "ink", "mixed": "#7a5cff" } or --theme mixed:#7a5cff:dark derives every role from one hue so that the four rules and every contrast check hold, light or dark. The builder's Colours menu has it as Mixed.░ ▒ ▓ █ in heatmap, cohort and calendarStrip, drawn solid in SVG. Elsewhere shades keep the data colour, so the density ladder means the same thing.NO_COLOR and --no-color turn it off; --color turns it on for a pipe. Markdown and files stay plain.autoplay(…, { solo: false }) lets a page play every moving diagram in view instead of one.color on a node, bar or row is refused.#c4401c to #b8391a) and its secondary text a touch darker (#6d6c66 to #6b6a64), so both reach 4.5 to 1 on the panel.paper's pair in light mode, ink's in dark.Existing specs need no changes.
{steps: [...]}.abResult readings over time ({ days, readings: [{ day, people, variants }] }) and it steps through them: the intervals narrow, numbers change in place, and the verdict switches when the intervals part. Without readings it is drawn as before.readout, dashboard, prSummary, designReview and statusUpdate. Each has fixed slots: a sentence, short lists and ordinary specs. Code places everything within 80 cells; figures share a row only when they fit with a 4-cell gap. HTML and PDF give one page in Departure Mono and the kit's palette, and a list of layouts exports as one document, a layout to a page. Guide: reference/areas/layouts.md.appShell (header, sidebar, content), cardGrid, listDetail and modal place the screen primitives in regions inside one frame.…; more than 16 rows end with "… and N more rows"; a layout that can't fit says so in plain words.glyph-kit.mjs guide <type> prints one type's spec and notes without reading a whole guide.… are listed on stderr with their limit, so the agent can shorten them. The agent works in the user's folder, not the skill's.skills/glyph-kit.anatomy, draws a component's container with its parts inside, numbered on their edges, and a legend of each part's name and rule; optional parts have dashed edges. Parts sit in a row (a text field) or a column (a card). It arrives part by part in number order, each part with its legend line.lang. An optional language tag, like "de" or "tr": numbers get local separators, uppercase follows the language, and HTML, decks, reports and MDX declare it.60 types in ten areas. Existing specs need no changes; regenerate standalone pages to get the new player and the font.
First public release.
--compact plain ASCII for model context; a token estimate and a warning when text likely costs more than an image.npx skills add, or by copying the folder for Claude Code or Codex.