diagram-design
This guide covers when and how to create effective research diagrams using Excalidraw MCP tools. It provides a structured workflow from planning through grouping, along with specific recommendations for diagram types, layout patterns, color schemes, and element styling to ensure clarity and consistency.
Diagram Design teaches best practices for creating research diagrams using Excalidraw MCP tools.
AI-generated summary based on this skill's SKILL.md
Install
vstorm-co/pydantic-deepagents/diagram-design · repository language: Python
git clone https://github.com/vstorm-co/pydantic-deepagents
cp -r pydantic-deepagents/apps/deepresearch/skills/diagram-design ~/.claude/skills/diagram-designFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I create research diagrams with Excalidraw?
diagram-design teaches a structured workflow for creating research diagrams with Excalidraw MCP tools. Start by planning your diagram type based on your research goal, then use Excalidraw's tools to build your visual. The guide covers best practices for element arrangement, spacing, and grouping to ensure your diagram communicates clearly. Follow consistent styling conventions throughout to maintain professional appearance and readability across all your research visualizations.
When should I make a flowchart versus a timeline?
diagram-design explains that your choice depends on what you're communicating. Use a flowchart when you need to show process steps, decision points, or sequential logic—ideal for workflows and procedures. Choose a timeline when you're depicting events or milestones in chronological order. The guide helps you identify which diagram type best fits your research needs, ensuring you select the format that will most effectively convey your information to your audience.
What are the best practices for diagram design?
diagram-design covers comprehensive best practices including layout principles, element spacing, and alignment techniques. Key recommendations include organizing elements hierarchically, maintaining consistent spacing between components, and using clear visual grouping. The guide emphasizes planning before you start drawing, selecting appropriate diagram types for your content, and applying consistent styling to enhance clarity. These practices ensure your diagrams are both visually professional and easy to understand.
How should I arrange elements and handle spacing in Excalidraw?
diagram-design provides specific techniques for layout, spacing, and element arrangement in Excalidraw. Proper spacing prevents visual clutter and improves readability. The guide teaches alignment strategies to create organized, professional-looking diagrams. It covers grouping related elements together, maintaining consistent distances between components, and using visual hierarchy to guide viewers through your diagram logically. These arrangement techniques are essential for creating clear, effective research visualizations.
What colors and styling should I use in my diagrams?
diagram-design provides recommendations for consistent color and styling conventions to apply across your diagrams. The guide helps you select appropriate color palettes that enhance clarity without overwhelming viewers. It covers styling choices like line types—including when to use dashed versus solid arrows—and how to maintain visual consistency. These styling conventions ensure your diagrams look professional and help viewers quickly understand the relationships and flow within your research visualizations.
How can I optimize my Excalidraw workflow for efficient diagram creation?
diagram-design includes guidance on streamlining your Excalidraw workflow using MCP tools. The guide helps you work more efficiently by establishing a clear process from planning through final grouping and styling. By following the structured workflow and applying best practices consistently, you can create professional research diagrams faster. Mastering element organization, spacing techniques, and styling conventions reduces iteration time and helps you produce high-quality visualizations with less effort.
SKILL.md
rendered from the published skill — quoted content, verbatim
Diagram Design Guide for Research
When to Create Diagrams
Create a diagram when your research findings involve: - Comparing 3+ options — comparison table or matrix diagram - Process with 4+ steps — flowchart or sequence diagram - System with multiple components — architecture diagram - Chronological events — timeline - Hierarchical relationships — tree or mind map - Data flows — data flow diagram
Excalidraw Workflow
- Plan the diagram — decide type, elements, and layout before creating
- Create elements — use
create_elementorbatch_create_elements - Arrange — use
align_elementsanddistribute_elementsfor clean layout - Inspect — use
describe_sceneto verify the diagram looks right - Adjust — use
update_elementto fix positioning or text - Group — use
group_elementsto lock related items together
> Note: Do NOT export or share links — the user sees a live embedded canvas that auto-syncs.
Color Palette
Use consistent colors across diagrams:
| Purpose | Color | Hex
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
apps/deepresearch/skills/diagram-design/SKILL.md