Agent skill

Obsidian Canvas Creator

by axtonliu in axtonliu/axton-obsidian-visual-skills

Create Obsidian Canvas files from text content, supporting both MindMap and freeform layouts.

MITAuto-check passed

Install Obsidian Canvas Creator

skills CLI
$ npx skills add axtonliu/axton-obsidian-visual-skills --skill obsidian-canvas-creator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install axtonliu/axton-obsidian-visual-skills obsidian-canvas-creator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/axtonliu/axton-obsidian-visual-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/obsidian-canvas-creator .claude/skills/obsidian-canvas-creator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
obsidian-canvas-creator
GitHub stars
3.6k
Token cost
~1.6k tokens
SKILL.md length
788 words
Files
5 (incl. references, assets)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Create Obsidian Canvas files from text content, supporting both MindMap and freeform layouts.

  • Works in 6 steps: Analyze Content → Determine Layout Type → Plan Structure → …
  • Users want to visualize content as an interactive canvas
  • SKILL.md covers When to Use This Skill, Core Workflow, Node Sizing Guidelines and Color Schemes, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Obsidian Canvas Creator is an agent skill from axtonliu/axton-obsidian-visual-skills. 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.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files and assets (for example `references/canvas-spec.md` and `references/layout-algorithms.md`).

It works with Obsidian. The repository describes itself as: Visual Skills Pack for Obsidian: generate Canvas, Excalidraw, and Mermaid diagrams from text with Claude Code. The licence is MIT.

When your agent uses it

  • Users want to visualize content as an interactive canvas
  • Create mind maps
  • Organize information spatially in Obsidian format

Example prompts

  • “/obsidian-canvas-creator”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Analyze Content
  2. Determine Layout Type
  3. Plan Structure
  4. Generate Canvas
  5. Apply Layout Algorithm
  6. Validate and Output

What it can do on your machine

Read from SKILL.md and the folder at commit 1265976. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Obsidian Canvas Creator loads about 1.6k tokens when it runs, and up to ~8k if it reads all its reference files. Until then it costs about 67 tokens; SKILL.md has 788 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from axtonliu/axton-obsidian-visual-skills at commit 1265976, republished under its MIT licence (© axtonliu). 788 words, ~1,623 tokens.

Download SKILL.mdSave it as .claude/skills/obsidian-canvas-creator/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
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"

Show full SKILL.md (340 more words)Show less

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)

© axtonliu, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references, assets) in obsidian-canvas-creator of axtonliu/axton-obsidian-visual-skills.

  • SKILL.md
  • assets/template-freeform-grouped.canvas
  • assets/template-mindmap-simple.canvas
  • references/canvas-spec.md
  • references/layout-algorithms.md

Open the folder on GitHubat commit 1265976

Compare with similar skills

Obsidian Canvas Creator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Obsidian Canvas Creator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Obsidian Canvas Creator this skillaxtonliu/axton-obsidian-visual-skills3.6k—~1.6kAutomated safety check: PassMIT
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0
Knap Markdown Templateskepano/obsidian-skills49k2 repos~986Automated safety check: PassMIT
JSON Canvasheyitsnoah/claudesidian2.6k18 repos~3.5kAutomated safety check: PassMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
Obsidian CLIAtmosphere/atmosphere3.8k13 repos~795Automated safety check: PassApache-2.0

Similar skills

  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Knap Markdown Templates

    kepano/obsidian-skills

    Renders Markdown notes from Knap templates and JSON data on the command line, including notes built from Defuddle web page output.

    49k GitHub starsUsed in 2 repos~986 tokens
    Documents & OfficeAuto-check passed
  • JSON Canvas

    heyitsnoah/claudesidian

    Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections.

    2.6k GitHub starsUsed in 18 repos~3.5k tokens
    DevelopmentAuto-check passed
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • Obsidian CLI

    Atmosphere/atmosphere

    Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more.

    3.8k GitHub starsUsed in 13 repos~795 tokens
    Knowledge ManagementAuto-check passed
  • Bounded Autoresearch

    AgriciDaniel/claude-obsidian

    Runs a bounded, source-grounded research loop that drafts a cited dossier and can propose a separately reviewed merge into an Obsidian vault.

    15k GitHub stars~1.6k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed

Works with

Questions about Obsidian Canvas Creator

What does Obsidian Canvas Creator do?

Create Obsidian Canvas files from text content, supporting both MindMap and freeform layouts. Obsidian Canvas Creator is an agent skill from axtonliu/axton-obsidian-visual-skills. Create Obsidian Canvas files from text content, supporting both MindMap and freeform layouts.

When should I use Obsidian Canvas Creator?

Obsidian Canvas Creator fits situations like: users want to visualize content as an interactive canvas; create mind maps; organize information spatially in Obsidian format.

How do I install Obsidian Canvas Creator in Claude Code?

Run `npx skills add axtonliu/axton-obsidian-visual-skills --skill obsidian-canvas-creator -a claude-code`. Or copy the skill folder (obsidian-canvas-creator in axtonliu/axton-obsidian-visual-skills) into .claude/skills/obsidian-canvas-creator in your project. Claude Code loads it when a task matches its description.

How do I install Obsidian Canvas Creator in Codex?

Run `npx skills add axtonliu/axton-obsidian-visual-skills --skill obsidian-canvas-creator -a codex`. Or copy the skill folder (obsidian-canvas-creator in axtonliu/axton-obsidian-visual-skills) into .agents/skills/obsidian-canvas-creator in your project. Codex loads it when a task matches its description.

Can I use Obsidian Canvas Creator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add axtonliu/axton-obsidian-visual-skills --skill obsidian-canvas-creator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/obsidian-canvas-creator, .gemini/skills/obsidian-canvas-creator, .github/skills/obsidian-canvas-creator and .opencode/skills/obsidian-canvas-creator in your project.

What does Obsidian Canvas Creator need to run?

SKILL.md names no scripts, command-line tools or credentials: Obsidian Canvas Creator is instructions for the agent only.

Does Obsidian Canvas Creator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Obsidian Canvas Creator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Obsidian Canvas Creator use?

Obsidian Canvas Creator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Obsidian Canvas Creator use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 6.4k tokens, read only when the agent opens those files.

What are the alternatives to Obsidian Canvas Creator?

Skills that share tags, products or a category with Obsidian Canvas Creator: Obsidian Bases (Atmosphere/atmosphere, 3.8k stars), Knap Markdown Templates (kepano/obsidian-skills, 49k stars), JSON Canvas (heyitsnoah/claudesidian, 2.6k stars) and Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Obsidian Canvas Creator?

axtonliu (a GitHub user) maintains it in axtonliu/axton-obsidian-visual-skills, which has 3,643 GitHub stars. The repository was last updated on June 26, 2026.

Source: axtonliu/axton-obsidian-visual-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.