diagram-to-image_skill

Overview

This skill converts Mermaid diagrams and Markdown tables into PNG or SVG images for platforms that don't support rich formatting, like X/Twitter. It produces descriptive filenames and selects an appropriate output location based on project or conversation context. The skill reports the final path, why it was chosen, and basic file info after conversion.

How this skill works

It inspects the diagram or table content to generate a concise, kebab-case filename and then determines the best output directory by checking user-specified paths, common image/asset folders, document context, and conversation cues. For Mermaid it writes a temporary .mmd file and runs mermaid-cli (mmdc) to export PNG or SVG; for Markdown tables it renders a temporary file and uses a Python script to produce a PNG. It handles directory creation, name collisions, and missing-dependency guidance.

When to use it

• You have a Mermaid diagram that must be shared as an image (PNG/SVG).
• You need a Markdown table exported as an image for social platforms.
• Creating visuals for X/Twitter or other services without rich formatting.
• User explicitly asks: "convert to image", "export as PNG", or "make this an image".

Best practices

• Provide a short description or topic when pasting a diagram to get a better filename.
• Specify an output path if you want the image placed in a particular folder.
• Prefer PNG for raster needs (social platforms) and SVG for scalable graphics.
• Confirm creation of new directories before the skill writes files.
• Keep diagrams concise so exported images render cleanly at common sizes.

Example use cases

• Convert an authentication flowchart to ./images/login-flow.png when an images/ folder exists.
• Export an AI-agent flow for an article as ai-agent-flow.png in the document folder.
• Render a comparison Markdown table as model-comparison.png for a social post.
• Save a user-specified path like ~/Desktop/my-chart.png when explicitly provided.
• Generate an entity-relationship.svg from an erDiagram for documentation.