cyberneticlibrary

Write markdown and mermaid diagrams

markdown-mermaid-writingskillsetup L127,559
K-Dense-AI/scientific-agent-skills
What it does

Write technical documentation with Markdown and Mermaid diagrams inline

Best for

Technical narratives where inline diagrams clarify concepts without external tool switching.

Inputs
  • · Topic or outline
  • · Diagram requirements
  • · Audience (developer/scientist/product)
Outputs
  • · Markdown file with embedded Mermaid syntax
  • · Rendered diagrams
Requires
  • · LLM/Claude API
  • · Bash/CLI
  • · Vault/Obsidian
  • · HTTP/REST API
  • · Git/GitHub
  • · Runtime (Python/Node)
Preconditions
  • · Markdown editor or renderer
  • · Mermaid support (GitHub, Notion, Docusaurus, etc.)
  • · Familiarity with Mermaid syntax
Failure modes
  • · Mermaid rendering fails silently (syntax error)
  • · Complex diagrams exceed token limits
  • · Dark mode rendering inverts colors
Trust signals
  • · Mermaid SVG export
  • · GitHub native rendering (no extra plugins)