CtrlK
BlogDocsLog inGet started
Tessl Logo

brainstorm-canvas

Operating manual for the agent inside a Brainstorm Canvas project — collaborating on a live Excalidraw board via the excalidraw MCP, in prompted or continuous (watch) mode.

61

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./apps/brainstorm/src-tauri/skills/brainstorm/SKILL.md

The canonical home for this skill is brainstorm-canvas in tombrewsviews/BYOA

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, actionable operating manual that names concrete MCP tools and exact sentinels, with clear mode workflows and a self-contained, navigable layout; its only gaps are missing tool argument signatures and a few rationale asides that add length.

DimensionReasoningScore

Conciseness

Lean and mostly efficient: it names specific MCP tools without explaining what Excalidraw is, though a few rationale asides ('Silence is fine — the app suppresses that sentinel...') could be trimmed.

4 / 5

Actionability

Concrete, named tools (`describe_scene`, `get_canvas_screenshot`, `create_element`, `update_element`, `delete_element`, etc.) and an exact sentinel (`NOTHING_TO_ADD`) give executable guidance, but call signatures/arguments are not shown, leaving a minor gap.

4 / 5

Workflow Clarity

Two modes plus the `@agent` board-instruction path are clearly sequenced, and reconciliation includes a verification checkpoint ('no `@agent` text remains... or it will re-trigger'); minor validation gaps remain around destructive `delete_element` use.

4 / 5

Progressive Disclosure

Self-contained skill with no bundle files; content is split into well-organized, clearly headed sections (shared board, two modes, etiquette) that are easy to navigate with no nested references.

5 / 5

Total

17

/

20

Passed

Description

65%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 clear, niche-specific description that names the Excalidraw MCP and its two modes, but it lacks an explicit 'Use when...' trigger clause, capping completeness, and its actions are stated abstractly rather than enumerated.

Suggestions

Add an explicit trigger clause, e.g. 'Use when collaborating on a Brainstorm Canvas / Excalidraw board, or when the user mentions Excalidraw, brainstorming on a canvas, or watch mode.'

Enumerate concrete actions (read the board, draw/organize elements, suggest in watch mode) instead of the abstract verb 'collaborating'.

Include a couple of natural synonyms or file/extension cues if any apply to broaden trigger coverage.

DimensionReasoningScore

Specificity

Names the domain ('Brainstorm Canvas project', 'live Excalidraw board via the excalidraw MCP') and a couple of concrete modes ('prompted or continuous (watch) mode'), but does not list multiple specific actions; 'collaborating' is relatively abstract.

3 / 5

Completeness

The 'what' is clear (operating manual for collaborating on a live Excalidraw board via MCP in two modes), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric.

3 / 5

Trigger Term Quality

Includes natural terms a user would actually say ('brainstorm', 'Excalidraw', 'canvas', 'watch mode'); coverage is good though a few common variations/synonyms are absent.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche tied to the excalidraw MCP and a brainstorm-canvas workflow; triggers are specific and unlikely to fire for unrelated skills.

5 / 5

Total

15

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
tombrewsviews/BYOA
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.