x-design

Use when the user wants to apply a visual design system to a project, references a specific brand's style (Linear-like, Stripe-like, Claude-like), asks for a DESIGN.md, or describes aesthetic intent (warm editorial, dark minimal, stark futuristic) for AI UI generation

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

85%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 highly actionable, well-sequenced skill body with strong workflow guardrails and concrete commands. Its main weakness is progressive disclosure: a broken gotchas.md pointer and several orphaned reference files undermine navigation.

Suggestions

Remove or create the missing gotchas.md — the body's "See gotchas.md" link (final section) currently dead-ends.

Reference the orphaned bundle files (00-overview.md, 01-architecture.md, 02-key-components.md, 03-patterns.md) from the body or the Dependencies/Bootstrap section, or remove them if unused.

Tighten the repeated "ask once / skip silently" boilerplate in steps 6-8 into a single shared convention to reduce inline padding.

Dimension	Reasoning	Score
Conciseness	Largely lean and assumes Claude's competence with concrete curl commands and detection tables, but the long inline handoff boilerplate and repeated "ask once / skip silently" refrains in steps 6-8 add padding that could be trimmed.	4 / 5
Actionability	Provides copy-paste-ready curl commands, explicit MCP tool names with signatures, URL templates, and concrete detection heuristics (file markers per framework), fully executable across common cases.	5 / 5
Workflow Clarity	An eight-step workflow with explicit checkpoints — confirm project root, preview-before-install, fail-loud curl -f, warn-before-overwrite, conditional handoff gates — and a Common Mistakes table providing error-recovery feedback loops.	5 / 5
Progressive Disclosure	References to catalog.md, ai-slop-patterns.md and shadcn-handoff.md are real and well-signaled, but the body cites a non-existent gotchas.md (dead link) and four bundled reference files (00-overview through 03-patterns) are never referenced from the body, leaving navigation incomplete.	3 / 5
	Total	17 / 20 Passed

Description

100%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 a strong, specific router description that clearly states both capability and trigger conditions with rich natural synonyms. It concisely conveys a distinct niche without verbosity or over-claiming.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "Resolves user design intent", "fetches via GitHub raw URLs", "installs it into the current project", and the index-only constraint — giving comprehensive coverage with no generic filler.	5 / 5
Completeness	Explicitly answers both what (resolve intent, fetch, install a curated DESIGN.md) and when ("Use when the user wants to apply a visual design system..."), with concrete trigger phrases throughout, matching the level-5 anchor.	5 / 5
Trigger Term Quality	Comprehensive natural terms including brand synonyms ("Linear-like, Stripe-like, Claude-like"), descriptive aesthetic phrases ("warm editorial, dark minimal, stark futuristic"), and the concrete artifact name "DESIGN.md", matching the level-5 anchor for synonym and extension coverage.	5 / 5
Distinctiveness Conflict Risk	The DESIGN.md / awesome-design-md router niche is narrow and the triggers (named brand styles, aesthetic adjectives, DESIGN.md requests) are distinct from general UI skills, yielding minimal conflict risk.	5 / 5
	Total	20 / 20 Passed

Validation

93%

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

Validation for skill structure

Criteria	Description	Result
relative_links	Relative link issues: 2 suspicious	Warning

	Total	15 / 16 Passed

Repository: quangtran88/x-skills
Path: skills/x-design/SKILL.md
Commit: f17a69e

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