How-to · Knowledge & Research · By Steph Ango (Kepano / Obsidian)

How to use JSON Canvas in your AI agent

Install and use the JSON Canvas skill in Claude Code, Cursor, Codex, Gemini CLI, OpenCode, and Windsurf — with sample prompts.

What you'll get

This skill helps you build infinite-canvas diagrams in Obsidian using the JSON Canvas format. Think visual note-taking with boxes, arrows, and connections — perfect for brainstorming, project planning, or mapping out complex ideas. Your AI assistant handles all the technical details; you just describe what you want to visualize.

Step 1 — Get the skill source URL

The JSON Canvas skill lives at:

Step 2 — Add it to your AI agent

Copy one of these prompts and paste it into your AI tool. The agent will fetch and install the skill for you.

Claude Code

Add the agent skill from https://github.com/kepano/obsidian-skills/tree/main/skills/json-canvas to my project.

Cursor

Install this agent skill: https://github.com/kepano/obsidian-skills/tree/main/skills/json-canvas

Codex

Add this skill to .codex/skills/: https://github.com/kepano/obsidian-skills/tree/main/skills/json-canvas

Gemini CLI

Add the skill at https://github.com/kepano/obsidian-skills/tree/main/skills/json-canvas to my .gemini/skills/ directory.

OpenCode

Install this agent skill from https://github.com/kepano/obsidian-skills/tree/main/skills/json-canvas

Windsurf

Add this skill: https://github.com/kepano/obsidian-skills/tree/main/skills/json-canvas

Step 3 — Try these prompts

Once the skill is installed, ask your AI things like:

  • Brainstorming a new project and want to map out all the moving pieces
  • Visualize how different ideas or documents connect to each other
  • Planning a workflow or process and want to see it as a flowchart
  • Turn scattered notes into an organized visual knowledge map

What this skill does

  • Creates visual canvases with text boxes, images, links, and grouped elements
  • Connects ideas with labeled arrows and color-coded relationships
  • Generates mind maps, flowcharts, project boards, and research diagrams
  • Organizes complex information spatially so you can see the big picture
  • Saves files that open directly in Obsidian's canvas view
Made bySteph Ango (Kepano / Obsidian)
CategoryKnowledge & Research