CtrlK
BlogDocsLog inGet started
Tessl Logo

paddle-ui-skills

Paddle's UI design system. Use when building interfaces inspired by Paddle's aesthetic - light mode, Inter font, 4px grid.

70

Quality

62%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

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

Quality

Discovery

75%

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 has a clear 'Use when' clause and is distinctive enough to avoid conflicts with other skills. However, it lacks concrete action verbs describing what the skill actually does (e.g., style components, generate layouts, apply design tokens) and could benefit from additional trigger terms users might naturally use.

Suggestions

Add specific concrete actions the skill performs, e.g., 'Applies Paddle's UI design system to build components, style layouts, and create dashboards.'

Expand trigger terms to include variations like 'Paddle theme', 'Paddle branding', 'dashboard design', 'component styling', or 'design tokens'.

DimensionReasoningScore

Specificity

Names the domain (UI design system) and mentions some specific elements (light mode, Inter font, 4px grid), but doesn't list concrete actions like 'create buttons', 'style forms', 'build layouts'. It describes attributes rather than actions.

2 / 3

Completeness

Clearly answers both 'what' (Paddle's UI design system) and 'when' (Use when building interfaces inspired by Paddle's aesthetic - light mode, Inter font, 4px grid) with an explicit 'Use when' clause and trigger conditions.

3 / 3

Trigger Term Quality

Includes some relevant terms like 'Paddle', 'UI', 'light mode', 'Inter font', '4px grid', and 'interfaces', but misses common variations users might say like 'design system', 'component styling', 'Paddle theme', 'Paddle branding', or 'dashboard UI'.

2 / 3

Distinctiveness Conflict Risk

Very specific to Paddle's design system with distinct identifiers (Paddle, Inter font, 4px grid, light mode). Unlikely to conflict with other design system skills unless there are multiple Paddle-related skills.

3 / 3

Total

10

/

12

Passed

Implementation

50%

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

This skill provides a reasonably well-structured design system reference with specific values and clear MUST/SHOULD/NEVER constraints. Its main weaknesses are the lack of executable code examples (no HTML/CSS/Tailwind snippets showing implementation), verbose reference tables that appear to be raw extraction data rather than curated guidance, and the monolithic structure that mixes quick-reference rules with detailed specifications. The color and typography data also contains some suspicious values (e.g., green surface-raised #78FDAF, green text-primary #2E8D5F) that seem inconsistent with a 'Paddle-style' light-mode design system.

Suggestions

Add concrete, copy-paste ready code examples for key components (e.g., a Tailwind/CSS button, card, and layout skeleton) to improve actionability

Curate the reference tables - remove raw detection artifacts like duplicate text-15px entries and the arbitrary element widths (33px, 28px, 306px, 25px, 17px) that don't provide actionable guidance

Split detailed reference tables (full font size list, all text styles, complete color tokens) into a separate REFERENCE.md file, keeping only the most-used values in the main skill

Verify the color token values - several seem inconsistent with a Paddle-inspired light-mode design (e.g., bright green #78FDAF for surface-raised and borders, green #2E8D5F for primary text)

DimensionReasoningScore

Conciseness

The skill contains useful reference data but is quite verbose with extensive tables that include redundant information (e.g., multiple text-15px entries, listing all 16 font sizes). Some sections like 'Detected Layout Patterns' and the element widths list (33px, 28px, 306px) feel like raw extracted data rather than curated guidance. The repeated border-radius scale and some obvious rules Claude would know (like maintaining contrast ratios) add unnecessary bulk.

2 / 3

Actionability

The skill provides concrete values (hex codes, pixel sizes, specific CSS properties) which is good, but lacks executable code examples. There are no copy-paste ready component snippets, CSS/Tailwind examples, or implementation patterns. The MUST/SHOULD/NEVER rules are specific but would benefit from concrete code showing how to apply them (e.g., a button component example, a layout template).

2 / 3

Workflow Clarity

This is primarily a reference/constraint skill rather than a multi-step workflow, so explicit sequencing is less critical. However, the 'When to Apply' section is vague about how to combine these constraints when building a full interface. There's no guidance on priority when constraints conflict, and no validation steps for checking compliance with the design system.

2 / 3

Progressive Disclosure

The content is organized into clear sections with good headers and tables, but it's a monolithic document that could benefit from splitting detailed reference tables (all font sizes, all text styles, color tokens) into separate reference files. The skill tries to be both a quick-reference guide and a comprehensive specification, making it harder to scan for the most important constraints.

2 / 3

Total

8

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
ihlamury/design-skills
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.