json-canvas

Generate and validate JSON Canvas files with unique node and edge IDs.

6|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/NachoOsella/DotFiles-V4 --skill json-canvas-nachoosella
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: json-canvas
Source: https://github.com/NachoOsella/DotFiles-V4/tree/main/pi/.pi/agent/skills/json-canvas
Command: npx skills add https://github.com/NachoOsella/DotFiles-V4 --skill json-canvas-nachoosella

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Creates, edits, and validates JSON Canvas files that represent graphs of nodes and edges, enabling portable visual data structures.

Core Features & Use Cases

  • Create new canvases with the base structure {"nodes": [], "edges": []} and progressively add node types (text, file, link, group).
  • Connect nodes with edges using unique IDs, specify optional anchor sides, and validate references to existing nodes.
  • Use cases include mind maps, project boards, research canvases, and flowcharts that rely on a JSON-based canvas representation.

Quick Start

Create a new .canvas file with the base structure and add nodes and edges that reference each other by unique IDs.

Frequently Asked Questions about json-canvas

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

FAQPage Schema
How do I generate and validate JSON Canvas files for mind maps and flowcharts?

To create and validate JSON Canvas files, you model graphs of nodes and edges while adhering to JSON Canvas Spec 1.0. This ensures valid references for visual workflows like mind maps, flowcharts, and project boards.

What is the JSON Canvas spec structure for creating a new .canvas file?

The JSON Canvas structure for a new .canvas file uses the base format {"nodes": [], "edges": []}. You progressively add node types like text, file, link, or group, and connect them using edges with unique IDs.

Do I need unique IDs for nodes and edges in a JSON Canvas workflow?

Yes, unique 16-character hexadecimal IDs are required for all nodes and edges in a JSON Canvas workflow. This strict adherence ensures valid references and accurately models graphs across research canvases and project boards.

Can I connect nodes with edges and specify anchor sides in a .canvas file?

You can connect nodes with edges using unique IDs and specify optional anchor sides within a .canvas file. This allows you to model structured canvas data and validate references to existing nodes.

What are the limitations when editing JSON Canvas graphs for project boards?

A key limitation when editing JSON Canvas graphs is the strict adherence to JSON Canvas Spec 1.0 and the requirement for 16-character hexadecimal IDs. Failing to validate references to existing nodes breaks the portable visual data structure.