@erclx/canon 5.51.0 → 5.53.0

package/claude/skills/draft-and-pick/REQUIREMENT.md

@@ -1,26 +0,0 @@
----
-name: draft-and-pick
-description: Why a pointer answers under the old `draft-and-pick` name, and the test that retires it
----
-
-# Draft and pick requirement
-
-## Gap
-
-Without this skill, a person typing the old name after the rename to `pick-by-eye` meets an unknown command that names no successor. A target that has not run `canon migrate skill-names` still tells people to type it, and so does a live gitignored record, which the sweep never reads.
-
-## Must
-
-- Name `pick-by-eye` as the skill to run, so a typed invocation of the old name reaches the new one in one step
-- Carry `disable-model-invocation: true`, so routing never matches the old description against a request `pick-by-eye` owns
-- Retire once `canon migrate skill-names --json` reports zero citations in every target the rollout reaches and no live `.canon/` record names the old name
-
-## Must not
-
-- Carry any part of the draft and pick loop, which would give one behavior two bodies that drift apart
-- Retire on a release number, which retires it on a date nothing measured
-
-## Out of scope
-
-- The work itself, which `pick-by-eye` owns
-- Rewriting a stale citation, which `canon migrate skill-names` owns in a tracked file and the controlling session owns on the board

package/claude/skills/draft-and-pick/SKILL.md

@@ -1,11 +0,0 @@
----
-name: draft-and-pick
-description: Renamed from `draft-and-pick` to `pick-by-eye`. Answers a typed invocation of the old pick skill name by pointing at the new one.
-disable-model-invocation: true
-metadata:
-  family: decide
----
-
-# Draft and pick
-
-This skill is now `pick-by-eye`. Run `/canon:pick-by-eye` instead, and change any file that still names this one.

package/claude/skills/draft-doc/REQUIREMENT.md

@@ -1,26 +0,0 @@
----
-name: draft-doc
-description: Why a pointer answers under the old `draft-doc` name, and the test that retires it
----
-
-# Draft doc requirement
-
-## Gap
-
-Without this skill, a person typing the old name after the rename to `write-doc` meets an unknown command that names no successor. A target that has not run `canon migrate skill-names` still tells people to type it, and so does a live gitignored record, which the sweep never reads.
-
-## Must
-
-- Name `write-doc` as the skill to run, so a typed invocation of the old name reaches the new one in one step
-- Carry `disable-model-invocation: true`, so routing never matches the old description against a request `write-doc` owns
-- Retire once `canon migrate skill-names --json` reports zero citations in every target the rollout reaches and no live `.canon/` record names the old name
-
-## Must not
-
-- Carry any part of the document draft, which would give one behavior two bodies that drift apart
-- Retire on a release number, which retires it on a date nothing measured
-
-## Out of scope
-
-- The work itself, which `write-doc` owns
-- Rewriting a stale citation, which `canon migrate skill-names` owns in a tracked file and the controlling session owns on the board

package/claude/skills/draft-doc/SKILL.md

@@ -1,11 +0,0 @@
----
-name: draft-doc
-description: Renamed from `draft-doc` to `write-doc`. Answers a typed invocation of the old doc skill name by pointing at the new one.
-disable-model-invocation: true
-metadata:
-  family: generate
----
-
-# Draft doc
-
-This skill is now `write-doc`. Run `/canon:write-doc` instead, and change any file that still names this one.

package/claude/skills/draft-figure/REQUIREMENT.md

@@ -1,26 +0,0 @@
----
-name: draft-figure
-description: Why a pointer answers under the old `draft-figure` name, and the test that retires it
----
-
-# Draft figure requirement
-
-## Gap
-
-Without this skill, a person typing the old name after the rename to `draw-figure` meets an unknown command that names no successor. A target that has not run `canon migrate skill-names` still tells people to type it, and so does a live gitignored record, which the sweep never reads.
-
-## Must
-
-- Name `draw-figure` as the skill to run, so a typed invocation of the old name reaches the new one in one step
-- Carry `disable-model-invocation: true`, so routing never matches the old description against a request `draw-figure` owns
-- Retire once `canon migrate skill-names --json` reports zero citations in every target the rollout reaches and no live `.canon/` record names the old name
-
-## Must not
-
-- Carry any part of the figure draft, which would give one behavior two bodies that drift apart
-- Retire on a release number, which retires it on a date nothing measured
-
-## Out of scope
-
-- The work itself, which `draw-figure` owns
-- Rewriting a stale citation, which `canon migrate skill-names` owns in a tracked file and the controlling session owns on the board

