CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

design-system

Captures the user's brand identity once via a 10-question onboarding wizard (primary/accent HEX + heading + body Google Fonts + design style editorial/technical/minimal/playful + default output directory + syntax theme + TOC behavior + optional logo/company), validates body-text and link contrast against WCAG 2.2 AA, derives 12 CSS custom properties in HSL space, and stores the result for every markdown-html converter to consume. Use before any markdown-html conversion. Triggers on first-run onboarding ("set up the brand", "configure markdown-html", "run onboarding"), on explicit reset ("reset the design system", "re-onboard"), and is checked by every converter via config_loader.py before rendering. Refuses to save if body-text contrast fails AA 4.5:1 or the output dir isn't writable. Precedence is project (./.markdown-html/), then global (~/.config/markdown-html/), then built-in defaults; MARKDOWN_HTML_NO_CONFIG=1 bypasses.

65

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is design-system in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

70%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, operationally rich body: the symptom-to-action table, hard rules with exit codes, and worked example make the workflow unambiguous and self-validating. Its weaknesses are duplicated philosophical framing (the forcing-question library and its canon citations) and references to script/asset files that are not actually shipped in the bundle.

Suggestions

Merge the forcing-question library's recommended answers into the 10-question table and drop the canon citations (Aarron Walter, Ellen Lupton, Adobe Spectrum, Nielsen-Norman) — they duplicate the question set and add tokens Claude doesn't need.

Ship the referenced bundle files (scripts/onboard.py, scripts/config_loader.py, scripts/brand_palette_validator.py, assets/design_system_schema.json) or remove the references — every path beyond SKILL.md is currently dangling.

Replace the '.../' path abbreviations in the worked example and invoke table with the full 'markdown-html/skills/design-system/scripts/' path so every command is copy-paste ready.

DimensionReasoningScore

Conciseness

Mostly efficient operational content (tables of questions, tokens, exit codes, commands), but it includes unnecessary material: the 'Forcing-question library' section re-covers the 10-question set and pads each item with canon citations ("Canon: Aarron Walter, Designing for Emotion (color carries brand affect)", "Canon: Ellen Lupton, Thinking with Type") that duplicate the question table and add background knowledge Claude does not need. This fits the 'mostly efficient but includes some unnecessary explanation' anchor rather than the 4 anchor's 'minor instances'.

3 / 5

Actionability

Concrete, near-executable guidance throughout — exact invocations with flags ("python3 .../onboard.py --set brand.primary=#FF6B35 --set design_style=editorial", "MARKDOWN_HTML_NO_CONFIG=1 python3 .../config_loader.py --show", "brand_palette_validator.py --primary \"#FF6B35\" --accent \"#00D4AA\"") plus exit codes 3 and 4. It misses the 5 anchor because many commands use abbreviated '.../' paths instead of the copy-paste-ready full path given once at the top.

4 / 5

Workflow Clarity

Clear sequencing with explicit validation and feedback loops: "onboard.py refuses to save (exit code 4) and tells the user to pick a darker primary, blank brand.bg/brand.text to let derivation pick a safe pair, or override brand.text directly", exit code 3 for unwritable output dirs, a symptom-to-action 'When to invoke' table, and an ordered worked example covering first-run, override, reset, inspect, and bypass. This matches the 5 anchor (explicit validation steps, error-recovery guidance); no destructive/batch operation lacks validation.

5 / 5

Progressive Disclosure

Sections are well organized with clear headers, but the body references bundle files that do not exist — "This skill ships exactly three Python tools" (scripts/onboard.py, config_loader.py, brand_palette_validator.py) and "JSON schema lives at assets/design_system_schema.json" — while no scripts/ or assets/ directories are present in the bundle. Per the guideline to score against the actual bundle structure, the clearly-signaled references are all dangling, which undercuts the 'references mostly clear' 4 anchor and lands at 'some structure but could be better organized'.

3 / 5

Total

15

/

20

Passed

Description

88%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 dense, highly specific description that answers what, when, and how-it-fails with concrete trigger phrases, exact thresholds (4.5:1, 12 tokens, 10 questions), and failure semantics. Its only weaknesses are minor: no file-extension/artifact-name triggers and slight trigger overlap with the sibling converter skills.

DimensionReasoningScore

Specificity

Lists multiple concrete actions with quantitative precision — "Captures the user's brand identity once via a 10-question onboarding wizard", "validates body-text and link contrast against WCAG 2.2 AA", "derives 12 CSS custom properties in HSL space", "Refuses to save if body-text contrast fails AA 4.5:1" — matching the comprehensive-coverage anchor; the 4 anchor's 'minor gaps in coverage' does not apply, and it is clearly far above the 1-2 concrete actions of the 3 anchor. Voice is third person throughout, so no penalty applies.

5 / 5

Completeness

Explicitly answers both questions: the 'what' ("Captures… validates… derives… stores the result for every markdown-html converter to consume") and the 'when' ("Use before any markdown-html conversion. Triggers on first-run onboarding…") with concrete quoted trigger phrases, matching the 5 anchor exactly. The 4 anchor ('when' could be more explicit or specific) is surpassed.

5 / 5

Trigger Term Quality

Good natural trigger phrases with variations — "set up the brand", "configure markdown-html", "run onboarding", "reset the design system", "re-onboard", "Use before any markdown-html conversion" — meeting the 'good keyword coverage' anchor. It falls short of the 5 anchor because it omits file extensions/artifact names (e.g. design-system.json) and common synonyms such as 'brand colors' or 'theme'.

4 / 5

Distinctiveness Conflict Risk

A clear niche (brand onboarding/token derivation for the markdown-html plugin) with distinct triggers like "set up the brand" and "reset the design system", but "Use before any markdown-html conversion" overlaps the trigger territory of the sibling converter skills in the same plugin, so it is 'mostly distinct; minor overlap risk' rather than the minimal-conflict 5 anchor.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/design-system/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.