CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

docs-canvas

Render a documentation-style Cursor Canvas that organizes architecture notes, API references, walkthroughs, and how-tos into a navigable layout with sections, tables of contents, and cross-references. Use when the user asks for a docs canvas, documentation overview, architecture walkthrough, API reference page, or wants to render structured documentation as an interactive canvas.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

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 body is token-efficient and well structured, but it is explicitly a placeholder ("the full skill body still needs to be written"): guidance is an outline with no executable examples and only an implicit workflow sequence. Progressive disclosure is fine given the skill's small size, while actionability and workflow clarity lag until the body is filled in.

Suggestions

Replace the placeholder outline with concrete component usage drawn from the canvas SDK's .d.ts exports — e.g., a short example of a section, table-of-contents, and callout component with typical props — so the render step is executable rather than descriptive.

Make the workflow an explicit numbered sequence (read prerequisites -> gather material -> plan layout -> render -> self-check) and inline at least the key validation checkpoint from the referenced self-check instead of leaving it entirely to the external file.

Add one small worked example of the planned canvas structure for a real input (e.g., a short API reference doc mapped to overview card + TOC + body sections) to anchor the 'plan the layout' step.

DimensionReasoningScore

Conciseness

The body is lean with no padding and no explanations of concepts Claude already knows; the four-line placeholder status note ("Status: placeholder... the full skill body still needs to be written") is honest meta-information, and every other section adds guidance. It is not anchor 4 because there is no over-explanation to trim at all.

5 / 5

Actionability

There is real concrete guidance — the four-part layout ("Overview — A short summary card", "Table of contents", "Body sections", "References"), the enumerated primitives (cards, code blocks, DAG/mermaid diagrams, callouts, tables), and exact prerequisite paths — but no examples, commands, or component usage snippets, and the body self-describes as "a starting outline" to be refined. This matches anchor 3 (some concrete guidance but incomplete) rather than anchor 4's mostly-executable guidance.

3 / 5

Workflow Clarity

The sequence exists but is only implied by section order (Prerequisites -> Gather -> Plan -> Render -> Tone) with no explicit checkpoints; validation is delegated to a "self-check" living in the referenced canvas SKILL.md. This fits anchor 3 (sequence present but checkpoints missing or implicit), not anchor 4, which requires most checkpoints present. The skill is not destructive or batch, so no cap applies.

3 / 5

Progressive Disclosure

The body is under 50 lines, well organized into clear sections, and its only references (~/.cursor/skills-cursor/canvas/SKILL.md and sdk/index.d.ts) are one level deep and clearly signaled with full paths. Per the rubric's simple-skill guideline, well-organized sections with no need for external bundle files score 5; the skill bundle contains no references/, scripts/, or assets/ directories to over- or under-structure.

5 / 5

Total

16

/

20

Passed

Description

91%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.

The description is strong: it uses third person, states concrete capabilities (sections, tables of contents, cross-references), and closes with an explicit 'Use when' clause containing five natural trigger phrases. The only softness is minor overlap risk with generic documentation requests and other canvas skills.

DimensionReasoningScore

Specificity

"Render a documentation-style Cursor Canvas that organizes architecture notes, API references, walkthroughs, and how-tos into a navigable layout with sections, tables of contents, and cross-references" lists several concrete actions in third person. It sits between anchors 4 and 5: coverage is strong but the action list centers on one primary verb with supporting features rather than the multiple distinct comprehensive actions of the anchor-5 example.

4 / 5

Completeness

It explicitly answers what ("Render a documentation-style Cursor Canvas that organizes... with sections, tables of contents, and cross-references") and when ("Use when the user asks for...") with concrete trigger phrases, matching the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

"Use when the user asks for a docs canvas, documentation overview, architecture walkthrough, API reference page, or wants to render structured documentation as an interactive canvas" provides five natural trigger phrases with synonyms (docs/documentation, canvas/interactive canvas); no file extensions exist in this domain to include, so the anchor-5 coverage bar is met rather than the 'a few natural terms missing' of anchor 4.

5 / 5

Distinctiveness Conflict Risk

"Cursor Canvas" carves a clear niche with distinct triggers, but phrases like "documentation overview" and "API reference page" carry minor overlap risk with plain documentation-writing requests or sibling canvas skills, fitting anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

cursor/plugins

Path

docs-canvas/skills/docs-canvas/SKILL.md

Reviewed

Table of Contents

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.