[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ENWN37EQNAP8HBSPTS415F":3,"skill-same:01M7ENWN37EQNAP8HBSPTS415F":65},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":33,"commitSha":34,"skillDirectory":35,"forksCount":36,"repositoryHtmlUrl":37,"repositoryHomepageUrl":6,"ownerHtmlUrl":38,"ownerBlogUrl":39,"ownerDescription":6,"updatedAt":40,"install":41,"resources":54},"01M7ENWN37EQNAP8HBSPTS415F","design-system-starter",null,"Create and evolve design systems with design tokens, component architecture, accessibility guidelines, and documentation templates. Ensures consistent, scalable, and accessible UI across products.","TanNhatCMS\u002Fjarvis","TanNhatCMS","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F113796420?v=4","01M753MV17KG5CD3152G3WQEQY","KietNT","01M7EKEDYVYQ6PWVJJMZ911VMX",0,"MIT","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-imp-design-system-starter\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: design-system-starter\ndescription: Create and evolve design systems with design tokens, component architecture, accessibility guidelines, and documentation templates. Ensures consistent, scalable, and accessible UI across products.\nlicense: MIT\nmetadata:\n  version: 1.0.0\n  tags: [design-system, ui, components, design-tokens, accessibility, frontend]\n---\n\n# Design System Starter\n\nBuild robust, scalable design systems that ensure visual consistency and exceptional user experiences.\n\n---\n\n## Quick Start\n\nJust describe what you need:\n\n```\nCreate a design system for my React app with dark mode support\n```\n\nThat's it. The skill provides tokens, components, and accessibility guidelines.\n\n---\n\n## Triggers\n\n| Trigger | Example |\n|---------|---------|\n| Create design system | \"Create a design system for my app\" |\n| Design tokens | \"Set up design tokens for colors and spacing\" |\n| Component architecture | \"Design component structure using atomic design\" |\n| Accessibility | \"Ensure WCAG 2.1 compliance for my components\" |\n| Dark mode | \"Implement theming with dark mode support\" |\n\n---\n\n## Quick Reference\n\n| Task | Output |\n|------|--------|\n| Design tokens | Color, typography, spacing, shadows JSON |\n| Component structure | Atomic design hierarchy (atoms, molecules, organisms) |\n| Theming | CSS variables or ThemeProvider setup |\n| Accessibility | WCAG 2.1 AA compliant patterns |\n| Documentation | Component docs with props, examples, a11y notes |\n\n---\n\n## Bundled Resources\n\n- `references\u002Fcomponent-examples.md` - Complete component implementations\n- `templates\u002Fdesign-tokens-template.json` - W3C design token format\n- `templates\u002Fcomponent-template.tsx` - React component template\n- `checklists\u002Fdesign-system-checklist.md` - Design system audit checklist\n\n---\n\n## Design System Philosophy\n\n### What is a Design System?\n\nA design system is more than a component library—it's a collection of:\n\n1. **Design Tokens**: Foundational design decisions (colors, spacing, typography)\n2. **Components**: Reusable UI building blocks\n3. **Patterns**: Common UX solutions and compositions\n4. **Guidelines**: Rules, principles, and best practices\n5. **Documentation**: How to use everything effectively\n\n### Core Principles\n\n**1. Consistency Over Creativity**\n- Predictable patterns reduce cognitive load\n- Users learn once, apply everywhere\n- Designers and developers speak the same language\n\n**2. Accessible by Default**\n- WCAG 2.1 Level AA compliance minimum\n- Keyboard navigation built-in\n- Screen reader support from the start\n\n**3. Scalable and Maintainable**\n- Design tokens enable global changes\n- Component composition reduces duplication\n- Versioning and deprecation strategies\n\n**4. Developer-Friendly**\n- Clear API contracts\n- Comprehensive documentation\n- Easy to integrate and customize\n\n---\n\n## Design Tokens\n\nDesign tokens are the atomic design decisions that define your system's visual language.\n\n### Token Categories\n\n#### 1. Color Tokens\n\n**Primitive Colors** (Raw values):\n```json\n{\n  \"color\": {\n    \"primitive\": {\n      \"blue\": {\n        \"50\": \"#eff6ff\",\n        \"100\": \"#dbeafe\",\n        \"200\": \"#bfdbfe\",\n        \"300\": \"#93c5fd\",\n        \"400\": \"#60a5fa\",\n        \"500\": \"#3b82f6\",\n        \"600\": \"#2563eb\",\n        \"700\": \"#1d4ed8\",\n        \"800\": \"#1e40af\",\n        \"900\": \"#1e3a8a\",\n        \"950\": \"#172554\"\n      }\n    }\n  }\n}\n```\n\n**Semantic Colors** (Contextual meaning):\n```json\n{\n  \"color\": {\n    \"semantic\": {\n      \"brand\": {\n        \"primary\": \"{color.primitive.blue.600}\",\n        \"primary-hover\": \"{color.primitive.blue.700}\",\n        \"primary-active\": \"{color.primitive.blue.800}\"\n      },\n      \"text\": {\n        \"primary\": \"{color.primitive.gray.900}\",\n        \"secondary\": \"{color.primitive.gray.600}\",\n        \"tertiary\": \"{color.primitive.gray.500}\",\n        \"disabled\": \"{color.primitive.gray.400}\",\n        \"inverse\": \"{color.primitive.white}\"\n      },\n      \"background\": {\n        \"primary\": \"{color.primitive.white}\",\n        \"secondary\": \"{color.primitive.gray.50}\",\n        \"tertiary\": \"{color.primitive.gray.100}\"\n      },\n      \"feedback\": {\n        \"success\": \"{color.primitive.green.600}\",\n        \"warning\": \"{color.primitive.yellow.600}\",\n        \"error\": \"{color.primitive.red.600}\",\n        \"info\": \"{color.primitive.blue.600}\"\n      }\n    }\n  }\n}\n```\n\n**Accessibility**: Ensure color contrast ratios meet WCAG 2.1 Level AA:\n- Normal text: 4.5:1 minimum\n- Large text (18pt+ or 14pt+ bold): 3:1 minimum\n- UI components and graphics: 3:1 minimum\n\n#### 2. Typography Tokens\n\n```json\n{\n  \"typography\": {\n    \"fontFamily\": {\n      \"sans\": \"'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif\",\n      \"serif\": \"'Georgia', 'Times New Roman', serif\",\n      \"mono\": \"'Fira Code', 'Courier New', monospace\"\n    },\n    \"fontSize\": {\n      \"xs\": \"0.75rem\",     \u002F\u002F 12px\n      \"sm\": \"0.875rem\",    \u002F\u002F 14px\n      \"base\": \"1rem\",      \u002F\u002F 16px\n      \"lg\": \"1.125rem\",    \u002F\u002F 18px\n      \"xl\": \"1.25rem\",     \u002F\u002F 20px\n      \"2xl\": \"1.5rem\",     \u002F\u002F 24px\n      \"3xl\": \"1.875rem\",   \u002F\u002F 30px\n      \"4xl\": \"2.25rem\",    \u002F\u002F 36px\n      \"5xl\": \"3rem\"        \u002F\u002F 48px\n    },\n    \"fontWeight\": {\n      \"normal\": 400,\n      \"medium\": 500,\n      \"semibold\": 600,\n      \"bold\": 700\n    },\n    \"lineHeight\": {\n      \"tight\": 1.25,\n      \"normal\": 1.5,\n      \"relaxed\": 1.75,\n      \"loose\": 2\n    },\n    \"letterSpacing\": {\n      \"tight\": \"-0.025em\",\n      \"normal\": \"0\",\n      \"wide\": \"0.025em\"\n    }\n  }\n}\n```\n\n#### 3. Spacing Tokens\n\n**Scale**: Use a consistent spacing scale (commonly 4px or 8px base)\n\n```json\n{\n  \"spacing\": {\n    \"0\": \"0\",\n    \"1\": \"0.25rem\",   \u002F\u002F 4px\n    \"2\": \"0.5rem\",    \u002F\u002F 8px\n    \"3\": \"0.75rem\",   \u002F\u002F 12px\n    \"4\": \"1rem\",      \u002F\u002F 16px\n    \"5\": \"1.25rem\",   \u002F\u002F 20px\n    \"6\": \"1.5rem\",    \u002F\u002F 24px\n    \"8\": \"2rem\",      \u002F\u002F 32px\n    \"10\": \"2.5rem\",   \u002F\u002F 40px\n    \"12\": \"3rem\",     \u002F\u002F 48px\n    \"16\": \"4rem\",     \u002F\u002F 64px\n    \"20\": \"5rem\",     \u002F\u002F 80px\n    \"24\": \"6rem\"      \u002F\u002F 96px\n  }\n}\n```\n\n**Component-Specific Spacing**:\n```json\n{\n  \"component\": {\n    \"button\": {\n      \"padding-x\": \"{spacing.4}\",\n      \"padding-y\": \"{spacing.2}\",\n      \"gap\": \"{spacing.2}\"\n    },\n    \"card\": {\n      \"padding\": \"{spacing.6}\",\n      \"gap\": \"{spacing.4}\"\n    }\n  }\n}\n```\n\n#### 4. Border Radius Tokens\n\n```json\n{\n  \"borderRadius\": {\n    \"none\": \"0\",\n    \"sm\": \"0.125rem\",   \u002F\u002F 2px\n    \"base\": \"0.25rem\",  \u002F\u002F 4px\n    \"md\": \"0.375rem\",   \u002F\u002F 6px\n    \"lg\": \"0.5rem\",     \u002F\u002F 8px\n    \"xl\": \"0.75rem\",    \u002F\u002F 12px\n    \"2xl\": \"1rem\",      \u002F\u002F 16px\n    \"full\": \"9999px\"\n  }\n}\n```\n\n#### 5. Shadow Tokens\n\n```json\n{\n  \"shadow\": {\n    \"xs\": \"0 1px 2px 0 rgba(0, 0, 0, 0.05)\",\n    \"sm\": \"0 1px 3px 0 rgba(0, 0, 0, 0.1), 0 1px 2px -1px rgba(0, 0, 0, 0.1)\",\n    \"base\": \"0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -2px rgba(0, 0, 0, 0.1)\",\n    \"md\": \"0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1)\",\n    \"lg\": \"0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 8px 10px -6px rgba(0, 0, 0, 0.1)\",\n    \"xl\": \"0 25px 50px -12px rgba(0, 0, 0, 0.25)\"\n  }\n}\n```\n\n---\n\n## Component Architecture\n\n### Atomic Design Methodology\n\n**Atoms** → **Molecules** → **Organisms** → **Templates** → **Pages**\n\n#### Atoms (Primitive Components)\nBasic building blocks that can't be broken down further.\n\n**Examples:**\n- Button\n- Input\n- Label\n- Icon\n- Badge\n- Avatar\n\n**Button Component:**\n```typescript\ninterface ButtonProps {\n  variant?: 'primary' | 'secondary' | 'outline' | 'ghost';\n  size?: 'sm' | 'md' | 'lg';\n  disabled?: boolean;\n  loading?: boolean;\n  icon?: React.ReactNode;\n  children: React.ReactNode;\n}\n```\n\nSee `references\u002Fcomponent-examples.md` for complete Button implementation with variants, sizes, and styling patterns.\n\n#### Molecules (Simple Compositions)\nGroups of atoms that function together.\n\n**Examples:**\n- SearchBar (Input + Button)\n- FormField (Label + Input + ErrorMessage)\n- Card (Container + Title + Content + Actions)\n\n**FormField Molecule:**\n```typescript\ninterface FormFieldProps {\n  label: string;\n  name: string;\n  error?: string;\n  hint?: string;\n  required?: boolean;\n  children: React.ReactNode;\n}\n```\n\nSee `references\u002Fcomponent-examples.md` for FormField, Card (compound component pattern), Input with variants, Modal, and more composition examples.\n\n#### Organisms (Complex Compositions)\nComplex UI components made of molecules and atoms.\n\n**Examples:**\n- Navigation Bar\n- Product Card Grid\n- User Profile Section\n- Modal Dialog\n\n#### Templates (Page Layouts)\nPage-level structures that define content placement.\n\n**Examples:**\n- Dashboard Layout (Sidebar + Header + Main Content)\n- Marketing Page Layout (Hero + Features + Footer)\n- Settings Page Layout (Tabs + Content Panels)\n\n#### Pages (Specific Instances)\nActual pages with real content.\n\n---\n\n## Component API Design\n\n### Props Best Practices\n\n**1. Predictable Prop Names**\n```typescript\n\u002F\u002F ✅ Good: Consistent naming\n\u003CButton variant=\"primary\" size=\"md\" \u002F>\n\u003CInput variant=\"outlined\" size=\"md\" \u002F>\n\n\u002F\u002F ❌ Bad: Inconsistent\n\u003CButton type=\"primary\" sizeMode=\"md\" \u002F>\n\u003CInput style=\"outlined\" inputSize=\"md\" \u002F>\n```\n\n**2. Sensible Defaults**\n```typescript\n\u002F\u002F ✅ Good: Provides defaults\ninterface ButtonProps {\n  variant?: 'primary' | 'secondary';  \u002F\u002F Default: primary\n  size?: 'sm' | 'md' | 'lg';          \u002F\u002F Default: md\n}\n\n\u002F\u002F ❌ Bad: Everything required\ninterface ButtonProps {\n  variant: 'primary' | 'secondary';\n  size: 'sm' | 'md' | 'lg';\n  color: string;\n  padding: string;\n}\n```\n\n**3. Composition Over Configuration**\n```typescript\n\u002F\u002F ✅ Good: Composable\n\u003CCard>\n  \u003CCard.Header>\n    \u003CCard.Title>Title\u003C\u002FCard.Title>\n  \u003C\u002FCard.Header>\n  \u003CCard.Body>Content\u003C\u002FCard.Body>\n  \u003CCard.Footer>Actions\u003C\u002FCard.Footer>\n\u003C\u002FCard>\n\n\u002F\u002F ❌ Bad: Too many props\n\u003CCard\n  title=\"Title\"\n  content=\"Content\"\n  footerContent=\"Actions\"\n  hasHeader={true}\n  hasFooter={true}\n\u002F>\n```\n\n**4. Polymorphic Components**\nAllow components to render as different HTML elements:\n```typescript\n\u003CButton as=\"a\" href=\"\u002Flogin\">Login\u003C\u002FButton>\n\u003CButton as=\"button\" onClick={handleClick}>Click Me\u003C\u002FButton>\n```\n\nSee `references\u002Fcomponent-examples.md` for complete polymorphic component TypeScript patterns.\n\n---\n\n## Theming and Dark Mode\n\n### Theme Structure\n\n```typescript\ninterface Theme {\n  colors: {\n    brand: {\n      primary: string;\n      secondary: string;\n    };\n    text: {\n      primary: string;\n      secondary: string;\n    };\n    background: {\n      primary: string;\n      secondary: string;\n    };\n    feedback: {\n      success: string;\n      warning: string;\n      error: string;\n      info: string;\n    };\n  };\n  typography: {\n    fontFamily: {\n      sans: string;\n      mono: string;\n    };\n    fontSize: Record\u003Cstring, string>;\n  };\n  spacing: Record\u003Cstring, string>;\n  borderRadius: Record\u003Cstring, string>;\n  shadow: Record\u003Cstring, string>;\n}\n```\n\n### Dark Mode Implementation\n\n**Approach 1: CSS Variables**\n```css\n:root {\n  --color-bg-primary: #ffffff;\n  --color-text-primary: #000000;\n}\n\n[data-theme=\"dark\"] {\n  --color-bg-primary: #1a1a1a;\n  --color-text-primary: #ffffff;\n}\n```\n\n**Approach 2: Tailwind CSS Dark Mode**\n```tsx\n\u003Cdiv className=\"bg-white dark:bg-gray-900 text-gray-900 dark:text-white\">\n  Content\n\u003C\u002Fdiv>\n```\n\n**Approach 3: Styled Components ThemeProvider**\n```typescript\nconst lightTheme = { background: '#fff', text: '#000' };\nconst darkTheme = { background: '#000', text: '#fff' };\n\n\u003CThemeProvider theme={isDark ? darkTheme : lightTheme}>\n  \u003CApp \u002F>\n\u003C\u002FThemeProvider>\n```\n\n---\n\n## Accessibility Guidelines\n\n### WCAG 2.1 Level AA Compliance\n\n#### Color Contrast\n- **Normal text** (\u003C 18pt): 4.5:1 minimum\n- **Large text** (≥ 18pt or ≥ 14pt bold): 3:1 minimum\n- **UI components**: 3:1 minimum\n\n**Tools**: Use contrast checkers like [WebAIM Contrast Checker](https:\u002F\u002Fwebaim.org\u002Fresources\u002Fcontrastchecker\u002F)\n\n#### Keyboard Navigation\n```typescript\n\u002F\u002F ✅ All interactive elements must be keyboard accessible\n\u003Cbutton\n  onClick={handleClick}\n  onKeyDown={(e) => e.key === 'Enter' && handleClick()}\n>\n  Click me\n\u003C\u002Fbutton>\n\n\u002F\u002F ✅ Focus management\n\u003CModal>\n  \u003CFocusTrap>\n    {\u002F* Modal content *\u002F}\n  \u003C\u002FFocusTrap>\n\u003C\u002FModal>\n```\n\n#### ARIA Attributes\nEssential ARIA patterns:\n- `aria-label`: Provide accessible names\n- `aria-expanded`: Communicate expanded\u002Fcollapsed state\n- `aria-controls`: Associate controls with content\n- `aria-live`: Announce dynamic content changes\n\n#### Screen Reader Support\n- Use semantic HTML elements (`\u003Cbutton>`, `\u003Cnav>`, `\u003Cmain>`)\n- Avoid div\u002Fspan soup for interactive elements\n- Provide meaningful labels for all controls\n\nSee `references\u002Fcomponent-examples.md` for complete accessibility examples including Skip Links, focus traps, and ARIA patterns.\n\n---\n\n## Documentation Standards\n\n### Component Documentation Template\n\nEach component should document:\n- **Purpose**: What the component does\n- **Usage**: Import statement and basic example\n- **Variants**: Available visual styles\n- **Props**: Complete prop table with types, defaults, descriptions\n- **Accessibility**: Keyboard support, ARIA attributes, screen reader behavior\n- **Examples**: Common use cases with code\n\nUse Storybook, Docusaurus, or similar tools for interactive documentation.\n\nSee `templates\u002Fcomponent-template.tsx` for the standard component structure.\n\n---\n\n## Design System Workflow\n\n### 1. Design Phase\n- **Audit existing patterns**: Identify inconsistencies\n- **Define design tokens**: Colors, typography, spacing\n- **Create component inventory**: List all needed components\n- **Design in Figma**: Create component library\n\n### 2. Development Phase\n- **Set up tooling**: Storybook, TypeScript, testing\n- **Implement tokens**: CSS variables or theme config\n- **Build atoms first**: Start with primitives\n- **Compose upward**: Build molecules, organisms\n- **Document as you go**: Write docs alongside code\n\n### 3. Adoption Phase\n- **Create migration guide**: Help teams adopt\n- **Provide codemods**: Automate migrations when possible\n- **Run workshops**: Train teams on usage\n- **Gather feedback**: Iterate based on real usage\n\n### 4. Maintenance Phase\n- **Version semantically**: Major\u002Fminor\u002Fpatch releases\n- **Deprecation strategy**: Phase out old components gracefully\n- **Changelog**: Document all changes\n- **Monitor adoption**: Track usage across products\n\n---\n\n## Quick Start Checklist\n\nWhen creating a new design system:\n\n- [ ] Define design principles and values\n- [ ] Establish design token structure (colors, typography, spacing)\n- [ ] Create primitive color palette (50-950 scale)\n- [ ] Define semantic color tokens (brand, text, background, feedback)\n- [ ] Set typography scale and font families\n- [ ] Establish spacing scale (4px or 8px base)\n- [ ] Design atomic components (Button, Input, Label, etc.)\n- [ ] Implement theming system (light\u002Fdark mode)\n- [ ] Ensure WCAG 2.1 Level AA compliance\n- [ ] Set up documentation (Storybook or similar)\n- [ ] Create usage examples for each component\n- [ ] Establish versioning and release strategy\n- [ ] Create migration guides for adopting teams\n","# Design System Starter\n\nBuild robust, scalable design systems that ensure visual consistency and exceptional user experiences.\n\n---\n\n## Quick Start\n\nJust describe what you need:\n\n```\nCreate a design system for my React app with dark mode support\n```\n\nThat's it. The skill provides tokens, components, and accessibility guidelines.\n\n---\n\n## Triggers\n\n| Trigger | Example |\n|---------|---------|\n| Create design system | \"Create a design system for my app\" |\n| Design tokens | \"Set up design tokens for colors and spacing\" |\n| Component architecture | \"Design component structure using atomic design\" |\n| Accessibility | \"Ensure WCAG 2.1 compliance for my components\" |\n| Dark mode | \"Implement theming with dark mode support\" |\n\n---\n\n## Quick Reference\n\n| Task | Output |\n|------|--------|\n| Design tokens | Color, typography, spacing, shadows JSON |\n| Component structure | Atomic design hierarchy (atoms, molecules, organisms) |\n| Theming | CSS variables or ThemeProvider setup |\n| Accessibility | WCAG 2.1 AA compliant patterns |\n| Documentation | Component docs with props, examples, a11y notes |\n\n---\n\n## Bundled Resources\n\n- `references\u002Fcomponent-examples.md` - Complete component implementations\n- `templates\u002Fdesign-tokens-template.json` - W3C design token format\n- `templates\u002Fcomponent-template.tsx` - React component template\n- `checklists\u002Fdesign-system-checklist.md` - Design system audit checklist\n\n---\n\n## Design System Philosophy\n\n### What is a Design System?\n\nA design system is more than a component library—it's a collection of:\n\n1. **Design Tokens**: Foundational design decisions (colors, spacing, typography)\n2. **Components**: Reusable UI building blocks\n3. **Patterns**: Common UX solutions and compositions\n4. **Guidelines**: Rules, principles, and best practices\n5. **Documentation**: How to use everything effectively\n\n### Core Principles\n\n**1. Consistency Over Creativity**\n- Predictable patterns reduce cognitive load\n- Users learn once, apply everywhere\n- Designers and developers speak the same language\n\n**2. Accessible by Default**\n- WCAG 2.1 Level AA compliance minimum\n- Keyboard navigation built-in\n- Screen reader support from the start\n\n**3. Scalable and Maintainable**\n- Design tokens enable global changes\n- Component composition reduces duplication\n- Versioning and deprecation strategies\n\n**4. Developer-Friendly**\n- Clear API contracts\n- Comprehensive documentation\n- Easy to integrate and customize\n\n---\n\n## Design Tokens\n\nDesign tokens are the atomic design decisions that define your system's visual language.\n\n### Token Categories\n\n#### 1. Color Tokens\n\n**Primitive Colors** (Raw values):\n```json\n{\n  \"color\": {\n    \"primitive\": {\n      \"blue\": {\n        \"50\": \"#eff6ff\",\n        \"100\": \"#dbeafe\",\n        \"200\": \"#bfdbfe\",\n        \"300\": \"#93c5fd\",\n        \"400\": \"#60a5fa\",\n        \"500\": \"#3b82f6\",\n        \"600\": \"#2563eb\",\n        \"700\": \"#1d4ed8\",\n        \"800\": \"#1e40af\",\n        \"900\": \"#1e3a8a\",\n        \"950\": \"#172554\"\n      }\n    }\n  }\n}\n```\n\n**Semantic Colors** (Contextual meaning):\n```json\n{\n  \"color\": {\n    \"semantic\": {\n      \"brand\": {\n        \"primary\": \"{color.primitive.blue.600}\",\n        \"primary-hover\": \"{color.primitive.blue.700}\",\n        \"primary-active\": \"{color.primitive.blue.800}\"\n      },\n      \"text\": {\n        \"primary\": \"{color.primitive.gray.900}\",\n        \"secondary\": \"{color.primitive.gray.600}\",\n        \"tertiary\": \"{color.primitive.gray.500}\",\n        \"disabled\": \"{color.primitive.gray.400}\",\n        \"inverse\": \"{color.primitive.white}\"\n      },\n      \"background\": {\n        \"primary\": \"{color.primitive.white}\",\n        \"secondary\": \"{color.primitive.gray.50}\",\n        \"tertiary\": \"{color.primitive.gray.100}\"\n      },\n      \"feedback\": {\n        \"success\": \"{color.primitive.green.600}\",\n        \"warning\": \"{color.primitive.yellow.600}\",\n        \"error\": \"{color.primitive.red.600}\",\n        \"info\": \"{color.primitive.blue.600}\"\n      }\n    }\n  }\n}\n```\n\n**Accessibility**: Ensure color contrast ratios meet WCAG 2.1 Level AA:\n- Normal text: 4.5:1 minimum\n- Large text (18pt+ or 14pt+ bold): 3:1 minimum\n- UI components and graphics: 3:1 minimum\n\n#### 2. Typography Tokens\n\n```json\n{\n  \"typography\": {\n    \"fontFamily\": {\n      \"sans\": \"'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif\",\n      \"serif\": \"'Georgia', 'Times New Roman', serif\",\n      \"mono\": \"'Fira Code', 'Courier New', monospace\"\n    },\n    \"fontSize\": {\n      \"xs\": \"0.75rem\",     \u002F\u002F 12px\n      \"sm\": \"0.875rem\",    \u002F\u002F 14px\n      \"base\": \"1rem\",      \u002F\u002F 16px\n      \"lg\": \"1.125rem\",    \u002F\u002F 18px\n      \"xl\": \"1.25rem\",     \u002F\u002F 20px\n      \"2xl\": \"1.5rem\",     \u002F\u002F 24px\n      \"3xl\": \"1.875rem\",   \u002F\u002F 30px\n      \"4xl\": \"2.25rem\",    \u002F\u002F 36px\n      \"5xl\": \"3rem\"        \u002F\u002F 48px\n    },\n    \"fontWeight\": {\n      \"normal\": 400,\n      \"medium\": 500,\n      \"semibold\": 600,\n      \"bold\": 700\n    },\n    \"lineHeight\": {\n      \"tight\": 1.25,\n      \"normal\": 1.5,\n      \"relaxed\": 1.75,\n      \"loose\": 2\n    },\n    \"letterSpacing\": {\n      \"tight\": \"-0.025em\",\n      \"normal\": \"0\",\n      \"wide\": \"0.025em\"\n    }\n  }\n}\n```\n\n#### 3. Spacing Tokens\n\n**Scale**: Use a consistent spacing scale (commonly 4px or 8px base)\n\n```json\n{\n  \"spacing\": {\n    \"0\": \"0\",\n    \"1\": \"0.25rem\",   \u002F\u002F 4px\n    \"2\": \"0.5rem\",    \u002F\u002F 8px\n    \"3\": \"0.75rem\",   \u002F\u002F 12px\n    \"4\": \"1rem\",      \u002F\u002F 16px\n    \"5\": \"1.25rem\",   \u002F\u002F 20px\n    \"6\": \"1.5rem\",    \u002F\u002F 24px\n    \"8\": \"2rem\",      \u002F\u002F 32px\n    \"10\": \"2.5rem\",   \u002F\u002F 40px\n    \"12\": \"3rem\",     \u002F\u002F 48px\n    \"16\": \"4rem\",     \u002F\u002F 64px\n    \"20\": \"5rem\",     \u002F\u002F 80px\n    \"24\": \"6rem\"      \u002F\u002F 96px\n  }\n}\n```\n\n**Component-Specific Spacing**:\n```json\n{\n  \"component\": {\n    \"button\": {\n      \"padding-x\": \"{spacing.4}\",\n      \"padding-y\": \"{spacing.2}\",\n      \"gap\": \"{spacing.2}\"\n    },\n    \"card\": {\n      \"padding\": \"{spacing.6}\",\n      \"gap\": \"{spacing.4}\"\n    }\n  }\n}\n```\n\n#### 4. Border Radius Tokens\n\n```json\n{\n  \"borderRadius\": {\n    \"none\": \"0\",\n    \"sm\": \"0.125rem\",   \u002F\u002F 2px\n    \"base\": \"0.25rem\",  \u002F\u002F 4px\n    \"md\": \"0.375rem\",   \u002F\u002F 6px\n    \"lg\": \"0.5rem\",     \u002F\u002F 8px\n    \"xl\": \"0.75rem\",    \u002F\u002F 12px\n    \"2xl\": \"1rem\",      \u002F\u002F 16px\n    \"full\": \"9999px\"\n  }\n}\n```\n\n#### 5. Shadow Tokens\n\n```json\n{\n  \"shadow\": {\n    \"xs\": \"0 1px 2px 0 rgba(0, 0, 0, 0.05)\",\n    \"sm\": \"0 1px 3px 0 rgba(0, 0, 0, 0.1), 0 1px 2px -1px rgba(0, 0, 0, 0.1)\",\n    \"base\": \"0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -2px rgba(0, 0, 0, 0.1)\",\n    \"md\": \"0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1)\",\n    \"lg\": \"0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 8px 10px -6px rgba(0, 0, 0, 0.1)\",\n    \"xl\": \"0 25px 50px -12px rgba(0, 0, 0, 0.25)\"\n  }\n}\n```\n\n---\n\n## Component Architecture\n\n### Atomic Design Methodology\n\n**Atoms** → **Molecules** → **Organisms** → **Templates** → **Pages**\n\n#### Atoms (Primitive Components)\nBasic building blocks that can't be broken down further.\n\n**Examples:**\n- Button\n- Input\n- Label\n- Icon\n- Badge\n- Avatar\n\n**Button Component:**\n```typescript\ninterface ButtonProps {\n  variant?: 'primary' | 'secondary' | 'outline' | 'ghost';\n  size?: 'sm' | 'md' | 'lg';\n  disabled?: boolean;\n  loading?: boolean;\n  icon?: React.ReactNode;\n  children: React.ReactNode;\n}\n```\n\nSee `references\u002Fcomponent-examples.md` for complete Button implementation with variants, sizes, and styling patterns.\n\n#### Molecules (Simple Compositions)\nGroups of atoms that function together.\n\n**Examples:**\n- SearchBar (Input + Button)\n- FormField (Label + Input + ErrorMessage)\n- Card (Container + Title + Content + Actions)\n\n**FormField Molecule:**\n```typescript\ninterface FormFieldProps {\n  label: string;\n  name: string;\n  error?: string;\n  hint?: string;\n  required?: boolean;\n  children: React.ReactNode;\n}\n```\n\nSee `references\u002Fcomponent-examples.md` for FormField, Card (compound component pattern), Input with variants, Modal, and more composition examples.\n\n#### Organisms (Complex Compositions)\nComplex UI components made of molecules and atoms.\n\n**Examples:**\n- Navigation Bar\n- Product Card Grid\n- User Profile Section\n- Modal Dialog\n\n#### Templates (Page Layouts)\nPage-level structures that define content placement.\n\n**Examples:**\n- Dashboard Layout (Sidebar + Header + Main Content)\n- Marketing Page Layout (Hero + Features + Footer)\n- Settings Page Layout (Tabs + Content Panels)\n\n#### Pages (Specific Instances)\nActual pages with real content.\n\n---\n\n## Component API Design\n\n### Props Best Practices\n\n**1. Predictable Prop Names**\n```typescript\n\u002F\u002F ✅ Good: Consistent naming\n\u003CButton variant=\"primary\" size=\"md\" \u002F>\n\u003CInput variant=\"outlined\" size=\"md\" \u002F>\n\n\u002F\u002F ❌ Bad: Inconsistent\n\u003CButton type=\"primary\" sizeMode=\"md\" \u002F>\n\u003CInput style=\"outlined\" inputSize=\"md\" \u002F>\n```\n\n**2. Sensible Defaults**\n```typescript\n\u002F\u002F ✅ Good: Provides defaults\ninterface ButtonProps {\n  variant?: 'primary' | 'secondary';  \u002F\u002F Default: primary\n  size?: 'sm' | 'md' | 'lg';          \u002F\u002F Default: md\n}\n\n\u002F\u002F ❌ Bad: Everything required\ninterface ButtonProps {\n  variant: 'primary' | 'secondary';\n  size: 'sm' | 'md' | 'lg';\n  color: string;\n  padding: string;\n}\n```\n\n**3. Composition Over Configuration**\n```typescript\n\u002F\u002F ✅ Good: Composable\n\u003CCard>\n  \u003CCard.Header>\n    \u003CCard.Title>Title\u003C\u002FCard.Title>\n  \u003C\u002FCard.Header>\n  \u003CCard.Body>Content\u003C\u002FCard.Body>\n  \u003CCard.Footer>Actions\u003C\u002FCard.Footer>\n\u003C\u002FCard>\n\n\u002F\u002F ❌ Bad: Too many props\n\u003CCard\n  title=\"Title\"\n  content=\"Content\"\n  footerContent=\"Actions\"\n  hasHeader={true}\n  hasFooter={true}\n\u002F>\n```\n\n**4. Polymorphic Components**\nAllow components to render as different HTML elements:\n```typescript\n\u003CButton as=\"a\" href=\"\u002Flogin\">Login\u003C\u002FButton>\n\u003CButton as=\"button\" onClick={handleClick}>Click Me\u003C\u002FButton>\n```\n\nSee `references\u002Fcomponent-examples.md` for complete polymorphic component TypeScript patterns.\n\n---\n\n## Theming and Dark Mode\n\n### Theme Structure\n\n```typescript\ninterface Theme {\n  colors: {\n    brand: {\n      primary: string;\n      secondary: string;\n    };\n    text: {\n      primary: string;\n      secondary: string;\n    };\n    background: {\n      primary: string;\n      secondary: string;\n    };\n    feedback: {\n      success: string;\n      warning: string;\n      error: string;\n      info: string;\n    };\n  };\n  typography: {\n    fontFamily: {\n      sans: string;\n      mono: string;\n    };\n    fontSize: Record\u003Cstring, string>;\n  };\n  spacing: Record\u003Cstring, string>;\n  borderRadius: Record\u003Cstring, string>;\n  shadow: Record\u003Cstring, string>;\n}\n```\n\n### Dark Mode Implementation\n\n**Approach 1: CSS Variables**\n```css\n:root {\n  --color-bg-primary: #ffffff;\n  --color-text-primary: #000000;\n}\n\n[data-theme=\"dark\"] {\n  --color-bg-primary: #1a1a1a;\n  --color-text-primary: #ffffff;\n}\n```\n\n**Approach 2: Tailwind CSS Dark Mode**\n```tsx\n\u003Cdiv className=\"bg-white dark:bg-gray-900 text-gray-900 dark:text-white\">\n  Content\n\u003C\u002Fdiv>\n```\n\n**Approach 3: Styled Components ThemeProvider**\n```typescript\nconst lightTheme = { background: '#fff', text: '#000' };\nconst darkTheme = { background: '#000', text: '#fff' };\n\n\u003CThemeProvider theme={isDark ? darkTheme : lightTheme}>\n  \u003CApp \u002F>\n\u003C\u002FThemeProvider>\n```\n\n---\n\n## Accessibility Guidelines\n\n### WCAG 2.1 Level AA Compliance\n\n#### Color Contrast\n- **Normal text** (\u003C 18pt): 4.5:1 minimum\n- **Large text** (≥ 18pt or ≥ 14pt bold): 3:1 minimum\n- **UI components**: 3:1 minimum\n\n**Tools**: Use contrast checkers like [WebAIM Contrast Checker](https:\u002F\u002Fwebaim.org\u002Fresources\u002Fcontrastchecker\u002F)\n\n#### Keyboard Navigation\n```typescript\n\u002F\u002F ✅ All interactive elements must be keyboard accessible\n\u003Cbutton\n  onClick={handleClick}\n  onKeyDown={(e) => e.key === 'Enter' && handleClick()}\n>\n  Click me\n\u003C\u002Fbutton>\n\n\u002F\u002F ✅ Focus management\n\u003CModal>\n  \u003CFocusTrap>\n    {\u002F* Modal content *\u002F}\n  \u003C\u002FFocusTrap>\n\u003C\u002FModal>\n```\n\n#### ARIA Attributes\nEssential ARIA patterns:\n- `aria-label`: Provide accessible names\n- `aria-expanded`: Communicate expanded\u002Fcollapsed state\n- `aria-controls`: Associate controls with content\n- `aria-live`: Announce dynamic content changes\n\n#### Screen Reader Support\n- Use semantic HTML elements (`\u003Cbutton>`, `\u003Cnav>`, `\u003Cmain>`)\n- Avoid div\u002Fspan soup for interactive elements\n- Provide meaningful labels for all controls\n\nSee `references\u002Fcomponent-examples.md` for complete accessibility examples including Skip Links, focus traps, and ARIA patterns.\n\n---\n\n## Documentation Standards\n\n### Component Documentation Template\n\nEach component should document:\n- **Purpose**: What the component does\n- **Usage**: Import statement and basic example\n- **Variants**: Available visual styles\n- **Props**: Complete prop table with types, defaults, descriptions\n- **Accessibility**: Keyboard support, ARIA attributes, screen reader behavior\n- **Examples**: Common use cases with code\n\nUse Storybook, Docusaurus, or similar tools for interactive documentation.\n\nSee `templates\u002Fcomponent-template.tsx` for the standard component structure.\n\n---\n\n## Design System Workflow\n\n### 1. Design Phase\n- **Audit existing patterns**: Identify inconsistencies\n- **Define design tokens**: Colors, typography, spacing\n- **Create component inventory**: List all needed components\n- **Design in Figma**: Create component library\n\n### 2. Development Phase\n- **Set up tooling**: Storybook, TypeScript, testing\n- **Implement tokens**: CSS variables or theme config\n- **Build atoms first**: Start with primitives\n- **Compose upward**: Build molecules, organisms\n- **Document as you go**: Write docs alongside code\n\n### 3. Adoption Phase\n- **Create migration guide**: Help teams adopt\n- **Provide codemods**: Automate migrations when possible\n- **Run workshops**: Train teams on usage\n- **Gather feedback**: Iterate based on real usage\n\n### 4. Maintenance Phase\n- **Version semantically**: Major\u002Fminor\u002Fpatch releases\n- **Deprecation strategy**: Phase out old components gracefully\n- **Changelog**: Document all changes\n- **Monitor adoption**: Track usage across products\n\n---\n\n## Quick Start Checklist\n\nWhen creating a new design system:\n\n- [ ] Define design principles and values\n- [ ] Establish design token structure (colors, typography, spacing)\n- [ ] Create primitive color palette (50-950 scale)\n- [ ] Define semantic color tokens (brand, text, background, feedback)\n- [ ] Set typography scale and font families\n- [ ] Establish spacing scale (4px or 8px base)\n- [ ] Design atomic components (Button, Input, Label, etc.)\n- [ ] Implement theming system (light\u002Fdark mode)\n- [ ] Ensure WCAG 2.1 Level AA compliance\n- [ ] Set up documentation (Storybook or similar)\n- [ ] Create usage examples for each component\n- [ ] Establish versioning and release strategy\n- [ ] Create migration guides for adopting teams\n",{"name":5,"license":15,"metadata":24,"description":7},{"tags":25,"version":32},[26,27,28,29,30,31],"design-system","ui","components","design-tokens","accessibility","frontend","1.0.0","main","af388a77c2fe5e0b4fd879cca4300a0ffa9a6579","skills\u002Fams-imp-design-system-starter",1,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis","https:\u002F\u002Fgithub.com\u002FTanNhatCMS","https:\u002F\u002Fmrkiet.name.vn","2026-11-07 14:23:08",{"source":8,"skillName":5,"commands":42,"prompt":52,"zipAvailable":53},[43,46,49],{"tool":44,"command":45},"npx","npx skills add TanNhatCMS\u002Fjarvis --skill design-system-starter",{"tool":47,"command":48},"bunx","bunx skills add TanNhatCMS\u002Fjarvis --skill design-system-starter",{"tool":50,"command":51},"pnpm","pnpm dlx skills add TanNhatCMS\u002Fjarvis --skill design-system-starter","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-imp-design-system-starter\u002FSKILL.md",true,[55,61],{"path":56,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":59,"sourceHtmlUrl":60},"README.md","REFERENCE","参考文档",7652,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-imp-design-system-starter\u002FREADME.md",{"path":62,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Fcomponent-examples.md",13552,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-imp-design-system-starter\u002Freferences\u002Fcomponent-examples.md",[66,73,81,88,95,102],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7EWYJR0J8DARY7E59Z6Y9MV","web-scrape","Turn web pages into LLM-ready markdown via the Firecrawl API (renders JS, anti-bot handling). Use when browser_open\u002Ffetch fails on JS-heavy pages, or when you need clean markdown\u002Fstructured extraction from a site. Requires FIRECRAWL_API_KEY.","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fweb-scrape\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":77,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7EWYBN5P6F2AJG3FR24T9BP","design-taste-frontend","tasteskill v2, the anti-slop frontend skill. Art direction for websites, distilled from a study of 247 curated gallery sites (One Page Love, Awwwards Sites of the Day). Deals researched directions (idea, composition, type, palette, photographs, section blueprints) from a library, enforces a strict no-slop house style with a real-browser inspector, and runs a look-and-fix loop on screenshots. Use this whenever you build, design, redesign, restyle, polish or review a landing page, marketing site, portfolio, product page, one-pager, hero or any public-facing web page, in any stack (HTML\u002FCSS, React, Next.js, Vue, Svelte, Astro, Tailwind) — also when the user says a page looks generic, templated, \"AI-made\", sloppy, or asks to make it look designed, premium, award-level or less like every other site. Not for dashboards or app screens.","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Ftaste-design\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Ftaste-design\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7EWY8FQFNQ2GB7NZZWGSSDX","test-driven-development","Use when implementing any feature or bugfix, before writing implementation code","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-tdd\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7EWY5SHBFRH1HDHVWM9K7TV","systematic-debugging","Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-debugging\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M7EWY3NM0Z0JAKS7HDZ24K66","requesting-code-review","Use when completing tasks, implementing major features, or before merging to verify work meets requirements","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-code-review\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":19},"01M7EWY0WRMWX4M9ZFY0WKC593","brainstorming","You 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).","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-brainstorming\u002FSKILL.md",[],[]]