draw-diagram

Generate Mermaid architecture diagrams from workspace metadata or code.

16|2|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/pipecrew-ai/pipecrew --skill draw-diagram-pipecrew-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: draw-diagram
Source: https://github.com/pipecrew-ai/pipecrew/tree/main/skills/draw-diagram
Command: npx skills add https://github.com/pipecrew-ai/pipecrew --skill draw-diagram-pipecrew-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps address the issue of architecture diagrams becoming outdated due to changes in a workspace, and allows for the generation of focused diagrams for specific concerns without re-running the entire discovery process.

Core Features & Use Cases

  • Regenerate Diagrams: Automatically refreshes canonical diagrams (architecture-overview.mmd + architecture.mmd) for an onboarded workspace.
  • Generate Focused Diagrams: Produces topic-specific diagrams like auth flow, event flow, or deployment topology without modifying the canonical files.
  • Code-Scan Mode: Generates diagrams from code without the need for platform.md, ideal for new or archived projects.

Quick Start

To refresh the canonical diagrams for the current workspace, simply run: /draw-diagram

Frequently Asked Questions about draw-diagram

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate architecture diagrams from code without running a full workspace discovery process?

You can generate architecture diagrams from code directly using a code-scan mode. This approach analyzes your source files to produce Mermaid syntax diagrams without requiring pre-existing platform.md metadata files.

How do I create a focused Mermaid diagram for a specific topic like an authentication flow?

You can create focused Mermaid diagrams for specific concerns such as auth flow or event flow. This generates topic-specific visualizations on demand without modifying your canonical architecture files.

What is the best way to refresh outdated workspace architecture diagrams after code changes?

The best way to refresh outdated workspace architecture diagrams is to regenerate the canonical files. This automatically updates architecture-overview.mmd and architecture.mmd based on your current codebase.

Can I generate Mermaid architecture diagrams for archived projects that lack platform metadata?

Yes, you can generate Mermaid architecture diagrams for archived projects using the code-scan mode. This mode derives diagrams directly from the source code, bypassing the need for platform.md metadata.

Do I need an existing platform.md file to generate workspace architecture diagrams?

No, you do not need an existing platform.md file to generate workspace architecture diagrams. The tool supports direct code analysis to create diagrams, although it can also utilize platform.md metadata if available.

What are the limitations of generating focused architecture diagrams without modifying canonical files?

Generating focused architecture diagrams operates independently of canonical files, meaning these topic-specific diagrams will not reflect or contribute to the canonical architecture-overview.mmd maintenance workflow.