Skills
Skills documentation for Honeydeck.
Skills
Honeydeck ships optional agent skills that help AI coding agents work with presentations more reliably. They are plain skill files bundled with the @honeydeck/honeydeck package, so you can install them into a deck project or into your global agent setup.
Install skills
New projects can open the skills installer during init:
npx @honeydeck/honeydeck init --name my-talk --install-skillExisting projects can run:
honeydeck skillBoth commands open the same skills CLI flow, where you choose which Honeydeck skills to install, whether to install them for the project or globally, and which agents should receive them.
You can also install from the Honeydeck repository:
npx skills add <honeydeck-repo-url> --copy
npx skills add <honeydeck-repo-url> --copy --skill honeydeck
npx skills add <honeydeck-repo-url> --copy --skill presentation-writing
npx skills add <honeydeck-repo-url> --copy --skill slidev-migrationBundled skills
| Skill | Use it for |
|---|---|
honeydeck | Honeydeck-specific guidance for MDX decks, layouts, CSS imports, presenter notes, reveals, code steps, Magic Code, PDF export, public docs, and package specs. |
presentation-writing | Framework-agnostic help with audience, storyline, slide headlines, speaker notes, timing, and review heuristics. |
slidev-migration | Migrating Slidev decks to Honeydeck, including rewriting Slidev md magic-move blocks to Honeydeck md magic-code, while preserving source files until you approve cleanup. |
The honeydeck and presentation-writing skills work well together: one keeps the agent inside Honeydeck conventions, while the other improves the story and delivery. Add slidev-migration when you are converting an existing Slidev project.
How agents use them
Skills do not change Honeydeck runtime behavior. They give your agent a focused local instruction file before it edits your deck.
For example, an agent with the honeydeck skill should prefer:
deck.mdxas the entry file- exact
---slide separators - slide frontmatter for layouts
- explicit imports from
@honeydeck/honeydeck <Notes>for speaker notes<Reveal>,<RevealGroup>, code metadata, and Magic Code for stepshoneydeck pdffor PDF export
The skills also point agents back to the packaged docs and specs, so generated deck changes can stay aligned with the installed Honeydeck version.
Updating skills
Skills are copied into the target scope when you install them. Re-run the installer after upgrading Honeydeck if you want the latest bundled instructions:
npm update @honeydeck/honeydeck
honeydeck skillComing from Slidev? See the Slidev migration guide for the migration-specific workflow.