json-canvas

Create and edit Obsidian JSON Canvas files with validated nodes and edges.

Updated May 10, 2026
One-click install
npx skills add https://github.com/Mateus2411/Hermes-PersonalBot --skill json-canvas-mateus2411
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: json-canvas
Source: https://github.com/Mateus2411/Hermes-PersonalBot/tree/main/skills/obsidian-skills/skills/json-canvas
Command: npx skills add https://github.com/Mateus2411/Hermes-PersonalBot --skill json-canvas-mateus2411

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you create and update Obsidian JSON Canvas files without breaking structure, IDs, or edge connections.

Core Features & Use Cases

  • Create .canvas files: Generate a valid JSON Canvas structure with nodes and edges that follow the Spec 1.0 layout conventions.
  • Edit existing canvases safely: Add, modify, and validate nodes/edges while preventing ID collisions and dangling references.
  • Design clear visual maps: Support mind maps, flowcharts, and project boards by using consistent node sizing, spacing, and non-overlapping edge planning.

Quick Start

Generate a valid .canvas JSON for a mind map about "Project Launch" with 1 central text node and 4 connected child text nodes.

Frequently Asked Questions about json-canvas

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

FAQPage Schema
How do I create a valid JSON Canvas file for Obsidian?

Creating a valid Obsidian JSON Canvas file involves modeling nodes and edges while strictly following Spec 1.0 conventions to ensure unique 16-character hex IDs and prevent structural errors.

How do I edit an existing Obsidian .canvas file without breaking edge connections?

Editing an existing Obsidian .canvas file safely requires validating edge fromNode and toNode references against existing nodes to prevent ID collisions and dangling connections when adding or modifying elements.

What is the JSON Canvas spec for node and edge validation?

The JSON Canvas spec requires unique 16-character hex IDs for nodes, correct node type fields, and validated edge fromNode/toNode references to maintain structural integrity across mind maps and flowcharts.

Can I use JSON Canvas to build mind maps and flowcharts in Obsidian?

Yes, you can use JSON Canvas to build mind maps, flowcharts, and project boards in Obsidian by generating consistent node sizing, spacing, and non-overlapping edge planning for clear visual maps.

Why does my Obsidian canvas break after adding new nodes?

Your Obsidian canvas likely breaks due to ID collisions or dangling edge references. Adding nodes requires generating unique 16-character hex IDs and updating validated fromNode/toNode connections to maintain spec compliance.