Content
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 comprehensive design system reference with specific values and clear constraint language (MUST/SHOULD/NEVER), which is valuable. However, it reads more like auto-extracted design audit data than curated guidance—some sections include raw detected values (22 colors, element widths like '22px, 21px, 43px') without clear rationale. The lack of executable code examples (CSS, Tailwind classes, or component snippets) significantly limits actionability for an AI agent building interfaces.
Suggestions
Add executable code examples: include a Tailwind config snippet for the design tokens, a sample component in JSX/HTML+CSS, or at minimum CSS custom property declarations that can be copy-pasted.
Curate the auto-detected data: remove or consolidate raw audit artifacts (e.g., the 3-9px font sizes, the 'Count' column, inconsistent element widths) and present only the intentional design scale values.
Add a quick-start section showing how to scaffold a basic Framer-style page with the key constraints applied, giving Claude a concrete starting point.
Split the detailed reference tables (all text styles, full color palette) into a separate REFERENCE.md and keep SKILL.md as a concise overview with the most important constraints and links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient with well-structured tables and clear MUST/SHOULD/NEVER constraints, but includes some redundancy (e.g., 'Border Radius Reference' repeats the scale already listed above, font sizes list includes tiny sizes like 3-9px that seem auto-detected rather than curated, and the 'Count' column in text styles adds no value). The detected layout patterns and element widths feel like raw data dumps rather than curated guidance. | 2 / 3 |
Actionability | The skill provides specific values (hex codes, pixel sizes, font weights) which are concrete and actionable for styling, but lacks executable code examples. No CSS/Tailwind snippets, no component code, no copy-paste ready implementations. The button component table has only one variant with mostly empty fields. Rules like 'lighten background by 10%' are somewhat vague without specifying the mechanism. | 2 / 3 |
Workflow Clarity | The skill is primarily a reference/constraint document rather than a multi-step workflow, so explicit sequencing is less critical. However, there's no guidance on the order of applying these constraints when building a UI, no validation steps (e.g., how to verify contrast ratios meet 4.5:1), and no feedback loops for checking compliance with the design system. | 2 / 3 |
Progressive Disclosure | The content is well-organized with clear section headers and tables, making it easy to scan. However, it's a fairly long monolithic document (~150 lines of dense reference material) that could benefit from splitting detailed token tables and typography references into separate files, with the SKILL.md serving as a concise overview with links. | 2 / 3 |
Total | 8 / 12 Passed |