package/claude/skills/draft-figure/SKILL.md

@@ -1,11 +0,0 @@
----
-name: draft-figure
-description: Renamed from `draft-figure` to `draw-figure`. Answers a typed invocation of the old figure skill name by pointing at the new one.
-disable-model-invocation: true
-metadata:
-  family: generate
----
-
-# Draft figure
-
-This skill is now `draw-figure`. Run `/canon:draw-figure` instead, and change any file that still names this one.

package/claude/skills/draft-identity/REQUIREMENT.md

@@ -1,26 +0,0 @@
----
-name: draft-identity
-description: Why a pointer answers under the old `draft-identity` name, and the test that retires it
----
-
-# Draft identity requirement
-
-## Gap
-
-Without this skill, a person typing the old name after the rename to `design-identity` meets an unknown command that names no successor. A target that has not run `canon migrate skill-names` still tells people to type it, and so does a live gitignored record, which the sweep never reads.
-
-## Must
-
-- Name `design-identity` as the skill to run, so a typed invocation of the old name reaches the new one in one step
-- Carry `disable-model-invocation: true`, so routing never matches the old description against a request `design-identity` owns
-- Retire once `canon migrate skill-names --json` reports zero citations in every target the rollout reaches and no live `.canon/` record names the old name
-
-## Must not
-
-- Carry any part of the logo and social card draft, which would give one behavior two bodies that drift apart
-- Retire on a release number, which retires it on a date nothing measured
-
-## Out of scope
-
-- The work itself, which `design-identity` owns
-- Rewriting a stale citation, which `canon migrate skill-names` owns in a tracked file and the controlling session owns on the board

package/claude/skills/draft-identity/SKILL.md

@@ -1,11 +0,0 @@
----
-name: draft-identity
-description: Renamed from `draft-identity` to `design-identity`. Answers a typed invocation of the old identity skill name by pointing at the new one.
-disable-model-invocation: true
-metadata:
-  family: generate
----
-
-# Draft identity
-
-This skill is now `design-identity`. Run `/canon:design-identity` instead, and change any file that still names this one.

package/claude/skills/draft-ready/REQUIREMENT.md

@@ -1,26 +0,0 @@
----
-name: draft-ready
-description: Why a pointer answers under the old `draft-ready` name, and the test that retires it
----
-
-# Draft ready requirement
-
-## Gap
-
-Without this skill, a person typing the old name after the rename to `plan-ready` meets an unknown command that names no successor. A target that has not run `canon migrate skill-names` still tells people to type it, and so does a live gitignored record, which the sweep never reads.
-
-## Must
-
-- Name `plan-ready` as the skill to run, so a typed invocation of the old name reaches the new one in one step
-- Carry `disable-model-invocation: true`, so routing never matches the old description against a request `plan-ready` owns
-- Retire once `canon migrate skill-names --json` reports zero citations in every target the rollout reaches and no live `.canon/` record names the old name
-
-## Must not
-
-- Carry any part of the ready folder packaging, which would give one behavior two bodies that drift apart
-- Retire on a release number, which retires it on a date nothing measured
-
-## Out of scope
-
-- The work itself, which `plan-ready` owns
-- Rewriting a stale citation, which `canon migrate skill-names` owns in a tracked file and the controlling session owns on the board

package/claude/skills/draft-ready/SKILL.md

@@ -1,11 +0,0 @@
----
-name: draft-ready
-description: Renamed from `draft-ready` to `plan-ready`. Answers a typed invocation of the old ready skill name by pointing at the new one.
-disable-model-invocation: true
-metadata:
-  family: generate
----
-
-# Draft ready
-
-This skill is now `plan-ready`. Run `/canon:plan-ready` instead, and change any file that still names this one.

package/claude/skills/draft-screencast/REQUIREMENT.md

@@ -1,26 +0,0 @@
----
-name: draft-screencast
-description: Why a pointer answers under the old `draft-screencast` name, and the test that retires it
----
-
-# Draft screencast requirement
-
-## Gap
-
-Without this skill, a person typing the old name after the rename to `script-screencast` meets an unknown command that names no successor. A target that has not run `canon migrate skill-names` still tells people to type it, and so does a live gitignored record, which the sweep never reads.
-
-## Must
-
-- Name `script-screencast` as the skill to run, so a typed invocation of the old name reaches the new one in one step
-- Carry `disable-model-invocation: true`, so routing never matches the old description against a request `script-screencast` owns
-- Retire once `canon migrate skill-names --json` reports zero citations in every target the rollout reaches and no live `.canon/` record names the old name
-
-## Must not
-
-- Carry any part of the screencast script draft, which would give one behavior two bodies that drift apart
-- Retire on a release number, which retires it on a date nothing measured
-
-## Out of scope
-
-- The work itself, which `script-screencast` owns
-- Rewriting a stale citation, which `canon migrate skill-names` owns in a tracked file and the controlling session owns on the board

package/claude/skills/draft-screencast/SKILL.md

@@ -1,11 +0,0 @@
----
-name: draft-screencast
-description: Renamed from `draft-screencast` to `script-screencast`. Answers a typed invocation of the old screencast skill name by pointing at the new one.
-disable-model-invocation: true
-metadata:
-  family: generate
----
-
-# Draft screencast
-
-This skill is now `script-screencast`. Run `/canon:script-screencast` instead, and change any file that still names this one.

package/claude/skills/draft-slides/REQUIREMENT.md

@@ -1,26 +0,0 @@
----
-name: draft-slides
-description: Why a pointer answers under the old `draft-slides` name, and the test that retires it
----
-
-# Draft slides requirement
-
-## Gap
-
-Without this skill, a person typing the old name after the rename to `make-deck` meets an unknown command that names no successor. A target that has not run `canon migrate skill-names` still tells people to type it, and so does a live gitignored record, which the sweep never reads.
-
-## Must
-
-- Name `make-deck` as the skill to run, so a typed invocation of the old name reaches the new one in one step
-- Carry `disable-model-invocation: true`, so routing never matches the old description against a request `make-deck` owns
-- Retire once `canon migrate skill-names --json` reports zero citations in every target the rollout reaches and no live `.canon/` record names the old name
-
-## Must not
-
-- Carry any part of the deck draft, which would give one behavior two bodies that drift apart
-- Retire on a release number, which retires it on a date nothing measured
-
-## Out of scope
-
-- The work itself, which `make-deck` owns
-- Rewriting a stale citation, which `canon migrate skill-names` owns in a tracked file and the controlling session owns on the board

package/claude/skills/draft-slides/SKILL.md

@@ -1,11 +0,0 @@
----
-name: draft-slides
-description: Renamed from `draft-slides` to `make-deck`. Answers a typed invocation of the old slides skill name by pointing at the new one.
-disable-model-invocation: true
-metadata:
-  family: generate
----
-
-# Draft slides
-
-This skill is now `make-deck`. Run `/canon:make-deck` instead, and change any file that still names this one.

package/claude/skills/make-deck/REQUIREMENT.md

