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.

1.12x

Quality

—

Does it follow best practices?

Impact

96%

1.12x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Quality

Content

65%

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

A thorough, accurate, and highly actionable JSON Canvas reference, but it is verbose and monolithic: redundant examples and inline reference material that could be offloaded to bundle files inflate the token budget. Adding a creation workflow with validation checkpoints would raise workflow clarity.

Suggestions

Trim the four complete canvas examples to two representative ones and move the rest into a bundled references/EXAMPLES.md, cutting redundancy while preserving coverage.

Add an explicit sequenced workflow (e.g., define nodes -> add edges -> assign groups/colors -> validate against the Validation Rules checklist -> fix and re-validate) with a validate->fix->retry feedback loop.

Extract the attribute tables and validation rules into a references/SPEC.md, keeping SKILL.md as a concise overview that links one level deep.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient spec reference, but four full large JSON examples are redundant (two would convey the same concepts) and the external spec link duplicates some inline material, so it could be tightened.	2 / 3
Actionability	Concrete JSON examples, attribute tables with required/type columns, explicit validation rules, and layout sizing guidance give copy-paste-ready, executable direction.	3 / 3
Workflow Clarity	A "Validation Rules" checklist exists, but there is no sequenced create-to-validate workflow with checkpoints, and the feedback-loop guidance (validate -> fix -> retry) expected for document manipulation is absent.	2 / 3
Progressive Disclosure	Sections are well-organized, but the ~570-line body is monolithic with a full API reference and four complete examples that could be split into bundled files; no references/scripts/assets bundles exist, and the under-50-lines exception does not apply.	2 / 3
	Total	9 / 12 Passed

Description

100%

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, third-person description that clearly conveys both capabilities and explicit use-when triggers tied to natural user language. It is concise, specific, and unlikely to trigger for the wrong skill.

Dimension	Reasoning	Score
Specificity	"Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections" names concrete actions (create, edit) and concrete domain objects, matching the score-3 anchor of multiple specific concrete actions.	3 / 3
Completeness	It explicitly states both what ("Create and edit JSON Canvas files... with nodes, edges, groups, and connections") and when ("Use when working with .canvas files...") with an explicit trigger clause.	3 / 3
Trigger Term Quality	".canvas files, visual canvases, mind maps, flowcharts, Canvas files in Obsidian" are natural terms users would actually say, with good coverage of common variations.	3 / 3
Distinctiveness Conflict Risk	The JSON Canvas / .canvas / Obsidian framing carves a clear niche with distinct triggers, making conflict with other skills unlikely.	3 / 3
	Total	12 / 12 Passed

Validation

87%

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 — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (570 lines); consider splitting into references/ and linking	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: davepoon/buildwithclaude
Commit: 2b23b55

Reviewed: 4 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.