json-canvas

Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections. Use when working with .canvas files, creating visual canvases, mind maps, flowcharts, or when the user mentions Canvas files in Obsidian.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

The canonical home for this skill is json-canvas in kepano/obsidian-skills

Quality

Content

72%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill is highly actionable as a spec reference with concrete JSON examples and validation rules, but it is a monolithic document with no progressive disclosure into bundle files and lacks an explicit create-validate workflow with feedback checkpoints.

Suggestions

Add a short sequenced workflow (e.g., 1. plan layout, 2. generate nodes with unique 16-char hex IDs, 3. add edges referencing existing node IDs, 4. validate against the 8 rules, 5. fix and re-validate) to turn the static Validation Rules into an explicit feedback loop.

Split the large complete examples and/or full attribute tables into reference files under references/ (e.g., references/examples.md, references/node-reference.md) and link to them from SKILL.md so the main file stays a lean overview.

Trim the redundant opening sentence ('This skill enables skills-compatible agents to create and edit valid JSON Canvas files...') which restates the frontmatter description, and consider cutting one or two of the four full canvas examples in favor of referencing a examples file.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient reference material (attribute tables and JSON examples) with little explanation of concepts Claude already knows, but the opening line repeats the frontmatter description and four large complete canvas examples add length that could be trimmed.	4 / 5
Actionability	It provides copy-paste-ready valid JSON for every node type, full attribute tables with required/type/default columns, and four complete canvas examples covering the common cases (mind map, project board, research canvas, flowchart).	5 / 5
Workflow Clarity	A Validation Rules section provides an 8-rule checklist and Layout Guidelines give positioning advice, but there is no explicit sequenced create-then-validate workflow with feedback checkpoints (e.g., 'if rule X fails, fix and re-check').	3 / 5
Progressive Disclosure	No bundle files exist and all content lives in a single ~400-line SKILL.md; section structure is clear, but the extensive inline attribute reference and complete examples are content that could be split into separate reference files with no such references signaled.	3 / 5
	Total	15 / 20 Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, well-structured description that clearly states capabilities and provides explicit, natural trigger phrases with the file extension and product context. The only minor weakness is that the action verbs are limited to 'create and edit', though the component enumeration compensates.

Dimension	Reasoning	Score
Specificity	The description names the domain and two concrete verbs ('Create and edit') plus the building blocks ('nodes, edges, groups, and connections'), listing several specific actions with only minor coverage gaps versus the multi-verb anchor 5 example.	4 / 5
Completeness	It explicitly answers both 'what' ('Create and edit JSON Canvas files... with nodes, edges, groups, and connections') and 'when' via a concrete 'Use when...' clause with multiple trigger phrases.	5 / 5
Trigger Term Quality	It covers natural terms including the file extension ('.canvas files'), synonyms ('visual canvases', 'mind maps', 'flowcharts'), and the product trigger ('Canvas files in Obsidian'), matching the comprehensive-coverage anchor.	5 / 5
Distinctiveness Conflict Risk	The JSON Canvas / .canvas / Obsidian niche is clearly bounded with distinct triggers, giving minimal conflict risk despite minor overlap with general diagramming terms like 'flowcharts'.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (657 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: anbeime/skill
Path: skills/obsidian-skills-integrated/json-canvas/SKILL.md
Commit: 7054767

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.