SkillAgentSearch skills...

obsidian-canvas-creator

Create Obsidian Canvas files from text content, supporting both MindMap and freeform layouts. Use this skill when users want to visualize content as an interactive canvas, create mind maps, or organize information spatially in Obsidian format.

Install / Use

npx skills add axtonliu/axton-obsidian-visual-skills --skill obsidian-canvas-creator

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

82/100

Category

Design

Supported Platforms

Universal

Tags

Our assessment of obsidian-canvas-creator

obsidian-canvas-creator scores 82/100 on our quality scale, 211th of 260 Design skills we index.

Its SKILL.md is 6.3 KB long, well organised into 18 sections and no code examples: a thorough specification that gives an agent plenty to work with.

With 3,621 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
13/20
Description
15/15
Adoption
15/20
Freshness
11/15

Maintenance, license and trust

  • The repository was last updated about 5 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
  • Our last check on 2026-11-07 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 98/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

obsidian-canvas-creator compared with similar skills

All 4 of these similar skills score higher than obsidian-canvas-creator; compare them before choosing.

SkillScoreStarsUpdatedFormat
obsidian-canvas-creator (this skill)by axtonliu823.6k5mo agoSKILL.md
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md
designby nextlevelbuilder100149.0k6d agoSKILL.md

Frequently asked questions

How do I install obsidian-canvas-creator?
Run npx skills add axtonliu/axton-obsidian-visual-skills --skill obsidian-canvas-creator. The install tabs above show the steps for each supported agent.
Which AI agents does obsidian-canvas-creator work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is obsidian-canvas-creator safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 98/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is obsidian-canvas-creator still maintained?
The repository was last updated about 5 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.

name: obsidian-canvas-creator description: Create Obsidian Canvas files from text content, supporting both MindMap and freeform layouts. Use this skill when users want to visualize content as an interactive canvas, create mind maps, or organize information spatially in Obsidian format.

Obsidian Canvas Creator

Transform text content into structured Obsidian Canvas files with support for MindMap and freeform layouts.

When to Use This Skill

  • User requests to create a canvas, mind map, or visual diagram from text
  • User wants to organize information spatially
  • User mentions "Obsidian Canvas" or similar visualization tools
  • Converting structured content (articles, notes, outlines) into visual format

Core Workflow

1. Analyze Content

Read and understand the input content:

  • Identify main topics and hierarchical relationships
  • Extract key points, facts, and supporting details
  • Note any existing structure (headings, lists, sections)

2. Determine Layout Type

Ask user to choose or infer from context:

MindMap Layout:

  • Radial structure from center
  • Parent-child relationships
  • Clear hierarchy
  • Good for: brainstorming, topic exploration, hierarchical content

Freeform Layout:

  • Custom positioning
  • Flexible relationships
  • Multiple connection types
  • Good for: complex networks, non-hierarchical content, custom arrangements

3. Plan Structure

For MindMap:

  • Identify central concept (root node)
  • Map primary branches (main topics)
  • Organize secondary branches (subtopics)
  • Position leaf nodes (details)

For Freeform:

  • Group related concepts
  • Identify connection patterns
  • Plan spatial zones
  • Consider visual flow

4. Generate Canvas

Create JSON following the Canvas specification:

Node Creation:

  • Assign unique 8-12 character hex IDs
  • Set appropriate dimensions based on content length
  • Apply consistent color schemes
  • Ensure no coordinate overlaps

Edge Creation:

  • Connect parent-child relationships
  • Use appropriate arrow styles
  • Add labels for complex relationships
  • Choose line styles (straight for hierarchy, curved for cross-references)

Grouping (Optional):

  • Create visual containers for related nodes
  • Use subtle background colors
  • Add descriptive labels

5. Apply Layout Algorithm

MindMap Layout Calculations:

Refer to references/layout-algorithms.md for detailed algorithms. Key principles:

  • Center root at (0, 0)
  • Distribute primary nodes radially
  • Space secondary nodes based on sibling count
  • Maintain minimum spacing: 320px horizontal, 200px vertical

