How do I install the Tap skill?

Run npx skillmds@latest add diegosouzapw/tap in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Tap skill do?

Create markdown presentations with live code execution It is listed under Docs & Writing on SkillMD.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tap?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tap by diegosouzapw — Agent Skill

Name: Tap
Rating: 4.5 (4 reviews)
Author: diegosouzapw

File contents

Tap - Presentations for Developers

Tap is a CLI tool that transforms markdown files into beautiful, interactive presentations with live code execution.

When to Use This Skill

Use Tap when building:

Technical presentations with code demos
Database query demonstrations with live results
CLI tool tutorials and walkthroughs
Workshop materials with executable examples
Conference talks with code walkthroughs

Key Capabilities

Markdown-first - Write slides in familiar markdown syntax
Live code execution - Run SQL, shell commands, Python, Node.js, and more directly in slides
Beautiful themes - 5 built-in themes (paper, noir, aurora, phosphor, poster)
11 layouts - From title slides to code-focused layouts
Presenter mode - Speaker notes, timer, and slide preview
Export options - Build static sites or export to PDF

Quick Start

# Create a new presentation
tap new my-talk

# Start the dev server
tap dev my-talk.md

# Build for production
tap build my-talk.md

# Export to PDF
tap pdf my-talk.md

Basic Slide Structure

---
title: My Presentation
theme: paper
---

# First Slide

Content here.

---

# Second Slide

More content.

Rule Index

This skill includes detailed rules for:

getting-started - Installation and first presentation
writing-slides - Markdown syntax, slide separators, speaker notes
frontmatter - Global config options (title, theme, transitions)
layouts - All 11 layouts with slot markers
slide-directives - Per-slide HTML comment syntax
animations - Transitions and fragment reveals
code-blocks - Syntax highlighting, line highlighting, diffs
live-code - Drivers for SQLite, MySQL, PostgreSQL, shell
themes - 5 built-in themes and customization
cli - tap new/dev/build/serve/pdf commands
best-practices - Presentation design tips
mermaid - Mermaid diagram support (flowcharts, sequence, ER, etc.)
ai-images - Gemini AI image generation from prompts

Important Patterns

Slide Separators

Use --- on its own line to separate slides:

# Slide 1

---

# Slide 2

Slide Directives

Use HTML comments with YAML for per-slide settings:

<!--
layout: two-column
transition: fade
-->

Live Code Execution

Add {driver: 'drivername'} to code blocks:

```sql {driver: sqlite, connection: demo}
SELECT * FROM users;
```

Column Separator

For multi-column layouts, use ||| to separate content:

Left content

|||

Right content

---name: tapdescription: Create markdown presentations with live code execution---# Tap - Presentations for DevelopersTap is a CLI tool that transforms markdown files into beautiful, interactive presentations with live code execution.## When to Use This SkillUse Tap when building:- Technical presentations with code demos- Database query demonstrations with live results- CLI tool tutorials and walkthroughs- Workshop materials with executable examples- Conference talks with code walkthroughs## Key Capabilities1. **Markdown-first** - Write slides in familiar markdown syntax2. **Live code execution** - Run SQL, shell commands, Python, Node.js, and more directly in slides3. **Beautiful themes** - 5 built-in themes (paper, noir, aurora, phosphor, poster)4. **11 layouts** - From title slides to code-focused layouts5. **Presenter mode** - Speaker notes, timer, and slide preview6. **Export options** - Build static sites or export to PDF## Quick Start```bash# Create a new presentationtap new my-talk# Start the dev servertap dev my-talk.md# Build for productiontap build my-talk.md# Export to PDFtap pdf my-talk.md```## Basic Slide Structure```markdown---title: My Presentationtheme: paper---# First SlideContent here.---# Second SlideMore content.```## Rule IndexThis skill includes detailed rules for:1. **getting-started** - Installation and first presentation2. **writing-slides** - Markdown syntax, slide separators, speaker notes3. **frontmatter** - Global config options (title, theme, transitions)4. **layouts** - All 11 layouts with slot markers5. **slide-directives** - Per-slide HTML comment syntax6. **animations** - Transitions and fragment reveals7. **code-blocks** - Syntax highlighting, line highlighting, diffs8. **live-code** - Drivers for SQLite, MySQL, PostgreSQL, shell9. **themes** - 5 built-in themes and customization10. **cli** - tap new/dev/build/serve/pdf commands11. **best-practices** - Presentation design tips12. **mermaid** - Mermaid diagram support (flowcharts, sequence, ER, etc.)13. **ai-images** - Gemini AI image generation from prompts## Important Patterns### Slide SeparatorsUse `---` on its own line to separate slides:```markdown# Slide 1---# Slide 2```### Slide DirectivesUse HTML comments with YAML for per-slide settings:```markdown```### Live Code ExecutionAdd `{driver: 'drivername'}` to code blocks:````markdown```sql {driver: sqlite, connection: demo}SELECT * FROM users;```````### Column SeparatorFor multi-column layouts, use `|||` to separate content:```markdownLeft content|||Right content```

Frequently asked questions

Tap