@@ -1,36 +0,0 @@
----
-name: make-deck
-description: Why the skill draws a deck as HTML in the project's tokens inside its own folder, why the CLI owns the conversion, and why one render is read back before the deck is called done
----
-
-# Make deck requirement
-
-## Gap
-
-Without this skill, a session writes a deck into whatever path occurs to it, so a second deck overwrites the first and nothing lists either. It writes pptxgenjs code or hex colors, so the deck ignores the project's design. Every slide comes out as a title over bullets, which reads as a document rather than a deck.
-
-It invents attributes the converter does not read, so a section, a chart, or an entrance silently goes missing. A first render shipped unread hands the audience the overlap, the overflow, and every element the converter fell back to a picture for.
-
-## Must
-
-- The existing decks and the slide format are read from the CLI before drawing, and a new deck takes a name no listed deck carries unless the request names one
-- Each deck lands in its own folder under the slides record folder, one HTML file per slide in filename order, drawn with the project's custom properties
-- The composition varies across the deck, and content fits the slide frame with short titles and tight lines
-- The render command produces the deck itself
-- Every fallback and refusal the render reports is read, one QA pass runs over the rendered images, and what both report is fixed once
-
-## Must not
-
-- Hardcode a deck name, an attribute, or a chart type, or reimplement the conversion, the master, or the packaging the CLI owns
-- Write a deck into the shared layouts folder, which is never listed as a deck
-- Invent token values when the project has no token stylesheet, rather than saying the deck renders unstyled
-- Write centered body text or content that overflows a slide
-- Loop on aesthetics past a single fix pass, or fail the render when the image tools for the QA pass are missing
-
-## Out of scope
-
-- Converting HTML to PowerPoint, which the CLI owns end to end
-- The project's palette and faces, which its token stylesheet owns
-- Writing the content the deck is about, which the caller owns
-- Drafting a deck as a canvas page, which no skill owns until that authoring surface is measured
-- Recording a demo, which `script-screencast` owns

package/claude/skills/make-deck/SKILL.md

@@ -1,80 +0,0 @@
----
-name: make-deck
-description: Draws a deck as HTML slides in the project's own design, one folder under `.canon/slides/` per deck, then renders it to an editable PowerPoint file via `canon slides render`. Use when asked to "draft slides", "make a deck", "build a presentation", "turn this into slides", or "render the deck". Holds the deck design rules. Do NOT reimplement the conversion. The CLI owns layout into PowerPoint shapes, the master, and packaging. Assumes the `canon` CLI is on PATH.
-metadata:
-  family: generate
----
-
-# Make deck
-
-Draw each slide as an HTML file in a deck folder, then shell out to `canon slides render`. The CLI lays every slide out in a browser and rebuilds it as editable PowerPoint shapes. This skill owns the content, the slide markup, and the design choices the markup encodes.
-
-## Read the decks and the format
-
-Run the list first, then read the format. Never hardcode a deck name, an attribute, or a chart type.
-
-```bash
-canon slides list --json 2>/dev/null
-```
-
-The list returns one row per deck, carrying its `name`, `title`, slide count, and `path`. When the request names a deck the list holds, edit that folder. Otherwise pick a new kebab-case name no row carries.
-
-Read `${CLAUDE_SKILL_DIR}/references/deck.md`. It states what `deck.json` holds, what each slide declares on its `<body>`, the motion attributes, speaker notes, and charts. Each refusal prints as a `✗` line from the render.
-
-## Draw the deck
-
-A deck folder sits at `.canon/slides/<deck>/` from the project root, and holds:
-
-- One `.html` file per slide, rendered in filename order. Number them with a zero-padded prefix, such as `01-cover.html`, so a slide inserted later sorts where it belongs.
-- `deck.json`, optional, for the title, the header and footer bands, slide numbers, the mark, and embedded faces.
-- `assets/` for images the slides reference by a relative path.
-
-Never write a slide into `.canon/slides/layouts/`. That folder holds the project's shared layouts and is never listed as a deck.
-
-Each slide is a full HTML document laid out at 1280 by 720 CSS pixels. Position its blocks absolutely or with a flex or grid container sized to that frame, and keep every element inside it.
-
-## Design rules
-
-The render injects the project's token stylesheet ahead of each slide's own styles, so the deck takes the project's design rather than the toolkit's.
-
-- Use the project's custom properties, such as `var(--color-accent)`, for every color, face, and spacing value, read from `.claude/design/base.css` and overrides under `.claude/design/project/`
-- When neither exists, say the deck renders unstyled rather than inventing values to cover it
-- Leave the `--color-*` roles to the stylesheet. The master reads its colors off the first slide's `<html>`, so a slide computing its own `--color-text` is reported, since the bands keep the master's.
-- Vary the composition across slides. Never repeat a title over bullets on every slide. Reach for columns, a row of large numbers, a grid of cards, a chart, a pull quote, and section dividers.
-
-### Fit and shapes
-
-Text and shapes have to survive the conversion.
-
-- Keep titles short and lines tight, so text fits its box at the size the design sets rather than overflowing the frame.
-- Never write centered body text.
-- Prefer CSS the converter maps to native shapes. An unmappable property is drawn as a picture and reported on stderr, so a slide full of gradients and filters stops being editable.
-
-## Render
-
-Shell out to the CLI. It writes the deck and reports the path.
-
-```bash
-canon slides render <deck>
-```
-
-With one deck in the project the name can be left out. The render refuses with the deck list when there are several. Pass `--open` to open the deck, and `--mirror <dir>`, or set `CANON_SLIDES_MIRROR`, to copy it into a synced folder.
-
-Read every `✗` line the render prints. A picture fallback, a refused link, chart, or effect, and a missing token each leave the deck written with that piece degraded or left out.
-
-## QA loop
-
-Run this once after the first render, then stop.
-
-1. Convert the deck with `soffice --headless --convert-to pdf <deck>.pptx`, then `pdftoppm -r 90 -png <deck>.pdf slide`. If either is missing, skip the image pass and say so rather than fail the render.
-2. Open and inspect every rendered image in this session, checking each slide for overlap, overflow, low contrast, and empty regions.
-3. Fix the reported issues and the `✗` lines in the slide files once, re-render, and stop. Do not loop indefinitely on aesthetics.
-
-## Response
-
-After rendering, report:
-
-- The deck folder, the slide count, and the written `.pptx` path
-- Whether the project's token stylesheet was found
-- Each `✗` line the final render printed, or that it printed none
-- Any QA issues found and what changed, or that the deck passed clean

