Getting started
bento-deck-studio is a GitHub Copilot plugin. It adds one coordinating agent and six Agent Skills that turn a PowerPoint template or deck into editable bento slides, then share them as a launch page or a full companion site.
Requirements
- GitHub Copilot CLI or the GitHub Copilot app with plugin support.
- Node.js 20 or later (24 recommended). The scripts use Node.js built-ins only, so there is nothing to
npm install. - Network access the first time you build a deck, to fetch and verify the signed Bento Slides shell. Later builds can reuse the verified cache offline.
- A
.pptxor.potxfile whose theme you want to reuse.
Install the plugin
Register the repository as a plugin marketplace, then install the plugin from it:
copilot plugin marketplace add arilivigni/bento-deck-studio
copilot plugin install bento-deck-studio@bento-deck-studio
Check that it is installed:
copilot plugin list
You can also install straight from the repository without registering a marketplace:
copilot plugin install arilivigni/bento-deck-studio
In the GitHub Copilot app, find the marketplace and plugin under Customize, then choose the bento-deck-studio agent or invoke its skills directly.
Pin a release
Every release is a Git tag such as v1.0.0. To install a specific release instead of the latest commit on main, add the marketplace at that tag:
copilot plugin marketplace add arilivigni/bento-deck-studio#v1.0.0
copilot plugin install bento-deck-studio@bento-deck-studio
If you already added the marketplace, run copilot plugin marketplace remove bento-deck-studio first.
Each GitHub release also attaches a plugin zip, a SHA256SUMS file, and a build provenance attestation for offline or air-gapped installs. See Releases.
Update or remove
copilot plugin update bento-deck-studio@bento-deck-studio
copilot plugin uninstall bento-deck-studio@bento-deck-studio
Build your first deck
Ask the bento-deck-studio agent for what you want. For example:
Use the bento-deck-studio agent to turn ~/Downloads/brand-template.potx
and notes.md into bento slides. Use the dark variant and create the
default launch site in ./talk.
The agent works in phases and loads a skill for each one:
- Extract the palette, fonts, slide size, masters, and layouts to a reviewable
theme.json(/theme-extract). - Author your story as a Markdown outline, one idea per slide (
/deck-author). - Build an editable
.bento.htmlon the source's own layouts (/deck-build). - Choose a favicon from your image or a theme-colored monogram (
/favicon). - Share a launch page, a full companion site, or the deck alone (
/site-build). - Review every slide and the site navigation (
/deck-qa).
It asks before replacing existing output, using a proprietary font, or creating the optional full site.
Run the scripts yourself
The same workflow runs without the agent:
node scripts/theme-extract.mjs brand-template.potx --out theme.json
node scripts/deck-build.mjs --theme theme.json --content outline.md --out dist/deck.bento.html
node scripts/site-build.mjs --deck dist/deck.bento.html --out dist/site
node scripts/validate.mjs dist/site --site
Open dist/site/index.html in a browser, then choose Launch the slides. See the script reference for every option.
Next steps
- Learn how the plugin matches your template.
- Choose between a launch page and a full site.
- Review the safety and licensing notes before you publish.