web-design-system
Skill2 starsChanged 4 months agoMITView on GitHub
Extract, create, or refine an implementation-ready design system for a website or web app. Use when an agent needs semantic tokens, component anatomy, variants, interaction states, responsive rules, accessibility defaults, or consistency improvements grounded in an existing frontend codebase.
In this repository10 other files it gives its agents.
- AGENTS.mdAGENTS.md
- llms.txtllms.txt
- agentic-site-buildingSkill
- conversion-accessibility-polishSkill
- landing-page-craftSkill
- production-web-architectureSkill
- product-motion-designSkill
- responsive-ui-qaSkill
- technical-seo-discoverySkill
- web-visual-directionSkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 11 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈11
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 12
Extract: when the product is visually coherent but undocumented.
- Distinctive: line 13
Reconcile: when multiple patterns conflict.
- Distinctive: line 14
Create: when a new product has no established UI language.
- Distinctive: line 15
Extend: when a feature needs states or components the system lacks.
- Distinctive: line 31
Verify light/dark themes, core states, narrow/wide layouts, and at least one realistic content stress case.
- Distinctive: line 36
Keep primitive escape hatches available, but make the correct path easier.
- Distinctive: line 37
Do not force every region into a card.
- Distinctive: line 38
Do not encode status through color alone.
- Distinctive: line 39
Keep component APIs small.
- Distinctive: line 41
Document decisions where future contributors would otherwise recreate the inconsistency.
- Distinctive: line 55
Read references/token-checklist.md while defining or auditing tokens and component states.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Web Design System
Build the smallest system that makes the product more coherent. Favor semantic contracts that components can use over a large inventory of decorative values.
Choose the Mode
- Extract when the product is visually coherent but undocumented.
- Reconcile when multiple patterns conflict.
- Create when a new product has no established UI language.
- Extend when a feature needs states or components the system lacks.
Workflow
- Inspect the framework, CSS strategy, theme files, primitives, component library, icon set, and representative screens.
- Inventory repeated values and patterns. Separate intentional variation from accidental drift.
- Map raw values to semantic roles before changing code. Example:
blue-600->action-primary, not "replace every blue." - Define the minimum token layers:
- foundations: color, type, spacing, radius, border, shadow, motion;
- semantic tokens: background, surface, text, border, action, focus, and status;
- component tokens only where a component genuinely needs them.
- Specify component anatomy, variants, sizes, and state behavior. Include content constraints, not only appearance.
- Define responsive behavior and density rules without inventing device-specific duplicates.
- Encode accessibility defaults: semantic elements, names, labels, focus-visible, keyboard behavior, contrast, errors, target size, and reduced motion.
- Implement inside the existing styling mechanism. Avoid parallel token systems.
- Migrate one representative component or screen and remove superseded values when safe.
- Verify light/dark themes, core states, narrow/wide layouts, and at least one realistic content stress case.
System Rules
- Name tokens by purpose, not by current appearance.
- Keep primitive escape hatches available, but make the correct path easier.
- Do not force every region into a card.
- Do not encode status through color alone.
- Keep component APIs small; prefer composition over variant explosions.
- Preserve established patterns unless they harm usability, accessibility, or maintainability.
- Document decisions where future contributors would otherwise recreate the inconsistency.
Delivery Contract
Provide:
- Mode and audit - what exists, what conflicts, and what remains.
- Token map - existing value -> semantic role -> implementation location.
- Component contract - anatomy, variants, states, content limits, responsive behavior.
- Migration slice - at least one real component when code changes are requested.
- Verification evidence - themes, states, viewports, and exceptions tested.
Reference
Read references/token-checklist.md while defining or auditing tokens and component states.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

