Skip to content

armgit / bento

Public Imported from GitHub
0

Bento, the office suite that fits in a file

bento-slides skill: rename, plugin marketplace, zip install, self-bootstrap

nyblnet0fad2b4183b9
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
new file mode 100644
index 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.md
index 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 is
pre-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 OWNER
diff --git a/README.md b/README.md
index 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.md
index 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 can
author 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 document
lives 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.json
new file mode 100644
index 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.md
similarity index 65%
rename from skills/bento-deck/SKILL.md
rename to plugins/bento-slides/skills/bento-slides/SKILL.md
index 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-slides
description: >-
- 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 the
file (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 (keeps
the 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` → the
file boots straight into the show with no editor.
diff --git a/scripts/release.mjs b/scripts/release.mjs
index 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.html
index 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 &amp; 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.html
index 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 &amp;&amp; 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 &amp;&amp; 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 &amp; 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>