ilandahan/AID / skills/atomic-design
atomic-design
VerifiedBuild an Atomic Design system from design spec style guides - extract tokens, create atoms/molecules/organisms/templates/pages as reusable component libraries. Use when building or extending a design system or component library.
| File | Kind | Size |
|---|---|---|
| SKILL.extended.md | markdown | 14.6 KB |
| SKILL.md | skill md | 6.0 KB |
| references/atomic-hierarchy.extended.md | markdown | 15.5 KB |
| references/atomic-hierarchy.md | markdown | 4.2 KB |
| references/component-templates.extended.md | markdown | 23.0 KB |
| references/component-templates.md | markdown | 7.8 KB |
| references/design-deviation-rules.extended.md | markdown | 12.1 KB |
| references/design-deviation-rules.md | markdown | 3.5 KB |
| references/responsive-patterns.extended.md | markdown | 14.3 KB |
| references/responsive-patterns.md | markdown | 4.6 KB |
| tokens/breakpoints.json | config | 659 B |
| tokens/colors.json | config | 1.6 KB |
| tokens/components.json | config | 3.1 KB |
| tokens/spacing.json | config | 1.4 KB |
| tokens/typography.json | config | 1.8 KB |
references/design-deviation-rules.md
View on GitHub# Design Deviation Rules - Zero Tolerance
## Core Rule
Developer is not a designer. Role is to translate design to code - not improve it.
```
"I think it looks better this way" = FORBIDDEN
"design spec shows X, code will be X" = CORRECT
```
## Forbidden Deviations
### Aesthetic
| Forbidden | Example | Why |
|-----------|---------|-----|
| Change colors | #3B82F6 -> #3F85F7 | Designer chose specific color |
| Round values | 13px -> 12px | "Convenient" not relevant |
| Add effects | Add shadow not in design | Design decision |
| Change fonts | Inter -> System fonts | Breaks brand |
| Change spacing | 24px -> 20px | Breaks visual rhythm |
### Technical
| Forbidden | Correct |
|-----------|---------|
| Optimize values | Ask designer for unit preference |
| Standardize font-weight 450 to 500 | Check if font supports 450 |
| Fix inconsistencies | Report to designer, don't fix |
### Responsive
| Forbidden | Correct |
|-----------|---------|
| Invent breakpoints | Check design spec breakpoints |
| Logical adjustments | Extract from design spec Mobile frame |
| Change layout | Implement as shown in design spec |
## When Something Looks Wrong
1. STOP - Don't change anything
2. DOCUMENT - Screenshot the issue
3. ASK - Ask designer: "In [frame] the padding is 13px. Intentional or should be 12px?"
4. WAIT - Wait for response
5. IMPLEMENT - Follow designer guidance
6. DOCUMENT - Record decision
## Allowed Exceptions
### 1. Platform Bug
```css
/* Safari requires prefix */
backdrop-filter: blur(10px);
-webkit-backdrop-filter: blur(10px); /* Allowed - technical fix */
```
### 2. Accessibility Issue (Report First)
```css
/* design spec: 3.5:1 contrast, WCAG requires 4.5:1 */
/* REPORT TO DESIGNER - don't fix yourself */
/* Awaiting update: Jira DESIGN-123 */
```
### 3. Missing State
```css
/* Focus state not in design spec - request from designer */
/* TODO: Jira DESIGN-124 - using browser default */
```
## Documentation Requirements
### Component Header
```tsx
/**
* @design-source ./design-spec.md
* @extracted 2024-01-15
* @designer Sarah Cohen
*
* Specs: height 48px, padding 12px 24px, radius 8px
* All values from design spec - DO NOT MODIFY without approval.
*/
```
### CSS Comments
```css
.button {
padding: 12px 24px; /* design spec: paddingTop/Bottom: 12, Left/Right: 24 */
background: var(--color-primary); /* design spec: fill #3B82F6 */
border-radius: 8px; /* design spec: cornerRadius: 8 */
}
```
## Code Review Checklist
```
design spec Link: [ ] Exists and correct
Values: [ ] All CSS has design spec source
Tokens: [ ] Uses tokens, matches design spec
Visual: [ ] Screenshot shows match
No unauthorized: [ ] No improved colors, rounded values, added effects
```
### Red Flags to Block PR
- Hardcoded color instead of token
- Rounded value different from design spec
- Missing design spec reference
- "Looks better this way" in commit
## The Rules
1. Don't change - implement exactly from design spec
2. Don't improve - improvements are deviations
3. Don't guess - if unclear, ask
4. Don't round - 13px is 13px, not 12px
5. Don't add - if not in design spec, not in code
6. Document - every value needs design spec source
7. Verify - visual check before delivery
## Quick Reference
| Situation | Action |
|-----------|--------|
| Value looks wrong | Ask designer |
| Think it looks better | Not relevant - use design spec |
| Designer made mistake | Report - don't fix |
| Missing state | Request from designer |
| Unsure which value | Ask designer |
| Want to change | Request design spec update first |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |