CtrlK
BlogDocsLog inGet started
Tessl Logo

design-system

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

53

Quality

60%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./design/skills/design-system/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

35%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill provides well-structured output templates for three design system tasks but is undermined by excessive verbosity — particularly the 'Components of a Design System' section which explains concepts Claude already knows. The templates themselves are useful but lack accompanying procedural guidance on *how* to perform audits or detect issues, making the skill more of a formatting guide than an actionable workflow.

Suggestions

Remove the entire 'Components of a Design System' section — Claude already knows what design tokens, components, and patterns are. This saves ~20 lines of unnecessary context.

Add concrete procedural steps for the audit workflow: e.g., 'grep for hardcoded hex values (#[0-9a-f]{6})', 'check component file naming against convention X', 'compare prop names across components for consistency'.

Move the three large output templates to separate referenced files (AUDIT_TEMPLATE.md, DOCUMENT_TEMPLATE.md, EXTEND_TEMPLATE.md) and keep only a brief summary of each in the main SKILL.md.

Add a validation step to the audit workflow — e.g., 'After generating the audit, verify findings by spot-checking 2-3 flagged components before presenting results.'

DimensionReasoningScore

Conciseness

The skill is very verbose, spending significant tokens on listing design system concepts (tokens, components, patterns) that Claude already knows well. The 'Components of a Design System' section is pure concept explanation that adds no actionable value. The output templates, while useful, are extremely long and could be condensed significantly.

1 / 3

Actionability

The output templates provide concrete structure for what to produce, which is helpful. However, there are no executable code examples, no specific commands or tools to run for auditing, and the guidance is largely template-based rather than instructing Claude on *how* to perform the audit (e.g., what to grep for, how to detect hardcoded values). The templates are filled with placeholders rather than realistic examples.

2 / 3

Workflow Clarity

The three subcommands (audit, document, extend) are clearly separated with distinct output formats, but there's no step-by-step process for how to actually perform each task. For example, the audit workflow doesn't specify: scan files → identify patterns → compare against tokens → generate report. There are no validation checkpoints or feedback loops for any of the three workflows.

2 / 3

Progressive Disclosure

The content is structured with clear sections and references CONNECTORS.md appropriately. However, the three massive output templates make the file very long and monolithic — these could be split into separate reference files (e.g., AUDIT_TEMPLATE.md, DOCUMENT_TEMPLATE.md, EXTEND_TEMPLATE.md) with the main file providing a concise overview.

2 / 3

Total

7

/

12

Passed

Description

85%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong description that clearly defines its scope around design system work with three distinct use cases. It uses third person voice correctly and includes an explicit 'Use when...' clause. The main weakness is that trigger term coverage could be broader to capture more natural user phrasings like 'tokens', 'theme', or 'style guide'.

Suggestions

Add more natural trigger terms users might say, such as 'tokens', 'theme', 'style guide', 'UI library', or 'component library' to improve discoverability.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'audit', 'document', 'extend' a design system, plus elaborates with checking naming inconsistencies, hardcoded values, writing documentation for variants/states/accessibility notes, and designing new patterns.

3 / 3

Completeness

Clearly answers both 'what' (audit, document, or extend your design system) and 'when' with an explicit 'Use when...' clause listing three specific trigger scenarios: checking naming inconsistencies, writing component documentation, and designing new patterns.

3 / 3

Trigger Term Quality

Includes relevant terms like 'design system', 'naming inconsistencies', 'hardcoded values', 'components', 'variants', 'states', 'accessibility', but misses common user-facing terms like 'tokens', 'theme', 'style guide', 'UI library', or file format references that users might naturally say.

2 / 3

Distinctiveness Conflict Risk

The focus on design systems with specific sub-tasks like naming consistency audits, component documentation with variants/states/accessibility, and pattern design creates a clear niche that is unlikely to conflict with general coding, documentation, or UI skills.

3 / 3

Total

11

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
anthropics/knowledge-work-plugins
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.