Visualize Your Thoughts Instantly with the Mindmap Generator Skill
Visualize Your Thoughts Instantly with the Mindmap Generator Skill
Ever found yourself drowning in meeting notes, scattered priorities, or complex decisions that would make more sense as a visual diagram? The mindmap-generator skill turns your AI agent into a visual thinking partner โ generating beautiful mindmap images from conversations and delivering them directly to your Telegram chat as PNG images.
Why Visual Mindmaps Matter
Text is great, but some information clicks better when you can see it. Decision trees, daily priorities, project breakdowns, meeting action items โ these all benefit from spatial organization. The mindmap-generator skill bridges the gap between AI conversation and visual output, rendering Mermaid diagrams to PNG and sending them inline to Telegram.
Perfect for:
- Morning briefings with 3+ priorities
- Decision analysis (pros/cons/risks mapped visually)
- Post-meeting action item summaries
- Weekly reviews showing completed, pending, and blocked items
- Goal decomposition and project kickoffs
Installation
clawdhub install mindmap-generatorThe skill requires a few dependencies:
# Node.js v18+ (for mermaid-cli)
npm install -g @mermaid-js/mermaid-cli
# curl for Telegram API calls (usually pre-installed)Set your Telegram bot token as an environment variable:
export TELEGRAM_BOT_TOKEN="your_bot_token_here"How It Works
The skill follows a simple pipeline:
- Extract structure from your input (voice note, text, calendar data)
- Generate Mermaid mindmap syntax with proper hierarchy
- Render to PNG via
mmdc(mermaid-cli) - Send to Telegram inline in your chat
Example: Daily Priorities
Ask your agent: "What's my day look like?"
The skill generates:
mindmap
root((Wednesday Feb 18))
(Meetings)
[10am - Team Standup]
[2pm - Client Review]
(Tasks)
))โ ๏ธ Proposal due today((
[โณ Review PR #342]
(Follow-ups)
[โ Rajesh - SOW overdue 3 days]
You receive a crisp PNG image directly in Telegram โ no downloads, no external links.
Example: Decision Analysis
Ask: "Should I take on the Acme consulting project?"
The agent maps out:
- Pros: Revenue, portfolio expansion, connections
- Cons: Time commitment, schedule conflicts, rate below usual
- Risks: Scope creep, payment terms, key contact leaving
- Decision factors: Questions to consider before committing
All visualized as an interconnected mindmap with appropriate shapes โ circles for the root, hexagons for decisions, explosions for urgent/blocked items.
Smart Node Shapes
The skill uses Mermaid's shape syntax intentionally:
| Shape | Usage |
|---|---|
((text)) | Root node (main topic) |
(text) | Categories |
[text] | Action items |
)text( | Ideas or open questions |
))text(( | Urgent or blocked items |
{{text}} | Decisions |
Status markers make scanning easy:
- โ Completed
- โณ In progress
- โ Blocked
- โ ๏ธ Risks/warnings
- ๐ก Ideas
Included Templates
The skill comes with six ready-to-use templates in assets/templates/:
- daily_priorities.txt โ Morning briefing structure
- decision_tree.txt โ Pros/cons/risks analysis
- weekly_review.txt โ What got done, what carried forward
- goal_decomposition.txt โ Breaking down big goals
- project_kickoff.txt โ New project structure
- meeting_action_map.txt โ Post-meeting summary
Graceful Fallback
If rendering fails (missing dependencies, syntax error), the skill falls back to a text-based tree using Unicode box-drawing:
๐ Today's Priorities
โโโ ๐ด Client Proposal (due 2pm)
โ โโโ Review pricing section
โ โโโ Add case studies
โโโ ๐ก Team Standup (11am)
โ โโโ Prep sprint update
โโโ ๐ Admin
โโโ Expense report
โโโ Update project tracker
You always get something useful, even when the image pipeline has issues.
Pro Tips
- Keep it shallow: 3 levels max for readability. If deeper, summarize at level 3.
- Limit branches: Max 7 from root. Group related items if more.
- Short labels: 5-6 words per node. Details go in sub-nodes.
- Trigger phrases: Say "map out", "visualize", or "break down visually" to activate.
- Weekly reviews: End each week with "Show me my week in a mindmap" โ great for reflection.
When to Use It
The skill activates automatically when you:
- Ask for a mindmap, mind map, or visual overview
- Share meeting notes and ask for structure
- Face a decision with multiple factors
- Have 3+ competing priorities
- Say "I'm overwhelmed" โ the agent proactively offers to map things out
Conclusion
The mindmap-generator skill transforms your AI agent from a text-only assistant into a visual thinking partner. Whether you're starting your day, analyzing decisions, or processing meeting chaos, getting your thoughts mapped visually โ delivered straight to Telegram โ makes everything clearer.
Install it with clawdhub install mindmap-generator and start mapping.
Links:
Comments (0)
No comments yet. Be the first to comment!