claude-slides

Slides

This skill is a local build of the claude.ai Slides artifact type: the rules below are the type's own, with the Artifact tool replaced by files on disk and this skill's scripts/artifact.mjs (The calls). A deck is a folder, <root>; its content is ITS OWN files under <root>/project/; write only there. The editor page (scripts/editor/, served by artifact.mjs open) reads those files and saves the user's edits back into them.

The deck exists

Work on THAT deck, its <root> in every command: never create another. Read <root>/project/deck.json: none, or its order is empty: an empty deck, see Creating. Else see Revising. If no deck exists yet: <root> = a new folder designs/<slug>/ named for the deck (designs/q3-review/) in the working directory, or where the user says; the deck's name goes in title (REQUIRED).

Tell the user what happens to the deck, never the mechanism. Asked to send it to apps like Canva: there is no Send to here; the editor's download menu saves PDF, HTML and PowerPoint (.pptx) files the user can import there. Naming slide 7 to the user? Link it too: open's url + #slide-7 (number, not id).

The deck's files

• project/deck.json, the index: {"v":4,"createdOnFiles":{"v":1,"at":"2026-09-14T18:20:00Z"},"lists":"css","title":"Q3","order":["cover","plan"],"cover":"cover","sections":{"s1":{"description":"Numbers","start":"cover"}},"faces":{"source-serif-4":{"family":"Source Serif 4","href":"https://fonts.googleapis.com/css2?family=Source+Serif+4:[email protected]&display=swap"}},"designSystems":[]}. createdOnFiles and lists: an index YOU create has both exactly so (no lists if the deck already had slides), at = now. order = slide ids in deck order. sections = your outline: any key → a run's one sentence and its first slide's id; the first starts at the cover. cover = the cover slide's id. Ids: [A-Za-z0-9_-]{1,64}. faces = one entry per typeface the slides name (at most 4), keyed by the family lowercased, spaces as -: family (a letter first, then letters, digits, spaces, _, -; 40 at most) plus EITHER href (only a https://fonts.googleapis.com/css2?… link) OR src: "/_blob/<id>" (an uploaded woff2/woff/ttf/otf, step 2) or "project/ds/<folder>/<path>" (step 3); a rule broken: the entry is ignored. Basic/generic faces need no entry. designSystems and project/ds/<folder>/: written only by the install (step 3). An existing index: keep every key you don't change, named here or not; never add lists; title empty or Untitled: set a name, else keep it.
• project/slides/<id>.html, one per slide: EXACTLY ONE <section id="<id>" …> in the slide format (below), nothing before or after it: no <html>, <head>, <title>, <link>, <style> or <body>. The file name is the slide id and the section's id equals it. A slide shows while its file exists; order places it (a file order leaves out shows last). Speaker notes: plain text in one <aside>, the section's LAST child, at most 4,000 characters; anyone who opens the deck can read them. Images: <img src> = /_blob/<id> or project/ds/<folder>/<path> (step 3); never a data: URI, other path or http(s) URL.
• project/assets/: the uploads (The calls); never write there yourself.