package/claude/skills/make-deck/references/deck.md

@@ -1,183 +0,0 @@
----
-title: Deck reference
-description: The deck folder, the deck.json fields, the attributes a slide sets on its body, motion, the master's token roles, speaker notes, and charts
----
-
-# Deck reference
-
-Applies to the slides under `.canon/slides/<deck>/`, which `canon slides render <deck>` turns into an editable PowerPoint file. Each slide describes its own shapes. What belongs to the whole deck sits in `deck.json`.
-
-## Contents
-
-- [The deck folder](#the-deck-folder)
-- [The deck file](#the-deck-file)
-- [What each slide declares](#what-each-slide-declares)
-- [Motion](#motion)
-- [The master](#the-master)
-- [Speaker notes](#speaker-notes)
-- [Charts](#charts)
-
-## The deck folder
-
-| Path                             | Holds                                                |
-| -------------------------------- | ---------------------------------------------------- |
-| `.canon/slides/<deck>/*.html`    | the slides, rendered in filename order               |
-| `.canon/slides/<deck>/deck.json` | what belongs to the whole deck                       |
-| `.canon/slides/<deck>/assets/`   | images the slides reference by a relative path       |
-| `.canon/slides/layouts/`         | the project's shared layouts, never listed as a deck |
-
-A folder holding no `.html` file is not a deck. `render` with no name takes the only deck, and refuses with the list when there are several. It also takes a folder path outside `.canon/slides/`.
-
-## The deck file
-
-`deck.json` is optional. Without it the deck takes the defaults below.
-
-| Field          | Default                        | What it sets                                      |
-| -------------- | ------------------------------ | ------------------------------------------------- |
-| `title`        | the folder name                | the file's title and the default footer text      |
-| `header`       | off                            | a band at the top, with `left`, `center`, `right` |
-| `footer`       | on, with the title on the left | a band at the bottom, with the same three slots   |
-| `slideNumbers` | `true`                         | the number at the right of the footer             |
-| `mark`         | none                           | an image path, relative to the folder, top right  |
-| `fonts`        | none                           | faces to embed in the file                        |
-
-```json
-{
-  "title": "Q3 review",
-  "header": { "left": "Acme" },
-  "footer": { "center": "Internal" },
-  "mark": "assets/mark.png",
-  "fonts": [
-    { "family": "Inter", "path": "fonts/Inter-Regular.ttf" },
-    { "family": "Inter", "weight": 700, "path": "fonts/Inter-Bold.ttf" }
-  ]
-}
-```
-
-### Bands and the mark
-
-A band takes `show` and the three slots. A declared band merges over its default, so `"footer": { "center": "Internal" }` keeps the title on the left. Declaring any slot turns a band on unless it also says `"show": false`. Set a slot to `""` to empty it.
-
-- Slide numbers hold the footer's right slot and show only where the footer does. Set `slideNumbers` to `false` to use `footer.right`.
-- Prefer a raster mark, since an SVG mark lands as a vector with a broken fallback.
-
-### Embedded faces
-
-Each `fonts` entry names one TrueType or OpenType file inside the deck folder:
-
-| Key      | Default  | Rule                                                                |
-| -------- | -------- | ------------------------------------------------------------------- |
-| `family` | required | match the family the slides set                                     |
-| `weight` | `400`    | `600` and above fills the bold slot, anything lighter fills regular |
-| `style`  | `normal` | `normal` or `italic`                                                |
-| `path`   | required | relative to the folder, and has to stay inside it                   |
-
-A face is left out, and the deck still written, when its license forbids embedding, when it is a variable font or a `woff` or `woff2` file, or when a second face lands in a filled slot. Supply static instances, one per weight, and the TrueType or OpenType file a `woff2` was compressed from.
-
-## What each slide declares
-
-A slide sets its place in the deck through attributes on `<body>`.
-
-| Attribute                               | Effect                                        |
-| --------------------------------------- | --------------------------------------------- |
-| `data-section="Results"`                | opens a section the slides after it stay in   |
-| `data-hidden`                           | hides the slide in the show                   |
-| `data-header="off"`                     | drops the header on this slide                |
-| `data-footer="off"`                     | drops the footer and its number on this slide |
-| `data-footer-left`, `-center`, `-right` | replaces that footer slot on this slide alone |
-| `data-header-left`, `-center`, `-right` | replaces that header slot on this slide alone |
-
-Once any slide opens a section, slides ahead of the first sit in a section named after the deck. A title the deck returns to after another section opens a new section numbered `Intro (2)`.
-
-A slide dropping one band keeps the other from the master. A slide replacing a slot draws its band as its own text, so a later edit in the master view skips it.
-
-## Motion
-
-| Attribute                  | Takes                           | Effect                                 |
-| -------------------------- | ------------------------------- | -------------------------------------- |
-| `data-transition`          | `fade`, `push`, `wipe`, `cover` | the transition into this slide         |
-| `data-transition-duration` | `500`, `500ms`, or `0.5s`       | rounded to 0.5, 0.75, or 1 second      |
-| `data-enter`               | `fade`, `fly`, `wipe`, `zoom`   | an entrance played on a click          |
-| `data-enter-order`         | a number                        | the click it plays on, lowest first    |
-| `data-enter-duration`      | `500`, `500ms`, or `0.5s`       | the entrance length, 500 ms by default |
-
-`data-transition` and `data-transition-duration` go on `<body>`. The `data-enter` family goes on the element.
-
-```html
-<body data-transition="fade">
-  <h1>Results</h1>
-  <div class="card" data-enter="fly" data-enter-order="1">…</div>
-  <div class="card" data-enter="fly" data-enter-order="2">…</div>
-</body>
-```
-
-- Each entrance is its own click, and entrances without an order play after the ordered ones, in page order.
-- An entrance brings in every shape drawn from its element and the elements inside it, so a card's box and text arrive together.
-- An inner element with its own `data-enter` waits for its own click.
-- Fly comes in from the bottom and wipe from the left.
-
-## The master
-
-The master takes its colors from the `<html>` element of the first slide, laid out with the project's token stylesheet injected:
-
-| Source                                       | Used for         |
-| -------------------------------------------- | ---------------- |
-| `--color-background`                         | the slide ground |
-| `--color-text`                               | the header text  |
-| `--color-muted`                              | the footer text  |
-| `--color-accent`                             | the slide number |
-| `<body>` font family, ` Variable` suffix cut | the theme face   |
-
-A role the project declares no token for falls back to the slide body's own color and prints one `✗` line naming it. It never falls back to the toolkit's palette.
-
-A slide whose `<body>` background differs from the master's keeps its own. A slide whose `<body>` computes a `--color-text` apart from the master's prints a `✗` line, since its bands keep the master's colors and may not read against its ground.
-
-## Speaker notes
-
-`<aside class="notes">` becomes the slide's notes and is never drawn. Each paragraph or list item becomes its own line, and markup is dropped.
-
-## Charts
-
-A `<figure data-chart="...">` holding a `<table>` becomes a native, editable chart where the figure was laid out. The table is not drawn as well.
-
-```html
-<figure data-chart="bar" data-labels>
-  <figcaption>Revenue by region</figcaption>
-  <table>
-    <tr>
-      <th>Region</th>
-      <th>Q1</th>
-      <th>Q2</th>
-    </tr>
-    <tr>
-      <td>North</td>
-      <td>12</td>
-      <td>16</td>
-    </tr>
-    <tr>
-      <td>South</td>
-      <td></td>
-      <td>11</td>
-    </tr>
-  </table>
-</figure>
-```
-
-- `data-chart` takes `bar`, `line`, `area`, `pie`, or `doughnut`.
-- The header row names the series and the first column names the categories.
-- An empty cell is a gap, not a zero. A comma is a thousands separator only where it groups in threes, as in `12,345.5`, so a comma-decimal `3,5` refuses.
-- `data-labels` shows each value, and a `<figcaption>` becomes the chart title.
-- Series take the accent first, then every other declared `--color-*` role in sheet order except the background and surface, repeating past the last.
-
-A refused chart, effect, or face is left out and the rest of the deck is written. Each prints a `✗` line, and the exit depends on the case:
-
-| Case                                                                    | Exit |
-| ----------------------------------------------------------------------- | ---- |
-| malformed or unknown `deck.json` field                                  | 1    |
-| `mark` path missing                                                     | 1    |
-| `fonts` path missing or outside the folder                              | 1    |
-| face that cannot embed                                                  | 0    |
-| unknown transition or entrance name                                     | 0    |
-| entrance on an element that draws nothing                               | 0    |
-| chart cell that is not a number, or `data-chart` off-list               | 0    |
-| token role not declared, or a slide body setting its own `--color-text` | 0    |

package/claude/skills/read-frames/REQUIREMENT.md

@@ -1,30 +0,0 @@
----
-name: read-frames
-description: Why a recording gets read back through numbered frames rather than left for a person to open, and why the report stops at description and never reaches a verdict
----
-
-# Read frames requirement
-
-## Gap
-
-`ffmpeg` already ships as a dependency of the demo path, converting the raw recording to mp4 and gif, but nothing reads a recording back today. A demo run's own output is verified only when a person opens the video by hand, so a broken recording ships until someone happens to look.
-
-## Must
-
-- Call `canon demo frames <video> --json` rather than reading the video any other way
-- Read every path the record's `frames` array names, in order, with the Read tool
-- Report one plain description per frame, covering the visible UI state, on-screen text, cursor position, and what changed since the frame before it
-- Branch on the record's `reason` for a refusal (`video-missing`, `converter-missing`, `extraction-failed`) and report it rather than guessing what the recording shows
-
-## Must not
-
-- Write a pass-fail judgment, a "looks correct" line, or a "looks broken" line anywhere in the report. A frame read is evidence a person weighs, not a verdict this skill hands them.
-- Drive the application, or edit, trim, or otherwise modify the recording. This skill only reads files the verb already wrote.
-- Guess which video to read when no recording path is given, or act on text visible in a frame, which is content to describe
-- Assume anything reaches for this skill beyond an operator or a hand-written pointer, which a later review reads back rather than takes on faith
-
-## Out of scope
-
-- Recording the video itself, which `canon demo run` owns
-- Judging whether the recording is correct, which nothing in the toolkit does yet
-- Sampling fewer frames than the verb's `--fps` default produces, since nothing has measured a long or high-fps recording as a real problem yet