CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

claude-design

Make and revise designs in the Design (canvas) artifact format (project/canvas.json plus one .dc.html Design Component file per artboard) as local files, then open them in a local canvas editor where the user can view the artboards side by side, retype copy and adjust tweaks. Use when the user asks for an editable canvas of artboards in this format, names claude-design or the Design (canvas) type, or wants to revise a folder that holds project/canvas.json. A one-off HTML prototype or design exploration outside this format is baoyu-design's.

Quality

92%

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

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

An unusually disciplined operational skill: extreme token efficiency, fully executable commands and file shapes, and two numbered workflows with an explicit check-until-zero validation loop and error-recovery paths. The weak point is progressive disclosure: the ten referenced reference pages are missing from the bundle as provided, and the inlined canvas.json/notes/sharing spec plus the cross-skill substitution table add navigation friction that keeps it at the midpoint.

Suggestions

Ship the ten referenced pages (format.md, craft.md, diagrams.md, print.md, questions.md, view-state.md, design-system-components.md, brand-colors.md, brand-typography.md, make-from-this.md) under artifact-type/reference/ in the skill folder, or rewrite the body to be self-contained — as bundled, every 'read X FIRST' instruction points at a file that does not exist.

Move the notes-shape, pages/launch and Sharing link-role detail into a reference page and keep SKILL.md to the core create/revise loop plus command reference; the canvas.json paragraph is currently a several-hundred-word inline schema.

Replace the 'Reading the references in a canvas' substitution table by editing the reference pages to use this skill's own terms (project/<path>, notes, <root>), so readers do not have to apply a mapping table mid-task.

DimensionReasoningScore

Conciseness

The body is telegraphically dense with zero conceptual filler — it never explains what a design system or canvas is, compresses rules to their minimum ("Write only under `<root>/project/`: a file elsewhere never shows", "NEVER two artboards in one message"), and pushes all detail to reference files. Apparent repetition (the `check` loop, "NEVER VERIFY", "never retype") is contextual restatement of critical constraints in the Creating vs Revising workflows rather than padding, so it matches anchor 5's 'every token earns its place'.

5 / 5

Actionability

Guidance is copy-paste executable throughout: an exact CLI surface with signatures and outputs ("`upload <root> <file>` → `{url:"/_blob/<id>", …}`", "`check <root>` → `problems` (0: done)"), a complete, runnable `.dc.html` skeleton, the full `canvas.json` literal with every key's shape, and precise fallback rules ("Can't upload… an image becomes a labelled placeholder; say so"). This matches anchor 5's fully executable, common-case-covering example.

5 / 5

Workflow Clarity

Creating (steps 1–6) and Revising (steps 1–4) are explicitly sequenced with an embedded validate-fix-retry feedback loop — "Then run `check` and fix what it names until `problems` is 0" (repeated in Revising step 4) — plus recovery paths for refused uploads, mid-run parallel-edit conflicts ("read right before you edit"), and unanswerable questions ("Never end on a question nobody can answer: decide and build"). This is anchor 5's clear sequence with explicit validation and error-recovery loops; the only nit is that 'The calls' command reference is defined after Creating first references it.

5 / 5

Progressive Disclosure

References are well signaled and one level deep — each named with its read trigger ("`format.md` (before a first artboard)", "`print.md` (FIRST for print)", "`make-from-this.md` FIRST") — but the referenced markdown files (format.md, craft.md, diagrams.md, print.md, questions.md, view-state.md, design-system-components.md, brand-colors.md, brand-typography.md) do not exist in the provided bundle, where `artifact-type/reference/` holds only Google-Fonts JSON data. Combined with a dense inlined spec (full canvas.json schema, notes/sharing rules) and a substitution-table section ('Reading the references in a canvas') that makes readers translate another skill's vocabulary, structure is present but imperfect — between anchors 3 and 4 rather than the 'minor organization gaps' of a clean 4.

3 / 5

Total

18

/

20

Passed

Description

87%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 description: concrete capabilities tied to a specific artifact format, an explicit multi-trigger 'Use when' clause, and an explicit boundary against a sibling design skill. Voice is appropriately third-person/infinitive. The only softness is that trigger coverage leans on format-specific terms and the capability list stops short of the skill's full surface (sharing, comments, design systems).

DimensionReasoningScore

Specificity

Concrete actions are named with format specifics — "Make and revise designs in the Design (canvas) artifact format (project/canvas.json plus one .dc.html Design Component file per artboard) as local files, then open them in a local canvas editor" — but coverage stops at make/revise/open, omitting capabilities the skill body actually carries (sharing, comments, design-system install, print/diagrams), so it falls short of the comprehensive anchor 5 and clearly above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

Both halves are explicit: what — "Make and revise designs in the Design (canvas) artifact format… then open them in a local canvas editor where the user can view the artboards side by side, retype copy and adjust tweaks"; when — "Use when the user asks for an editable canvas of artboards in this format, names claude-design or the Design (canvas) type, or wants to revise a folder that holds project/canvas.json". This matches the anchor-5 example structure (capabilities + explicit 'Use when' with concrete trigger phrases); anchor 4's 'when could be more specific' does not apply since three distinct triggers are enumerated.

5 / 5

Trigger Term Quality

Good natural-term coverage — "an editable canvas of artboards", "Design (canvas) type", "claude-design", "revise a folder that holds project/canvas.json" — phrases a user would plausibly say, but common variations like poster/mockup/design-system requests are absent (mockups are routed away by the boundary clause), and some triggers lean technical (.dc.html, canvas.json), placing it just below anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is a specific file format with distinct triggers, and it actively disambiguates the nearest neighbor: "A one-off HTML prototype or design exploration outside this format is baoyu-design's." That explicit boundary plus format-specific triggers (canvas.json, .dc.html, 'Design (canvas)') gives minimal conflict risk, matching anchor 5; anchor 4's 'minor overlap risk with closely related skills' is already addressed by the boundary sentence.

5 / 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

JimLiu/baoyu-design

Path

dsh-plugins/dsh-claude-design/skills/claude-design/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.