Freeform Layout Principles:

  • Start with logical groupings
  • Position groups with clear separation
  • Connect across groups with curved edges
  • Balance visual weight across canvas

6. Validate and Output

Before outputting:

Validation Checklist:

  • All nodes have unique IDs
  • No coordinate overlaps (check distance > node dimensions + spacing)
  • All edges reference valid node IDs
  • Groups (if any) have labels
  • Colors use consistent format (hex or preset numbers)
  • JSON is properly escaped (Chinese quotes: 『』 for double, 「」 for single)

Output Format:

  • Complete, valid JSON Canvas file
  • No additional explanation text
  • Directly importable into Obsidian

Node Sizing Guidelines

Text Length-Based Sizing:

  • Short text (<30 chars): 220 × 100 px
  • Medium text (30-60 chars): 260 × 120 px
  • Long text (60-100 chars): 320 × 140 px
  • Very long text (>100 chars): 320 × 180 px

Color Schemes

Preset Colors (Recommended):

  • "1" - Red (warnings, important)
  • "2" - Orange (action items)
  • "3" - Yellow (questions, notes)
  • "4" - Green (positive, completed)
  • "5" - Cyan (information, details)
  • "6" - Purple (concepts, abstract)

Custom Hex Colors: Use for brand consistency or specific themes. Always use uppercase format: "#4A90E2"

Critical Rules

  1. Quote Handling:

    • Chinese double quotes → 『』
    • Chinese single quotes → 「」
    • English double quotes → \"
  2. ID Generation:

    • 8-12 character random hex strings
    • Must be unique across all nodes and edges
  3. Z-Index Order:

    • Output groups first (bottom layer)
    • Then subgroups
    • Finally text/link nodes (top layer)
  4. Spacing Requirements:

    • Minimum horizontal: 320px between node centers
    • Minimum vertical: 200px between node centers
    • Account for node dimensions when calculating
  5. JSON Structure:

    • Top level contains only nodes and edges arrays
    • No extra wrapping objects
    • No comments in output
  6. No Emoji:

    • Do not use any Emoji symbols in node text
    • Use color coding or text labels for visual distinction instead

Examples

Simple MindMap Request

User: "Create a mind map about solar system planets"

Process:

  1. Identify center: "Solar System"
  2. Primary branches: Inner Planets, Outer Planets, Dwarf Planets
  3. Secondary nodes: Individual planets with key facts
  4. Apply radial layout
  5. Generate JSON with proper spacing

Freeform Content Request

User: "Turn this article into a canvas" + [article text]

Process:

  1. Extract article structure (intro, body sections, conclusion)
  2. Identify key concepts and relationships
  3. Group related sections spatially
  4. Connect with labeled edges
  5. Apply freeform layout with clear zones

Reference Documents

  • Canvas Specification: references/canvas-spec.md - Complete JSON Canvas format specification
  • Layout Algorithms: references/layout-algorithms.md - Detailed positioning algorithms for both layout types

Load these references when:

  • Need specification details for edge cases
  • Implementing complex layout calculations
  • Troubleshooting validation errors

Tips for Quality Canvases

  1. Keep text concise: Each node should be scannable (<2 lines preferred)
  2. Use hierarchy: Group by importance and relationship
  3. Balance the canvas: Distribute nodes to avoid clustering
  4. Strategic colors: Use colors to encode meaning, not just decoration
  5. Meaningful connections: Only add edges that clarify relationships
  6. Test in Obsidian: Verify the output opens correctly

Common Pitfalls to Avoid

  • Overlapping nodes (always check distances)
  • Inconsistent quote escaping (breaks JSON parsing)
  • Missing group labels (causes sidebar navigation issues)
  • Too much text in nodes (use file nodes for long content)
  • Duplicate IDs (each must be unique)
  • Unconnected nodes (unless intentional islands)

Related Skills

View on GitHub
GitHub Stars3.6k
CategoryDesign
Updated4mo ago
Forks323

Trust signals

98/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info