Bento, the office suite that fits in a file
TypeScript mit-licenseofficeoffice-365office-suiteoffice-toolsoffice365open-sourcepowerpointself-hostedsingle-page-appslidesslideshareslideshowslideshow-galleryslideshow-makerslideshows
bento-slides skill: rename, plugin marketplace, zip install, self-bootstrap
nyblnet0fad2b4183b9
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.jsonnew file mode 100644index 00000000..b1b87d6f--- /dev/null+++ b/.claude-plugin/marketplace.json@@ -0,0 +1,14 @@+{+ "name": "bento",+ "owner": { "name": "The Bento/Suite authors", "url": "https://bento.page" },+ "plugins": [+ {+ "name": "bento-slides",+ "source": "./plugins/bento-slides",+ "description": "Author Bento presentations — self-contained .bento.html decks with morph transitions, live charts and speaker notes. Starts from nothing: downloads the latest Bento app automatically.",+ "homepage": "https://bento.page",+ "license": "MIT",+ "keywords": ["slides", "presentation", "deck", "bento", "powerpoint"]+ }+ ]+}diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 61273959..f3730468 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -9,6 +9,16 @@ below opens files from every earlier version, and unknown fields are preserved.This project's versions roughly follow semantic-ish `0.MINOR.PATCH` while it ispre-1.0.+## [Unreleased]++- **Skill renamed `bento-deck` → `bento-slides`** and moved into a Claude Code+ plugin marketplace at the repo root (`/plugin marketplace add nyblnet/bento`,+ then `/plugin install bento-slides@bento`). Also published as a claude.ai+ uploadable zip (`bento.page/skills/bento-slides.zip`); the old+ `skills/bento-deck/SKILL.md` URL keeps serving the current skill. The skill+ now bootstraps from nothing: it downloads the latest signed release itself,+ so "make me a deck" works in an empty folder.+## [1.0.3] — 2026-07-21- **Fine-grained collaboration (per-person keys).** New decks mint an OWNERdiff --git a/README.md b/README.mdindex 7aa3cd05..4dfed078 100644--- a/README.md+++ b/README.md@@ -51,7 +51,9 @@ no plugin, no API. Two ways in:- **File harnesses** edit the `#bento-doc` JSON in place:[Claude Code](https://claude.com/claude-code), Cursor, Aider, or any agent- with filesystem access. Claude Code users get a packaged `bento-deck` skill.+ with filesystem access. Claude Code users get a packaged `bento-slides`+ skill (installable from this repo's plugin marketplace: `/plugin marketplace+ add nyblnet/bento`) that even downloads the latest Bento app by itself.- **Chat round-trip** for any chatbot: copy the document JSON out (*About →Copy document JSON*), let the assistant rewrite it, paste it back.diff --git a/docs/agents.md b/docs/agents.mdindex f1ae26fd..18bc6f5a 100644--- a/docs/agents.md+++ b/docs/agents.md@@ -15,13 +15,25 @@ carry features beyond this guide; unknown keys are ignored, never fatal.*Drop this file into your context (or point your harness at it) and you canauthor and edit Bento presentations directly. Also published at[bento.page/agents.md](https://bento.page/agents.md). For **Claude Code**,-install the packaged skill once and it triggers automatically (or via-`/bento-deck`):*+install the packaged **bento-slides** skill once and it triggers automatically+(or via `/bento-slides`) — it can even download the latest Bento app itself,+so a deck can be authored from an empty folder:*++```+/plugin marketplace add nyblnet/bento+/plugin install bento-slides@bento+```++*…or as a plain personal skill:*```bash-mkdir -p ~/.claude/skills/bento-deck && curl -fsSL https://bento.page/skills/bento-deck/SKILL.md -o ~/.claude/skills/bento-deck/SKILL.md+mkdir -p ~/.claude/skills/bento-slides && curl -fsSL https://bento.page/skills/bento-slides/SKILL.md -o ~/.claude/skills/bento-slides/SKILL.md```+*(claude.ai / Claude Desktop: upload+[bento.page/skills/bento-slides.zip](https://bento.page/skills/bento-slides.zip)+under Settings → Skills.)*+A Bento deck (`*.bento.html`) is a self-contained HTML file. The documentlives in ONE plaintext block near the top:@@ -140,6 +152,10 @@ each kind of content to the feature built for it:## Minimal valid document+Start from this skeleton when creating a deck from scratch. `size` and+`theme` (including `fontFamily`) are **required** — the app will not boot+without them — and elements should carry the full field set shown.+```json{"format": "bento/slides", "version": 1, "title": "My deck",diff --git a/plugins/bento-slides/.claude-plugin/plugin.json b/plugins/bento-slides/.claude-plugin/plugin.jsonnew file mode 100644index 00000000..ce3a3c86--- /dev/null+++ b/plugins/bento-slides/.claude-plugin/plugin.json@@ -0,0 +1,10 @@+{+ "name": "bento-slides",+ "description": "Author Bento presentations — self-contained .bento.html decks with morph transitions, live charts and speaker notes. Starts from nothing: downloads the latest Bento app automatically.",+ "version": "1.0.3",+ "author": { "name": "The Bento/Suite authors", "url": "https://bento.page" },+ "homepage": "https://bento.page",+ "repository": "https://github.com/nyblnet/bento",+ "license": "MIT",+ "keywords": ["slides", "presentation", "deck", "bento", "powerpoint"]+}diff --git a/skills/bento-deck/SKILL.md b/plugins/bento-slides/skills/bento-slides/SKILL.mdsimilarity index 65%rename from skills/bento-deck/SKILL.mdrename to plugins/bento-slides/skills/bento-slides/SKILL.mdindex e4a8f176..926387ab 100644--- a/skills/bento-deck/SKILL.md+++ b/plugins/bento-slides/skills/bento-slides/SKILL.md@@ -1,12 +1,14 @@----name: bento-deck+name: bento-slidesdescription: >-- Author and edit Bento presentations — single-file .bento.html decks whose- document is plain JSON in a "#bento-doc" script block. Use when creating or- improving a Bento slide deck from source material: it maps content to the- right feature (charts, morph transitions, state slides, ken-burns, motion- paths) instead of producing static text slides, then writes the document- JSON in place. Full schema + recipes at https://bento.page/agents.md.+ Create and edit Bento presentations — single-file .bento.html decks whose+ document is plain JSON in a "#bento-doc" script block. Use whenever the user+ wants a slide deck or presentation: starting from NOTHING (it downloads the+ latest Bento app from bento.page automatically), from source material, or by+ improving an existing .bento.html. Maps content to the right feature+ (charts, morph transitions, state slides, ken-burns, motion paths) instead+ of static text slides, then writes the document JSON in place. Full schema ++ recipes at https://bento.page/agents.md.---# Authoring Bento decks@@ -21,9 +23,39 @@ JSON in a single block:You edit **that block only**, in place. Escape every `<` in the JSON as`<` so it can never contain a literal `</script>`. Leave the rest of thefile (the compressed runtime) untouched. In a chat context instead, the user-copies the JSON out (*About → Copy document JSON*) and pastes your replacement-back (*Replace document from JSON*); `window.bento.loadDoc(json)` does it from-the console.+copies the JSON out (*Save ▾ → Copy document JSON*) and pastes your+replacement back (*Save ▾ → Replace from JSON…*); `window.bento.loadDoc(json)`+does it from the console.++## Starting from nothing++The user does NOT need Bento installed — the app ships inside every deck.+When there is no `.bento.html` to edit, fetch the latest signed release+yourself and author into it:++```bash+# name the file after the deck's topic, e.g. Q4_Review.bento.html+curl -fsSL https://bento.page/releases/slides/Bento_Slides.bento.html -o "<Topic>.bento.html"+```++(Windows without curl: `iwr https://bento.page/releases/slides/Bento_Slides.bento.html -OutFile <Topic>.bento.html`.)++Then verify the download contains `id="bento-doc"`, and **replace** that+block's JSON (it ships with a showcase deck — discard it) with your document.+Rules for a fresh document:++- **Fetch https://bento.page/agents.md BEFORE authoring** and start from its+ "Minimal valid document" skeleton. `size` and `theme` (including+ `theme.fontFamily`) are **required** — the app will not boot without them.+- **Fully specify element fields** as the skeleton shows (shapes need+ `stroke`/`strokeWidth`; text needs `fontFamily`/`align`/`valign`) — missing+ fields render wrong or not at all.+- **Omit `docId` and `collab` entirely**: the app mints a fresh identity and+ dormant collaboration credentials on first open.++When done, offer to open it (`open` / `xdg-open` / `start`) — the file boots+straight into the editor with the finished deck. Aim for one pass from+request to opened deck.## Workflow@@ -81,7 +113,8 @@ the console.data URI in `src` (self-contained) or references a URL for big files (keepsthe deck small). `autoplay` runs only in present mode and needs `muted:true`for video. Don't embed large videos — they bloat the file.-- **Never regenerate `docId`** when editing; it is the document's identity.+- **Never regenerate `docId`** when editing an existing deck; it is the+ document's identity. (Fresh decks omit it — the app mints one.)- `template:true` → every open mints a fresh deck; `readonly:true` → thefile boots straight into the show with no editor.diff --git a/scripts/release.mjs b/scripts/release.mjsindex 35aa3152..34b2db10 100644--- a/scripts/release.mjs+++ b/scripts/release.mjs@@ -101,9 +101,16 @@ writeFileSync(join(site, 'agents.md'),readFileSync(join(root, 'docs/agents.md'), 'utf8').replace(/__APP_VERSION__/g, version),)-// The harness skill (Cowork / Claude Code), fetchable + droppable.+// The harness skill (canonical home: the Claude Code plugin at+// plugins/bento-slides). Published three ways: the raw SKILL.md (curl+// one-liner), a claude.ai-uploadable zip (must contain bento-slides/SKILL.md,+// folder-inside-zip), and a compat copy at the old bento-deck URL.+const skillSrc = join(root, 'plugins/bento-slides/skills/bento-slides/SKILL.md')+mkdirSync(join(site, 'skills/bento-slides'), { recursive: true })+cpSync(skillSrc, join(site, 'skills/bento-slides/SKILL.md'))mkdirSync(join(site, 'skills/bento-deck'), { recursive: true })-cpSync(join(root, 'skills/bento-deck/SKILL.md'), join(site, 'skills/bento-deck/SKILL.md'))+cpSync(skillSrc, join(site, 'skills/bento-deck/SKILL.md'))+execFileSync('zip', ['-q', '-X', '-o', 'bento-slides.zip', 'bento-slides/SKILL.md'], { cwd: join(site, 'skills') })// MIT license — travels to the public site repo so the published tree carries it.cpSync(join(root, 'LICENSE'), join(site, 'LICENSE'))diff --git a/site-src/help.html b/site-src/help.htmlindex fd1b02c7..a5688477 100644--- a/site-src/help.html+++ b/site-src/help.html@@ -248,12 +248,17 @@ footer a{color:var(--dim)}<p>Because the document is plain JSON inside the file, any AI can author or edit a deck. Drop the <code>.bento.html</code> into a chat or project (Cowork, Codex, Gemini, a ChatGPT project) and ask, or point a coding agent at it on disk.</p><p>The recipe an assistant should read first is <a href="/agents.md">bento.page/agents.md</a> — it maps your material to the right feature so you get a real deck, not a wall of text.</p>- <h3>The Claude Code skill</h3>- <p>Claude Code can install the <b>bento-deck</b> skill so it authors decks with the right features automatically. Add it with one command:</p>- <pre class="cmd">mkdir -p ~/.claude/skills/bento-deck-curl -fsSL https://bento.page/skills/bento-deck/SKILL.md \- -o ~/.claude/skills/bento-deck/SKILL.md</pre>- <p>No restart needed. From then on it triggers on its own whenever you ask for a deck, or you can run <code>/bento-deck</code> to invoke it directly. To scope it to a single project, use <code>.claude/skills/bento-deck/</code> instead; re-run the command any time to pull the latest version.</p>+ <h3>The <b>bento-slides</b> skill</h3>+ <p>Install the skill once and your assistant authors decks with the right features automatically — it even <b>downloads the latest Bento app by itself</b>, so you can go from an empty folder to a finished, opened deck in one ask. It triggers whenever you request slides, or run <code>/bento-slides</code> directly.</p>+ <p><b>Claude Code</b> — from the plugin store:</p>+ <pre class="cmd">/plugin marketplace add nyblnet/bento+/plugin install bento-slides@bento</pre>+ <p>…or as a plain personal skill (no restart needed; re-run to update; use <code>.claude/skills/…</code> to scope it to one project):</p>+ <pre class="cmd">mkdir -p ~/.claude/skills/bento-slides+curl -fsSL https://bento.page/skills/bento-slides/SKILL.md \+ -o ~/.claude/skills/bento-slides/SKILL.md</pre>+ <p><b>Claude.ai & Claude Desktop</b> — <a href="/skills/bento-slides.zip" download>download the skill (.zip)</a> and upload it under <i>Settings → Skills</i>.</p>+ <p><b>ChatGPT · Codex · Gemini</b> — no install: attach <a href="/agents.md">bento.page/agents.md</a> to a ChatGPT project, drop it beside your deck as <code>AGENTS.md</code> for Codex, or add it to a Gem.</p></section><section class="doc" id="keys">diff --git a/site-src/landing.html b/site-src/landing.htmlindex cc437900..7dfc9bc0 100644--- a/site-src/landing.html+++ b/site-src/landing.html@@ -779,10 +779,15 @@ window.bento.loadDoc(json) <span class="c">// write, undoable</span></div></div><div class="card" style="grid-column:1/-1"><div class="tick"></div>- <h3>Claude Code? Install the <code>bento-deck</code> skill</h3>- <p>One command adds the skill. After that Claude Code reaches for it on its own whenever you ask for a deck — or run <code>/bento-deck</code> — and it edits the <code>.bento.html</code> in place, mapping your material to charts, morphs and state slides instead of flat bullets.</p>- <div class="cmd">mkdir -p ~/.claude/skills/bento-deck && curl -fsSL https://bento.page/skills/bento-deck/SKILL.md -o ~/.claude/skills/bento-deck/SKILL.md</div>- <p style="margin-top:11px;font-size:13.5px;color:#5a6b82">No restart needed. Scope it to one project with <code>.claude/skills/bento-deck/</code> instead, and re-run the command any time to update.</p>+ <h3>Get the <code>bento-slides</code> skill</h3>+ <p>Install once and your assistant handles the rest — it even <b>downloads the latest Bento app by itself</b>, so "make me a deck about…" goes from a blank folder to a finished, opened <code>.bento.html</code> in one pass. It triggers automatically whenever you ask for slides (or run <code>/bento-slides</code>).</p>+ <p style="margin:14px 0 4px"><b>Claude Code</b> — from the plugin store:</p>+ <div class="cmd">/plugin marketplace add nyblnet/bento+/plugin install bento-slides@bento</div>+ <p style="margin:10px 0 4px;font-size:13.5px;color:#5a6b82">…or as a plain personal skill, one line:</p>+ <div class="cmd">mkdir -p ~/.claude/skills/bento-slides && curl -fsSL https://bento.page/skills/bento-slides/SKILL.md -o ~/.claude/skills/bento-slides/SKILL.md</div>+ <p style="margin:14px 0 0"><b>Claude.ai & Claude Desktop</b> — <a href="/skills/bento-slides.zip" download style="color:#C25B3F;font-weight:600">download the skill (.zip)</a>, then upload it under <i>Settings → Skills</i>.</p>+ <p style="margin:10px 0 0"><b>ChatGPT · Codex · Gemini</b> — no install needed: attach <a href="/agents.md" style="color:#C25B3F;font-weight:600">bento.page/agents.md</a> to a ChatGPT project, drop it beside your deck as <code>AGENTS.md</code> for Codex, or add it to a Gem.</p></div></div></div>