$npx -y skills add ihlamury/design-skills --skill githubGitHub's UI design system. Use when building interfaces inspired by GitHub's aesthetic - dark mode, Inter font, 4px grid.
| 1 | # GitHub UI Skills |
| 2 | |
| 3 | Opinionated constraints for building GitHub-style interfaces with AI agents. |
| 4 | |
| 5 | ## When to Apply |
| 6 | |
| 7 | Reference these guidelines when: |
| 8 | - Building dark-mode interfaces |
| 9 | - Creating GitHub-inspired design systems |
| 10 | - Implementing UIs with Inter font and 4px grid |
| 11 | |
| 12 | ## Colors |
| 13 | |
| 14 | - MUST use dark backgrounds (lightness < 20) for primary surfaces - detected lightness: 12 |
| 15 | - MUST use `#10131A` as page background (`surface-base`) |
| 16 | - MUST use `#030036` for primary actions and focus states (`accent`) |
| 17 | - SHOULD reduce color palette (currently 23 colors detected) |
| 18 | - MUST maintain text contrast ratio of at least 4.5:1 for accessibility |
| 19 | |
| 20 | ### Semantic Tokens |
| 21 | |
| 22 | | Token | HEX | RGB | Usage | |
| 23 | |-------|-----|-----|-------| |
| 24 | | `surface-base` | #10131A | rgb(16,19,26) | Page background | |
| 25 | | `surface-raised` | #11122F | rgb(17,18,47) | Cards, modals, raised surfaces | |
| 26 | | `surface-overlay` | #186D29 | rgb(24,109,41) | Overlays, tooltips, dropdowns | |
| 27 | | `text-primary` | #878A91 | rgb(135,138,145) | Headings, body text | |
| 28 | | `text-secondary` | #74777E | rgb(116,119,126) | Secondary, muted text | |
| 29 | | `text-tertiary` | #525C71 | rgb(82,92,113) | Additional text | |
| 30 | | `border-default` | #1A1835 | rgb(26,24,53) | Subtle borders, dividers | |
| 31 | | `success` | #A3D4AD | rgb(163,212,173) | Success states, confirmations | |
| 32 | | `accent` | #030036 | rgb(3,0,54) | Primary actions, links, focus | |
| 33 | |
| 34 | ## Typography |
| 35 | |
| 36 | - MUST use `Inter` as primary font family |
| 37 | - SHOULD use single font family for consistency |
| 38 | - MUST use `53px` / `700` for primary headings |
| 39 | - MUST use `29px` / `400` for body text |
| 40 | - MUST limit font weights to: regular, bold, light |
| 41 | - MUST use `text-balance` for headings and `text-pretty` for body text |
| 42 | - SHOULD use `tabular-nums` for numeric data |
| 43 | - NEVER modify letter-spacing unless explicitly requested |
| 44 | |
| 45 | ### Text Styles |
| 46 | |
| 47 | | Style | Font | Size | Weight | Color | Count | |
| 48 | |-------|------|------|--------|-------|-------| |
| 49 | | `heading-1` | Inter | 53px | 700 | #E3E4EA | 1 | |
| 50 | | `body` | Inter | 29px | 400 | #606A7A | 1 | |
| 51 | | `text-18px` | Inter | 18px | 400 | #A7A8BF | 1 | |
| 52 | | `text-16px` | Inter | 16px | 300 | #989BA2 | 1 | |
| 53 | | `text-15px` | Inter | 15px | 300 | #3F4249 | 1 | |
| 54 | | `text-15px` | Inter | 15px | 400 | #7F848A | 1 | |
| 55 | | `text-15px` | Inter | 15px | 400 | #B5B6C4 | 1 | |
| 56 | | `text-15px` | Inter | 15px | 400 | #A3D4AD | 1 | |
| 57 | | `text-15px` | Inter | 15px | 400 | #6B6B71 | 1 | |
| 58 | | `text-15px` | Inter | 15px | 400 | #9796B1 | 1 | |
| 59 | |
| 60 | ### Typography Reference |
| 61 | |
| 62 | **Font Families:** |
| 63 | - `Inter` (used 54x) |
| 64 | |
| 65 | **Font Sizes:** 4px, 5px, 9px, 10px, 11px, 12px, 13px, 14px, 15px, 16px, 18px, 29px, 53px |
| 66 | |
| 67 | ## Spacing |
| 68 | |
| 69 | - MUST use 4px grid for spacing |
| 70 | - SHOULD use spacing from scale: 2px, 3px, 4px, 5px, 6px, 8px, 11px, 14px |
| 71 | - SHOULD use 5px as default gap between elements |
| 72 | - NEVER use arbitrary spacing values (use design scale) |
| 73 | - SHOULD maintain consistent padding within containers |
| 74 | |
| 75 | ## Borders |
| 76 | |
| 77 | - MUST use border-radius from scale: 3px, 4px, 5px, 9px, 15px, 22px, 29px |
| 78 | - SHOULD use 22px+ radius for pill-shaped elements |
| 79 | - SHOULD limit border widths to: 1px, 2px, 3px, 4px |
| 80 | - SHOULD use 3px as default border-radius |
| 81 | - NEVER use arbitrary border-radius values (use design scale) |
| 82 | - SHOULD use subtle borders (1px) for element separation |
| 83 | |
| 84 | ### Border Radius Reference |
| 85 | |
| 86 | **Scale:** 3px, 4px, 5px, 9px, 15px, 22px, 29px |
| 87 | |
| 88 | ## Layout |
| 89 | |
| 90 | - MUST design for 1920px base viewport width |
| 91 | - SHOULD use consistent element widths: 10px, 9px, 11px, 28px, 21px |
| 92 | - SHOULD maintain text-heavy layout with clear hierarchy |
| 93 | - NEVER use `h-screen`, use `h-dvh` for full viewport height |
| 94 | - MUST respect `safe-area-inset` for fixed elements |
| 95 | - SHOULD use `size-*` for square elements instead of `w-*` + `h-*` |
| 96 | |
| 97 | ### Detected Layout Patterns |
| 98 | |
| 99 | - **Main Content**: width: 1920px, height: 1080px |
| 100 | - **Main Content**: width: 1920px, height: 1004px |
| 101 | - **Header**: height: 64px |
| 102 | |
| 103 | ## Components |
| 104 | |
| 105 | - MUST use `0px` height for input fields |
| 106 | |
| 107 | ### Buttons |
| 108 | |
| 109 | | Variant | Background | Text | Border | Height | Radius | |
| 110 | |---------|------------|------|--------|--------|--------| |
| 111 | | Ghost | transparent | #B5B6C4 | none | - | - | |
| 112 | |
| 113 | ### Inputs |
| 114 | |
| 115 | - Height: `0px` |
| 116 | |
| 117 | ## Interactive States |
| 118 | |
| 119 | ### Focus |
| 120 | |
| 121 | - MUST use `2px` outline with accent color (`#030036`) |
| 122 | - MUST use `2px` outline-offset |
| 123 | - NEVER remove focus indicators |
| 124 | |
| 125 | ### Hover |
| 126 | |
| 127 | - Buttons (primary): lighten background by 10% |
| 128 | - Buttons (secondary): use `#11122F` background |
| 129 | - List items: use `#11122F` background |
| 130 | |
| 131 | ### Disabled |
| 132 | |
| 133 | - MUST use `opacity: 0.5` |
| 134 | - MUST use `cursor: not-allowed` |
| 135 | |
| 136 | ## Interaction |
| 137 | |
| 138 | - MUST use an `AlertDialog` for destructive or irreversible actions |
| 139 | - SHOULD use structural skeletons for loading states |
| 140 | - MUST show errors next to where the action happens |
| 141 | - NEVER block paste in `input` or `textarea` elements |
| 142 | - MUST add an `aria-label` to icon-only buttons |
| 143 | |
| 144 | ## Animation |