beatdeck plugin
A talk framework with GSAP timelines, a presenter window and an offline build, plus a Claude Code skill that builds the talk
- 241 ★ on the repository
- Last commit
Extended access
Why this level
- The project runs a local dev server and build, and the skill edits talk files
- The skill reads your source material, PPTX included, and writes scenes into the project
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/beatdeckDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The project runs a local dev server and build, and the skill edits talk files
- The skill reads your source material, PPTX included, and writes scenes into the project
This is third-party code. Review the repository files before installing.
What it does
beatdeck builds a talk from beats: one click is one beat on a fixed 1920×1080 React stage. The state is the pair `{ scene, beat }`, and an address such as `#3.4` always renders the same frame whether you got there going forward, back, jumping or refreshing. Automatic motion runs where you authored it, for example a GSAP timeline (a boot log, a counter, a cascade), and everything else waits for the speaker. It ships with a presenter window (the P key) with current and next beat, notes and a timer, a scene overview (O), a debug panel and blackout (B). The build works offline: fonts, images and QR codes are bundled, and `npm run build` fails if anything references the network. The `building-a-beatdeck` skill runs the whole workflow: collects the source (there is a PPTX extractor), writes a content audit so nothing is lost or invented, designs the beat map, applies a theme, builds the scenes and runs `npm run verify`, then looks at every frame. It installs as a Claude Code plugin or by copying the folder into a skills directory, and a project starts with `npx degit borjaperfra/beatdeck my-talk`.
Who it is for. Conference and meetup speakers who want a controlled live delivery with animation and a presenter mode and are ready to build it with an agent.
Good fit when
- A talk about a system should show a growing diagram, a counter and a crash cutting to black
- A finished PPTX deck has to move into scenes and beats with nothing lost
- You present with a clicker and need click-by-click delivery without jumps
- The room has no Wi-Fi: every resource must live inside the build
- You want to reopen the exact same frame by address after a refresh
Not a fit when
- You need ordinary slides with an editor and templates: here the talk is built in React code
- The team has no Node.js: the tool needs Node and npm
- You need collaborative cloud editing: the project lives in a local repository
Example request
Turn talk.pptx into a beatdeck and add a scene where the architecture grows to three serversLimitations
It needs Node.js and npm, and a talk is built as a React project on Vite. The code and docs are MIT, while the Kernel Panic showcase contains third-party material under its own terms, with a credits list in the repository. The `init` command removes the showcase, the plugin files and beatdeck's own CI from your copy. `upgrade` handles updates and leaves `deck/` and `index.html` alone, backing up edited engine files to `.beatdeck-backup/`. The last commit is from October 2026.
How to disable. For the plugin run /plugin uninstall beatdeck in Claude Code. A talk project is deleted like any folder, and the building-a-beatdeck skill goes with it or from ~/.claude/skills/.
FAQ
How does a beat differ from a slide?
Slides are flipped as pages, while a beat is a step inside a scene: one click runs one beat, such as a diagram growing or a counter running. The state is always a scene and beat pair, so a frame reproduces by address.
Which keys control it?
Next beat: right and down arrows, PageDown, click, space. Previous: left, up, PageUp. Also 1–9 for a scene, F for fullscreen, O for the overview, P for the presenter window and B for blackout.
What does the building-a-beatdeck skill do?
Collects the source, writes a content audit, designs the beat map, applies a theme, builds the scenes and runs npm run verify, then looks at every frame.
Does it work without the internet?
Yes, fonts, images and QR codes are bundled, and npm run build fails if anything references the network.
How do I update the engine?
With upgrade: it replaces the engine, the skill, the scripts and the base themes but leaves the deck/ folder alone. Engine files you edited are backed up to .beatdeck-backup/.
Discussion
No questions or reviews yet.
Related
PluginsAn agent skill that redesigns a repository README and builds a hero, diagrams and SVG assets from the project itself
A technical writing assistant for Antigravity: a Markdown side panel, four MCP checks and five skills from notes to publication.
Skill suite for Codex that carries an idea to a finished proposal deck: strategy, manuscript, visuals, review and delivery.
A DeepSeek Harness plugin with five skills: web slide decks, social cards, article layout, text de-slopping and a voice profile
A skill that turns text or a link into a magazine-style info card and shoots a PNG with Playwright, splitting tall ones into parts
Agent skill that builds social card carousels and paired covers from an article, screenshots, notes or video in two visual systems
README in short
The description starts with the motto talks as beats, not slides, and a quick start. It then explains the model (one click, determinism, automatic motion, one stage, offline, operator tools), upgrades, keys and the skill with its install.