slides-generator
Create Hummingbot-branded PDF slides from markdown with Mermaid diagram support. Use for presentations, decks, and technical documentation with professional diagrams.
- Installs
- 371
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/hummingbot/skills --skill slides-generator- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads slides-generator automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
slides-generator
Create Hummingbot-branded presentation slides in PDF format from markdown content. Features two-column layouts and Mermaid diagram rendering for technical architecture and flowcharts.
Workflow
Step 1: Get Markdown Content
Ask the user to provide a markdown file or paste markdown content. The content should follow this format:
# Presentation Title
## 1. First Slide Title
Content for the first slide. Can include:
- Bullet points
- **Bold text** and *italic text*
- Code blocks
## 2. Second Slide Title
More content here.
## 3. Third Slide Title
And so on...
Format Rules:
# Title= Presentation title (optional, becomes title slide)## N. Slide Title= New slide (N is slide number)- Content under each
##heading becomes slide content - Supports markdown formatting: lists, bold, italic, code blocks, links
Step 2: Parse and Confirm
Before generating the PDF, parse the markdown and show the user a summary:
📊 Slide Outline:
1. First Slide Title
2. Second Slide Title
3. Third Slide Title
...
Total: X slides
Please confirm to proceed with PDF generation, or provide edits.
Wait for user confirmation before proceeding.
Step 3: Generate PDF
Run the generation script:
bash <(curl -s https://raw.githubusercontent.com/hummingbot/skills/main/skills/slides-generator/scripts/generate_slides.sh) \
--input "<markdown_file_or_content>" \
--output "<output_pdf_path>"
Or if the user provided inline content, save it to a temp file first:
# Save content to temp file
cat > /tmp/slides_content.md << 'SLIDES_EOF'
<markdown_content_here>
SLIDES_EOF
# Generate PDF
bash <(curl -s https://raw.githubusercontent.com/hummingbot/skills/main/skills/slides-generator/scripts/generate_slides.sh) \
--input /tmp/slides_content.md \
--output ~/slides_output.pdf
Step 4: Deliver Result
After generation, tell the user:
- The PDF file location
- How many slides were generated
- Offer to open/view the PDF if desired
Editing Existing Slides
If the user wants to edit slides from a previously generated PDF:
- Read the original markdown (if available) or view the PDF to understand current content
- Ask the user what changes they want:
- Edit specific slide content
- Add new slides
- Remove slides
- Reorder slides
- Apply changes to the markdown
- Regenerate the PDF
Use the --edit flag to update specific slides without regenerating all:
bash <(curl -s https://raw.githubusercontent.com/hummingbot/skills/main/skills/slides-generator/scripts/generate_slides.sh) \
--input "<updated_markdown>" \
--output "<same_pdf_path>" \
--edit
Diagrams
Users can describe diagrams in natural language using mermaid: syntax. You must translate these descriptions to Mermaid code before generating the PDF.
User Input Format
Users write descriptions like:
mermaid: A flowchart showing User Interface connecting to Condor and MCP Agents,
both connecting to Hummingbot API (highlighted), then to Client, then to Gateway
Translation to Mermaid
Convert the description to proper Mermaid syntax:
\`\`\`mermaid
flowchart TB
A[User Interface] --> B[Condor]
A --> C[MCP Agents]
B --> D[Hummingbot API]
C --> D
D --> E[Hummingbot Client]
E --> F[Gateway]
style D fill:#00D084,color:#fff
\`\`\`
Diagram Types
flowchart TD- Top-down flowchartflowchart LR- Left-right flowchartsequenceDiagram- API and interaction flowsclassDiagram- Object-oriented designerDiagram- Database schemas
Highlighting
Use style NodeName fill:#00D084,color:#fff for Hummingbot green highlighting.
Requirements
Mermaid diagrams require the Mermaid CLI:
npm install -g @mermaid-js/mermaid-cli
Code Blocks
Use regular \``` code blocks for ASCII art, code snippets, or preformatted text:
\`\`\`
Price
^
| [BUY] --- Level 3
| [BUY] --- Level 2
| [BUY] --- Level 1
+-------------------> Time
\`\`\`
Code blocks render with monospace font on a gray background.
Two-Column Layout
When a slide has both bullet points AND a diagram, it automatically renders in two columns:
- Left column: Text content
- Right column: Diagram
## 4. How It Works
Key features:
- Automated order placement
- Dynamic position management
- Risk-controlled execution
- Real-time monitoring
mermaid: flowchart showing Market Data to Strategy to Orders
After translation:
## 4. How It Works
Key features:
- Automated order placement
- Dynamic position management
- Risk-controlled execution
- Real-time monitoring
\`\`\`mermaid
flowchart TD
A[Market Data] --> B[Strategy]
B --> C[Orders]
style B fill:#00D084,color:#fff
\`\`\`
Example Markdown
# Q4 Product Update
## 1. Overview
Today we'll cover:
- Product milestones
- Key metrics
- Roadmap preview
## 2. Architecture
Our system components:
- User-facing interfaces
- Core API layer
- Exchange connectivity
mermaid: flowchart showing UI to API (highlighted) to Gateway
## 3. Key Metrics
| Metric | Q3 | Q4 | Change |
|--------|----|----|--------|
| Users | 10K | 15K | +50% |
| Revenue | $100K | $150K | +50% |
## 4. Q1 Roadmap
1. Mobile app launch
2. Enterprise tier
3. International expansion
## 5. Questions?
Thank you!
Contact: team@example.com
After translating mermaid: descriptions:
## 2. Architecture
Our system components:
- User-facing interfaces
- Core API layer
- Exchange connectivity
\`\`\`mermaid
flowchart TD
A[UI] --> B[API]
B --> C[Gateway]
style B fill:#00D084,color:#fff
\`\`\`
Dependencies
The script will check for and install if needed:
- Python 3
fpdf2Python package (for PDF generation)
Troubleshooting
| Issue | Solution |
|---|---|
| "Python not found" | Install Python 3: brew install python3 (macOS) or apt install python3 (Linux) |
| "fpdf2 not installed" | Run: pip3 install fpdf2 |
| "Permission denied" | Check write permissions for output directory |
| "Empty PDF" | Verify markdown format follows the ## N. Title pattern |
Scripts
| Script | Purpose |
|---|---|
generate_slides.sh | Main PDF generation script |
FAQ
What does the slides-generator skill do?
Create Hummingbot-branded PDF slides from markdown with Mermaid diagram support. Use for presentations, decks, and technical documentation with professional diagrams.
How do I install slides-generator?
Run npx skills add https://github.com/hummingbot/skills --skill slides-generator in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/slides-generator/ (personal) or .claude/skills/slides-generator/ (project).
Which AI agents can use slides-generator?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is slides-generator safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains slides-generator?
It is published by hummingbot in hummingbot/skills. It has 371 recorded installs.
More from hummingbot/skills
find-arbitrage-opps
hummingbot/skills
Find arbitrage opportunities across exchanges by comparing prices for fungible token pairs like BTC/WBTC and USDT/USDC.
hummingbot-deploy
hummingbot/skills
Deploy Hummingbot trading infrastructure including API server, MCP server, and Condor Telegram bot. Use this skill when the user wants to install, deploy, set up, or configure Hummingbot.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown：查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件，或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档，也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.