[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M757PB2ERTMAPE622H1JXD03":3,"skill-same:01M757PB2ERTMAPE622H1JXD03":53},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":32,"repositoryHtmlUrl":33,"repositoryHomepageUrl":34,"ownerHtmlUrl":35,"ownerBlogUrl":36,"ownerDescription":37,"updatedAt":38,"install":39,"resources":52},"01M757PB2ERTMAPE622H1JXD03","components-and-states",null,"Reference-grade guide to designing and building UI components — anatomy, the full interaction-state matrix, variants vs sizes vs states, sizing tokens, per-component anatomy\u002Fstates\u002Fa11y, and modern headless\u002Fdata-state\u002FCSS patterns across web, iOS, Android, and desktop.","jpoindexter\u002FVanta","jpoindexter","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F2729617?v=4","01M72VRRYY1CP7RPF3B7GHH0CR","01M757GWDBT6RD147ZZ79N4MEX",4,"MIT","https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fdesign-system-skills\u002Fcomponents-and-states\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: components-and-states\ndescription: Reference-grade guide to designing and building UI components — anatomy, the full interaction-state matrix, variants vs sizes vs states, sizing tokens, per-component anatomy\u002Fstates\u002Fa11y, and modern headless\u002Fdata-state\u002FCSS patterns across web, iOS, Android, and desktop.\ntags: [design-systems, components, states, variants, patterns]\n---\n# Components, Variants & States\n\nA component is a contract: a stable **anatomy** (named parts), an **API** (props\u002Fslots), and a complete **state matrix**. Ship all three or you ship a liability. The #1 source of \"feels broken\" UI is missing states — not missing features.\n\n## 1. Component anatomy — the parts model\n\nEvery component decomposes into named parts. Name them; style each part independently; expose them as slots. Headless libraries (Radix, ARK, React Aria) formalize this as `Root`, `Trigger`, `Content`, `Item`, etc.\n\n```\n┌─ Container (Root) ──────────────────────────────┐\n│  [leading slot]  Label \u002F Value  [trailing slot] │\n│                  Helper \u002F Description text       │\n└─────────────────────────────────────────────────┘\n```\n\n| Part | Role | Example |\n|---|---|---|\n| **Container \u002F Root** | Bounding box, owns padding\u002Fradius\u002Fborder, carries `data-state` | the `\u003Cbutton>`, the field wrapper |\n| **Leading** | Icon, avatar, prefix, adornment | search glass in input |\n| **Label** | Primary text, the accessible name | \"Save changes\" |\n| **Value \u002F Content** | Live content | input text, selected option |\n| **Trailing** | Action, chevron, clear, counter, status | clear-X, dropdown caret |\n| **Helper \u002F Description** | Secondary text below | \"We'll never share this\" |\n| **Error \u002F Validation** | Replaces helper when invalid | \"Email is required\" |\n\n**Rule:** A slot accepts arbitrary children (composition); a prop configures a fixed dimension (config). Prefer slots for content, props for behavior\u002Fappearance. See §9.\n\n## 2. The interaction state matrix (define + treat EVERY one)\n\nThis is the heart of the skill. Each state needs a defined **visual treatment** and **a11y signal**. Use `data-state` attributes (set by headless libs or your own code) + native pseudo-classes.\n\n| State | When | Visual treatment | Signal |\n|---|---|---|---|\n| **default \u002F rest** | idle, interactive | base bg\u002Fborder\u002Ftext; sufficient affordance to look clickable | — |\n| **hover** | pointer over (pointer devices only) | subtle bg\u002Felevation\u002Funderline shift; never the *only* affordance | `:hover` |\n| **focus** | element focused (any input) | — (avoid showing for mouse) | `:focus` |\n| **focus-visible** | focused via keyboard | **2px visible ring, 2px offset, ≥3:1 contrast** | `:focus-visible` |\n| **active \u002F pressed** | pointer\u002Fkey down | darken\u002Fscale 0.97\u002Finset shadow; ~instant | `:active`, `[data-state=active]` |\n| **selected \u002F checked** | chosen in a set | filled\u002Faccent bg, check glyph, bold | `[aria-selected]`, `[aria-checked]`, `:checked` |\n| **disabled** | not interactive *and reason exists* | 38–50% opacity OR muted token; `cursor:not-allowed`; **no hover** | `:disabled`, `[aria-disabled]` |\n| **loading \u002F busy** | async in flight | spinner replaces\u002Fjoins label, keep width stable, lock interaction | `[aria-busy=true]`, `[data-state=loading]` |\n| **error \u002F invalid** | failed validation | danger border + helper→error text + icon (not color alone) | `[aria-invalid=true]` |\n| **read-only** | viewable, not editable, still focusable\u002Fcopyable | muted bg, normal text, no edit caret | `[readonly]`, `aria-readonly` |\n| **expanded \u002F open** | disclosure open | rotated chevron, revealed panel | `[aria-expanded=true]`, `[data-state=open]` |\n| **dragging** | being dragged | raised elevation, 0.8 opacity, grabbing cursor, placeholder gap | `[data-dragging]`, `[aria-grabbed]` |\n| **indeterminate** | partial (tri-state checkbox) | dash glyph | `:indeterminate` |\n| **placeholder \u002F empty** | no value yet | muted placeholder text (not a label substitute) | — |\n\n**Combined states** are real: `hover + selected`, `focus-visible + invalid`, `loading + disabled`. Test them. **Precedence** (highest wins): `disabled` > `loading` > `error` > `selected\u002Factive` > `focus-visible` > `hover` > `rest`. A disabled element shows no hover and no error styling change on pointer.\n\n```css\n\u002F* Modern state-driven button — pseudo-classes + data-state + tokens *\u002F\n.btn {\n  --btn-bg: var(--accent-9);\n  --btn-fg: white;\n  display: inline-flex; align-items: center; gap: var(--space-2);\n  block-size: var(--control-h-md); padding-inline: var(--space-4);\n  border-radius: var(--radius-2); border: 1px solid transparent;\n  background: var(--btn-bg); color: var(--btn-fg);\n  font: inherit; cursor: pointer;\n  transition: background .12s, box-shadow .12s, transform .04s;\n}\n.btn:where(:hover)            { --btn-bg: var(--accent-10); }\n.btn:active                   { transform: translateY(.5px) scale(.99); }\n.btn:focus-visible            { outline: 2px solid var(--focus-ring); outline-offset: 2px; }\n.btn:disabled,\n.btn[aria-disabled=\"true\"]    { opacity: .5; cursor: not-allowed; }\n.btn[aria-busy=\"true\"]        { pointer-events: none; }\n.btn[data-state=\"loading\"] .btn__label { visibility: hidden; }\n\u002F* :where() keeps specificity 0 so app overrides win without !important *\u002F\n```\n\nUse `:is()`\u002F`:where()` to group selectors, and `:has()` for parent-aware styling (`.field:has(:invalid)` lights the whole field). Prefer `:focus-visible` over `:focus` — never strip the ring without replacing it.\n\n## 3. Variants vs sizes vs states vs shape\n\nKeep these axes **orthogonal**. A button is `variant × size × state`, not 30 hand-named classes.\n\n- **Semantic variants** (intent\u002Femphasis): `primary` (one per view), `secondary`, `tertiary`, `ghost` (transparent until hover), `outline`, `danger`\u002Fdestructive, `link`. Map to *meaning*, not color — themes reskin them.\n- **Sizes** (one scale, shared across controls):\n\n| Size | Height | Padding-X | Font | Icon | Radius |\n|---|---|---|---|---|---|\n| `sm` | 32px | 12px | 13–14px | 16px | 6px |\n| `md` | 40px | 16px | 14–16px | 20px | 8px |\n| `lg` | 48px | 20px | 16–18px | 24px | 10px |\n\n- **Shape**: `rounded` (default), `pill` (`border-radius: 9999px`), `square` (icon-only). Shape ≠ size.\n- **States**: §2 — runtime, never a variant.\n\n**Props API design:** `variant`, `size`, `shape`, plus boolean state-ish props (`disabled`, `loading`, `selected`). Booleans use `is\u002Fhas\u002Fcan\u002Fshould`. Avoid boolean explosion (`isPrimary isSecondary…`) — use one `variant` union. Validate at the boundary (Zod \u002F TS union). Slots (`leadingIcon`, `children`, `trailingIcon`) over a dozen content props.\n\n## 4. Core components — anatomy · states · a11y\n\n| Component | Key parts | States that MUST exist | a11y essentials |\n|---|---|---|---|\n| **Button** | container, leading, label, trailing | rest\u002Fhover\u002Ffocus-visible\u002Factive\u002Fdisabled\u002F**loading** | `\u003Cbutton type>`; loading→`aria-busy`; icon-only→`aria-label` |\n| **Icon-button** | square container, icon | + tooltip on hover\u002Ffocus | `aria-label` required; min 40×40 hit area |\n| **Input \u002F Textarea** | wrapper, label, leading, field, trailing, helper\u002Ferror | rest\u002Fhover\u002Ffocus\u002Ffilled\u002F**invalid**\u002Fdisabled\u002Fread-only | real `\u003Clabel for>`; `aria-invalid`+`aria-describedby`→error id; textarea: `field-sizing:content` |\n| **Select \u002F Combobox** | trigger(value+chevron), listbox, option, group | closed\u002F**open**\u002Foption hover\u002F**selected**\u002Fdisabled\u002Floading\u002Fempty | `role=combobox` `aria-expanded`; typeahead; ↑↓\u002FHome\u002FEnd\u002FEsc; selected→`aria-selected` |\n| **Checkbox \u002F Radio** | control box, check\u002Fdot, label | unchecked\u002Fchecked\u002F**indeterminate**(cb)\u002Ffocus-visible\u002Fdisabled\u002Finvalid | native input + styled box; radio = one Tab stop, arrows move; label clickable |\n| **Switch \u002F Toggle** | track, thumb, label | off\u002Fon\u002Ffocus-visible\u002Fdisabled\u002Floading | `role=switch` `aria-checked`; instant + animated thumb |\n| **Slider** | track, range fill, thumb(s), ticks | rest\u002Fhover\u002Fdragging\u002Ffocus-visible\u002Fdisabled | `role=slider` `aria-valuemin\u002Fmax\u002Fnow`; arrows ±step, PageUp\u002FDown ±10% |\n| **Card** | container, media, header, body, footer, actions | rest; if interactive → hover\u002Ffocus-visible\u002Factive\u002Fselected | whole-card link → one focusable; don't nest interactives without care |\n| **Badge \u002F Chip \u002F Tag** | container, leading dot\u002Ficon, label, (removable) ✕ | static; chip adds selected\u002Fdisabled\u002Fremovable | removable ✕ → own `aria-label`; status by icon+text, not color alone |\n| **Avatar** | image, fallback initials\u002Ficon, status dot | loaded\u002F**fallback(error)**\u002Floading | `alt` = name or `\"\"` if decorative; status dot needs text equivalent |\n| **Tooltip** | trigger, content, arrow | hidden\u002F**open** | hover *and* focus; `aria-describedby`; never the only place info lives; not for interactive content |\n| **Popover** | trigger, content, arrow | closed\u002Fopen | focus moves in, `Esc` closes, returns focus; `aria-expanded` |\n| **Modal \u002F Dialog** | overlay, container, header(title+close), body, footer | closed\u002Fopen\u002Floading | `role=dialog` `aria-modal`, labelled by title; **focus trap**; `Esc`; scroll-lock; restore focus |\n| **Drawer \u002F Sheet** | scrim, panel, handle | closed\u002Fopen\u002Fdragging(swipe) | same as dialog; edge-swipe on mobile; respects safe-area insets |\n| **Toast \u002F Snackbar** | container, icon, message, action, dismiss | enter\u002Fvisible\u002Fexit; queued | `role=status`(polite)\u002F`role=alert`(assertive); auto-dismiss ≥5s + pause-on-hover; never errors-only-here |\n| **Tabs** | tablist, tab, indicator, tabpanel | rest\u002Fhover\u002F**selected**\u002Ffocus-visible\u002Fdisabled | `role=tablist\u002Ftab\u002Ftabpanel`; arrows move, `aria-selected`; manual vs automatic activation |\n| **Accordion** | item, header(button), content | collapsed\u002F**expanded**\u002Ffocus-visible\u002Fdisabled | header is a `\u003Cbutton aria-expanded>`; `data-state=open\u002Fclosed`; animate `grid-template-rows:0fr→1fr` |\n| **Menu \u002F Dropdown** | trigger, content, item, separator, sub-trigger | closed\u002Fopen\u002Fitem hover\u002Ffocus\u002Fdisabled\u002Fchecked | `role=menu\u002Fmenuitem`; ↑↓ wrap, typeahead, `Esc`, roving tabindex |\n| **Breadcrumb** | `\u003Cnav aria-label>`, ol, item, separator, current | links; **current**(not a link) | `aria-current=\"page\"` on last; separators decorative\u002F`aria-hidden` |\n| **Pagination** | prev, page numbers, ellipsis, next | rest\u002Fhover\u002F**current**\u002Fdisabled(ends) | `\u003Cnav aria-label=\"Pagination\">`; current → `aria-current=\"page\"` |\n| **Table** | table, thead, th(sortable), tbody, row, cell | row hover\u002Fselected; col sort asc\u002Fdesc; loading(skeleton rows)\u002Fempty | `\u003Cth scope>`; sortable th → button + `aria-sort`; caption; sticky header |\n| **List** | list, item, leading, content, trailing, dividers | item rest\u002Fhover\u002Fselected\u002Fdisabled; loading\u002Fempty | `\u003Cul>\u002F\u003Col>`; selectable → `role=listbox\u002Foption` or `aria-selected` |\n| **Nav (top\u002Fside\u002Fbottom)** | nav, items, current, icon+label | item rest\u002Fhover\u002F**current\u002Factive**\u002Ffocus-visible | `\u003Cnav aria-label>`; current → `aria-current=\"page\"`; bottom-nav ≥48dp targets |\n| **Search** | wrapper, leading glass, input, clear, results\u002Fsuggest | empty\u002Ftyping\u002Floading\u002Fresults\u002F**no-results**\u002Fclear | `role=searchbox` or `type=search`; debounce; announce result count via live region |\n| **Segmented control** | track, segment, indicator | rest\u002Fhover\u002F**selected**\u002Ffocus-visible\u002Fdisabled | radiogroup semantics; arrows move; one selected always |\n| **Progress \u002F Spinner** | track, fill OR rotating arc | determinate(0–100)\u002Findeterminate | `role=progressbar` `aria-valuenow`; spinner → `aria-label=\"Loading\"`; respect reduced-motion |\n| **Skeleton** | shimmer blocks matching final layout | loading only | `aria-hidden=true` + parent `aria-busy`; match real content dimensions to avoid layout shift |\n\n## 5. Sizing tokens\n\n| Token group | Values | Notes |\n|---|---|---|\n| Control heights | 32 \u002F 40 \u002F 48 (px) | sm\u002Fmd\u002Flg; some systems add 24 (xs) \u002F 56 (xl) |\n| **Touch target min** | **44×44px (iOS HIG)**, **48×48dp (Android Material)** | even if visual is smaller, pad the hit area |\n| Padding scale | 4 \u002F 8 \u002F 12 \u002F 16 \u002F 20 \u002F 24 | `--space-*`; inline padding ≈ height × 0.4 |\n| Icon sizes | 16 \u002F 20 \u002F 24 (px) | pair with sm\u002Fmd\u002Flg control |\n| Radius scale | 0 \u002F 2 \u002F 4 \u002F 6 \u002F 8 \u002F 12 \u002F 9999 | 9999 = pill; keep ≤3 in active use |\n| Border | 1px (hairline), 2px (focus ring) | ring offset 2px |\n\nTouch targets are non-negotiable on mobile: a 24px icon-button needs invisible padding to reach 44\u002F48. Spacing between adjacent targets ≥8px.\n\n## 6. States in code — attributes & theming\n\nDrive styling off semantic attributes, not class soup:\n\n```html\n\u003Cbutton data-state=\"loading\" aria-busy=\"true\" disabled>…\u003C\u002Fbutton>\n\u003Cdiv role=\"tab\" aria-selected=\"true\" data-state=\"active\" tabindex=\"0\">…\u003C\u002Fdiv>\n\u003Cdiv class=\"field\" data-invalid>\n  \u003Cinput aria-invalid=\"true\" aria-describedby=\"email-err\" \u002F>\n  \u003Cp id=\"email-err\" role=\"alert\">Enter a valid email.\u003C\u002Fp>\n\u003C\u002Fdiv>\n```\n\n```css\n\u002F* Per-component theming via CSS custom properties — override anywhere up the tree *\u002F\n.field {\n  --field-border: var(--gray-7);\n  --field-ring: var(--accent-8);\n}\n.field:has(:focus-visible) { box-shadow: 0 0 0 2px var(--field-ring); }\n.field:has([aria-invalid=\"true\"]),\n.field[data-invalid]       { --field-border: var(--red-8); }\n.field input               { border: 1px solid var(--field-border); }\n@media (prefers-reduced-motion: reduce) {\n  * { animation-duration: .01ms !important; transition-duration: .01ms !important; }\n}\n```\n\n`data-state` (open\u002Fclosed\u002Factive\u002Floading) reads cleanly, is what Radix\u002FARK emit, and survives SSR. Reserve ARIA for *semantics the AT needs* (`aria-busy`, `aria-invalid`, `aria-expanded`), not for styling hooks you could express with `data-*`.\n\n## 7. Density, RTL, theming, composition, control model\n\n- **Density modes:** a single `--density` knob scaling heights\u002Fpadding (comfortable 40 \u002F compact 32 \u002F spacious 48). Drive via `data-density` on root → recompute token sizes. Don't shrink touch targets below platform minimums in compact mode on touch devices.\n- **RTL:** use **logical properties** everywhere (`margin-inline-start`, `padding-block`, `inset-inline-start`, `text-align: start`). Set `dir=\"rtl\"`; mirror directional icons (chevrons, back arrows) but not literal ones (clock, logos). `:dir(rtl)` selector for the rest.\n- **Theming hooks:** token layers — primitive (`--blue-500`) → semantic (`--accent-9`, `--fg`, `--bg`) → component (`--btn-bg`). Theme by reassigning semantic tokens (`[data-theme=dark]`). Support `color-scheme` + `prefers-color-scheme`. Never hardcode hex in a component.\n- **Composition over config:** prefer `\u003CCard>\u003CCard.Header\u002F>\u003CCard.Body\u002F>\u003C\u002FCard>` slots over a 20-prop `\u003CCard title subtitle media footer …\u002F>`. Slots scale; config props don't (rule of 3 before adding a prop).\n- **Controlled vs uncontrolled:** support both. Uncontrolled (internal state, `defaultValue`) for simple cases; controlled (`value` + `onChange`) when the parent owns truth. Pattern: `value ?? internalState`. Document which props make it controlled. Never silently switch a component between the two.\n\n## 8. Cross-platform component equivalences\n\n| Concept | Web | iOS (UIKit \u002F SwiftUI) | Android (Material 3) | Desktop |\n|---|---|---|---|---|\n| Button | `\u003Cbutton>` | `UIButton` \u002F `Button` | `Button` \u002F `FilledButton` | native button widget |\n| Switch | `role=switch` | `UISwitch` \u002F `Toggle` | `Switch` | toggle\u002Fcheckbox |\n| Select | `\u003Cselect>`\u002Fcombobox | `UIPickerView` \u002F `Picker` | `ExposedDropdownMenu` | `\u003Cselect>` \u002F NSPopUpButton |\n| Slider | `\u003Cinput type=range>` | `UISlider` \u002F `Slider` | `Slider` | native slider |\n| Modal | `\u003Cdialog>`\u002Frole=dialog | sheet \u002F `.sheet` | `Dialog` \u002F `ModalBottomSheet` | window\u002Fdialog |\n| Drawer\u002FSheet | role=dialog sheet | bottom sheet \u002F `.sheet` | `ModalBottomSheet` | side panel |\n| Toast | role=status | no native (build) | `Snackbar` | system notification |\n| Tabs | role=tablist | `UITabBar`(bottom) \u002F `TabView` | `TabRow` (top) | tab strip |\n| Segmented | radiogroup | `UISegmentedControl` \u002F `Picker(.segmented)` | `SegmentedButton` | segmented control |\n| Nav (primary) | top\u002Fside `\u003Cnav>` | bottom `UITabBar` | bottom `NavigationBar` \u002F rail | side menu \u002F titlebar |\n\nPlatform conventions differ: iOS puts primary nav at the **bottom tab bar**; Material uses **bottom navigation** (≤5 items) or a **nav rail\u002Fdrawer**; web is flexible (top or side). Respect each platform's default control rather than porting web pixel-for-pixel. Map *intent* to native components; don't reskin a web button to look iOS-native — use the platform control.\n\n## 9. Common mistakes (do \u002F don't)\n\n| Don't | Do |\n|---|---|\n| Strip `outline` \u002F only style `:focus` | Use `:focus-visible` with a 2px, 3:1-contrast ring + offset |\n| Disable a button with no explanation | Show *why* (inline error, tooltip on a wrapper) or keep enabled + validate on submit |\n| Convey state by **color alone** | Pair color with icon + text (error icon + message; status label) |\n| Hover-only affordances (desktop-only reveal) | Make actions reachable by keyboard + touch; hover is enhancement |\n| Skip loading \u002F empty \u002F error states | Design all four: rest, loading (skeleton\u002Fspinner), empty, error — every data view |\n| Width jumps when label → spinner | Reserve width; swap label visibility, keep box size |\n| `\u003Cdiv onClick>` everywhere (div soup) | Semantic `\u003Cbutton>\u002F\u003Ca>\u002F\u003Cinput>` — free a11y, focus, keyboard |\n| Placeholder as the label | Real `\u003Clabel>`; placeholder is a hint, disappears on type |\n| Per-component ad-hoc sizes | One shared size scale (sm\u002Fmd\u002Flg) across all controls |\n| Tooltip holding the only copy of info | Tooltips supplement; critical info lives in the DOM |\n| `!important` to win specificity | `:where()` for zero-specificity base, let app layers override |\n| Animate with no `prefers-reduced-motion` guard | Wrap motion; provide reduced\u002Finstant fallback |\n| `aria-*` to fake a native control | Use the native element; add ARIA only when HTML can't express it |\n| One Tab stop per radio\u002Fmenu item | Roving tabindex: group is one stop, arrows move within |\n\n**Checklist before \"component done\":** anatomy named · all §2 states defined incl. combined · focus-visible ring · disabled has a reason · loading\u002Fempty\u002Ferror exist · touch target ≥44\u002F48 · keyboard-operable · labelled for AT · sizes from the scale · RTL via logical props · reduced-motion honored · controlled+uncontrolled supported.\n","# Components, Variants & States\n\nA component is a contract: a stable **anatomy** (named parts), an **API** (props\u002Fslots), and a complete **state matrix**. Ship all three or you ship a liability. The #1 source of \"feels broken\" UI is missing states — not missing features.\n\n## 1. Component anatomy — the parts model\n\nEvery component decomposes into named parts. Name them; style each part independently; expose them as slots. Headless libraries (Radix, ARK, React Aria) formalize this as `Root`, `Trigger`, `Content`, `Item`, etc.\n\n```\n┌─ Container (Root) ──────────────────────────────┐\n│  [leading slot]  Label \u002F Value  [trailing slot] │\n│                  Helper \u002F Description text       │\n└─────────────────────────────────────────────────┘\n```\n\n| Part | Role | Example |\n|---|---|---|\n| **Container \u002F Root** | Bounding box, owns padding\u002Fradius\u002Fborder, carries `data-state` | the `\u003Cbutton>`, the field wrapper |\n| **Leading** | Icon, avatar, prefix, adornment | search glass in input |\n| **Label** | Primary text, the accessible name | \"Save changes\" |\n| **Value \u002F Content** | Live content | input text, selected option |\n| **Trailing** | Action, chevron, clear, counter, status | clear-X, dropdown caret |\n| **Helper \u002F Description** | Secondary text below | \"We'll never share this\" |\n| **Error \u002F Validation** | Replaces helper when invalid | \"Email is required\" |\n\n**Rule:** A slot accepts arbitrary children (composition); a prop configures a fixed dimension (config). Prefer slots for content, props for behavior\u002Fappearance. See §9.\n\n## 2. The interaction state matrix (define + treat EVERY one)\n\nThis is the heart of the skill. Each state needs a defined **visual treatment** and **a11y signal**. Use `data-state` attributes (set by headless libs or your own code) + native pseudo-classes.\n\n| State | When | Visual treatment | Signal |\n|---|---|---|---|\n| **default \u002F rest** | idle, interactive | base bg\u002Fborder\u002Ftext; sufficient affordance to look clickable | — |\n| **hover** | pointer over (pointer devices only) | subtle bg\u002Felevation\u002Funderline shift; never the *only* affordance | `:hover` |\n| **focus** | element focused (any input) | — (avoid showing for mouse) | `:focus` |\n| **focus-visible** | focused via keyboard | **2px visible ring, 2px offset, ≥3:1 contrast** | `:focus-visible` |\n| **active \u002F pressed** | pointer\u002Fkey down | darken\u002Fscale 0.97\u002Finset shadow; ~instant | `:active`, `[data-state=active]` |\n| **selected \u002F checked** | chosen in a set | filled\u002Faccent bg, check glyph, bold | `[aria-selected]`, `[aria-checked]`, `:checked` |\n| **disabled** | not interactive *and reason exists* | 38–50% opacity OR muted token; `cursor:not-allowed`; **no hover** | `:disabled`, `[aria-disabled]` |\n| **loading \u002F busy** | async in flight | spinner replaces\u002Fjoins label, keep width stable, lock interaction | `[aria-busy=true]`, `[data-state=loading]` |\n| **error \u002F invalid** | failed validation | danger border + helper→error text + icon (not color alone) | `[aria-invalid=true]` |\n| **read-only** | viewable, not editable, still focusable\u002Fcopyable | muted bg, normal text, no edit caret | `[readonly]`, `aria-readonly` |\n| **expanded \u002F open** | disclosure open | rotated chevron, revealed panel | `[aria-expanded=true]`, `[data-state=open]` |\n| **dragging** | being dragged | raised elevation, 0.8 opacity, grabbing cursor, placeholder gap | `[data-dragging]`, `[aria-grabbed]` |\n| **indeterminate** | partial (tri-state checkbox) | dash glyph | `:indeterminate` |\n| **placeholder \u002F empty** | no value yet | muted placeholder text (not a label substitute) | — |\n\n**Combined states** are real: `hover + selected`, `focus-visible + invalid`, `loading + disabled`. Test them. **Precedence** (highest wins): `disabled` > `loading` > `error` > `selected\u002Factive` > `focus-visible` > `hover` > `rest`. A disabled element shows no hover and no error styling change on pointer.\n\n```css\n\u002F* Modern state-driven button — pseudo-classes + data-state + tokens *\u002F\n.btn {\n  --btn-bg: var(--accent-9);\n  --btn-fg: white;\n  display: inline-flex; align-items: center; gap: var(--space-2);\n  block-size: var(--control-h-md); padding-inline: var(--space-4);\n  border-radius: var(--radius-2); border: 1px solid transparent;\n  background: var(--btn-bg); color: var(--btn-fg);\n  font: inherit; cursor: pointer;\n  transition: background .12s, box-shadow .12s, transform .04s;\n}\n.btn:where(:hover)            { --btn-bg: var(--accent-10); }\n.btn:active                   { transform: translateY(.5px) scale(.99); }\n.btn:focus-visible            { outline: 2px solid var(--focus-ring); outline-offset: 2px; }\n.btn:disabled,\n.btn[aria-disabled=\"true\"]    { opacity: .5; cursor: not-allowed; }\n.btn[aria-busy=\"true\"]        { pointer-events: none; }\n.btn[data-state=\"loading\"] .btn__label { visibility: hidden; }\n\u002F* :where() keeps specificity 0 so app overrides win without !important *\u002F\n```\n\nUse `:is()`\u002F`:where()` to group selectors, and `:has()` for parent-aware styling (`.field:has(:invalid)` lights the whole field). Prefer `:focus-visible` over `:focus` — never strip the ring without replacing it.\n\n## 3. Variants vs sizes vs states vs shape\n\nKeep these axes **orthogonal**. A button is `variant × size × state`, not 30 hand-named classes.\n\n- **Semantic variants** (intent\u002Femphasis): `primary` (one per view), `secondary`, `tertiary`, `ghost` (transparent until hover), `outline`, `danger`\u002Fdestructive, `link`. Map to *meaning*, not color — themes reskin them.\n- **Sizes** (one scale, shared across controls):\n\n| Size | Height | Padding-X | Font | Icon | Radius |\n|---|---|---|---|---|---|\n| `sm` | 32px | 12px | 13–14px | 16px | 6px |\n| `md` | 40px | 16px | 14–16px | 20px | 8px |\n| `lg` | 48px | 20px | 16–18px | 24px | 10px |\n\n- **Shape**: `rounded` (default), `pill` (`border-radius: 9999px`), `square` (icon-only). Shape ≠ size.\n- **States**: §2 — runtime, never a variant.\n\n**Props API design:** `variant`, `size`, `shape`, plus boolean state-ish props (`disabled`, `loading`, `selected`). Booleans use `is\u002Fhas\u002Fcan\u002Fshould`. Avoid boolean explosion (`isPrimary isSecondary…`) — use one `variant` union. Validate at the boundary (Zod \u002F TS union). Slots (`leadingIcon`, `children`, `trailingIcon`) over a dozen content props.\n\n## 4. Core components — anatomy · states · a11y\n\n| Component | Key parts | States that MUST exist | a11y essentials |\n|---|---|---|---|\n| **Button** | container, leading, label, trailing | rest\u002Fhover\u002Ffocus-visible\u002Factive\u002Fdisabled\u002F**loading** | `\u003Cbutton type>`; loading→`aria-busy`; icon-only→`aria-label` |\n| **Icon-button** | square container, icon | + tooltip on hover\u002Ffocus | `aria-label` required; min 40×40 hit area |\n| **Input \u002F Textarea** | wrapper, label, leading, field, trailing, helper\u002Ferror | rest\u002Fhover\u002Ffocus\u002Ffilled\u002F**invalid**\u002Fdisabled\u002Fread-only | real `\u003Clabel for>`; `aria-invalid`+`aria-describedby`→error id; textarea: `field-sizing:content` |\n| **Select \u002F Combobox** | trigger(value+chevron), listbox, option, group | closed\u002F**open**\u002Foption hover\u002F**selected**\u002Fdisabled\u002Floading\u002Fempty | `role=combobox` `aria-expanded`; typeahead; ↑↓\u002FHome\u002FEnd\u002FEsc; selected→`aria-selected` |\n| **Checkbox \u002F Radio** | control box, check\u002Fdot, label | unchecked\u002Fchecked\u002F**indeterminate**(cb)\u002Ffocus-visible\u002Fdisabled\u002Finvalid | native input + styled box; radio = one Tab stop, arrows move; label clickable |\n| **Switch \u002F Toggle** | track, thumb, label | off\u002Fon\u002Ffocus-visible\u002Fdisabled\u002Floading | `role=switch` `aria-checked`; instant + animated thumb |\n| **Slider** | track, range fill, thumb(s), ticks | rest\u002Fhover\u002Fdragging\u002Ffocus-visible\u002Fdisabled | `role=slider` `aria-valuemin\u002Fmax\u002Fnow`; arrows ±step, PageUp\u002FDown ±10% |\n| **Card** | container, media, header, body, footer, actions | rest; if interactive → hover\u002Ffocus-visible\u002Factive\u002Fselected | whole-card link → one focusable; don't nest interactives without care |\n| **Badge \u002F Chip \u002F Tag** | container, leading dot\u002Ficon, label, (removable) ✕ | static; chip adds selected\u002Fdisabled\u002Fremovable | removable ✕ → own `aria-label`; status by icon+text, not color alone |\n| **Avatar** | image, fallback initials\u002Ficon, status dot | loaded\u002F**fallback(error)**\u002Floading | `alt` = name or `\"\"` if decorative; status dot needs text equivalent |\n| **Tooltip** | trigger, content, arrow | hidden\u002F**open** | hover *and* focus; `aria-describedby`; never the only place info lives; not for interactive content |\n| **Popover** | trigger, content, arrow | closed\u002Fopen | focus moves in, `Esc` closes, returns focus; `aria-expanded` |\n| **Modal \u002F Dialog** | overlay, container, header(title+close), body, footer | closed\u002Fopen\u002Floading | `role=dialog` `aria-modal`, labelled by title; **focus trap**; `Esc`; scroll-lock; restore focus |\n| **Drawer \u002F Sheet** | scrim, panel, handle | closed\u002Fopen\u002Fdragging(swipe) | same as dialog; edge-swipe on mobile; respects safe-area insets |\n| **Toast \u002F Snackbar** | container, icon, message, action, dismiss | enter\u002Fvisible\u002Fexit; queued | `role=status`(polite)\u002F`role=alert`(assertive); auto-dismiss ≥5s + pause-on-hover; never errors-only-here |\n| **Tabs** | tablist, tab, indicator, tabpanel | rest\u002Fhover\u002F**selected**\u002Ffocus-visible\u002Fdisabled | `role=tablist\u002Ftab\u002Ftabpanel`; arrows move, `aria-selected`; manual vs automatic activation |\n| **Accordion** | item, header(button), content | collapsed\u002F**expanded**\u002Ffocus-visible\u002Fdisabled | header is a `\u003Cbutton aria-expanded>`; `data-state=open\u002Fclosed`; animate `grid-template-rows:0fr→1fr` |\n| **Menu \u002F Dropdown** | trigger, content, item, separator, sub-trigger | closed\u002Fopen\u002Fitem hover\u002Ffocus\u002Fdisabled\u002Fchecked | `role=menu\u002Fmenuitem`; ↑↓ wrap, typeahead, `Esc`, roving tabindex |\n| **Breadcrumb** | `\u003Cnav aria-label>`, ol, item, separator, current | links; **current**(not a link) | `aria-current=\"page\"` on last; separators decorative\u002F`aria-hidden` |\n| **Pagination** | prev, page numbers, ellipsis, next | rest\u002Fhover\u002F**current**\u002Fdisabled(ends) | `\u003Cnav aria-label=\"Pagination\">`; current → `aria-current=\"page\"` |\n| **Table** | table, thead, th(sortable), tbody, row, cell | row hover\u002Fselected; col sort asc\u002Fdesc; loading(skeleton rows)\u002Fempty | `\u003Cth scope>`; sortable th → button + `aria-sort`; caption; sticky header |\n| **List** | list, item, leading, content, trailing, dividers | item rest\u002Fhover\u002Fselected\u002Fdisabled; loading\u002Fempty | `\u003Cul>\u002F\u003Col>`; selectable → `role=listbox\u002Foption` or `aria-selected` |\n| **Nav (top\u002Fside\u002Fbottom)** | nav, items, current, icon+label | item rest\u002Fhover\u002F**current\u002Factive**\u002Ffocus-visible | `\u003Cnav aria-label>`; current → `aria-current=\"page\"`; bottom-nav ≥48dp targets |\n| **Search** | wrapper, leading glass, input, clear, results\u002Fsuggest | empty\u002Ftyping\u002Floading\u002Fresults\u002F**no-results**\u002Fclear | `role=searchbox` or `type=search`; debounce; announce result count via live region |\n| **Segmented control** | track, segment, indicator | rest\u002Fhover\u002F**selected**\u002Ffocus-visible\u002Fdisabled | radiogroup semantics; arrows move; one selected always |\n| **Progress \u002F Spinner** | track, fill OR rotating arc | determinate(0–100)\u002Findeterminate | `role=progressbar` `aria-valuenow`; spinner → `aria-label=\"Loading\"`; respect reduced-motion |\n| **Skeleton** | shimmer blocks matching final layout | loading only | `aria-hidden=true` + parent `aria-busy`; match real content dimensions to avoid layout shift |\n\n## 5. Sizing tokens\n\n| Token group | Values | Notes |\n|---|---|---|\n| Control heights | 32 \u002F 40 \u002F 48 (px) | sm\u002Fmd\u002Flg; some systems add 24 (xs) \u002F 56 (xl) |\n| **Touch target min** | **44×44px (iOS HIG)**, **48×48dp (Android Material)** | even if visual is smaller, pad the hit area |\n| Padding scale | 4 \u002F 8 \u002F 12 \u002F 16 \u002F 20 \u002F 24 | `--space-*`; inline padding ≈ height × 0.4 |\n| Icon sizes | 16 \u002F 20 \u002F 24 (px) | pair with sm\u002Fmd\u002Flg control |\n| Radius scale | 0 \u002F 2 \u002F 4 \u002F 6 \u002F 8 \u002F 12 \u002F 9999 | 9999 = pill; keep ≤3 in active use |\n| Border | 1px (hairline), 2px (focus ring) | ring offset 2px |\n\nTouch targets are non-negotiable on mobile: a 24px icon-button needs invisible padding to reach 44\u002F48. Spacing between adjacent targets ≥8px.\n\n## 6. States in code — attributes & theming\n\nDrive styling off semantic attributes, not class soup:\n\n```html\n\u003Cbutton data-state=\"loading\" aria-busy=\"true\" disabled>…\u003C\u002Fbutton>\n\u003Cdiv role=\"tab\" aria-selected=\"true\" data-state=\"active\" tabindex=\"0\">…\u003C\u002Fdiv>\n\u003Cdiv class=\"field\" data-invalid>\n  \u003Cinput aria-invalid=\"true\" aria-describedby=\"email-err\" \u002F>\n  \u003Cp id=\"email-err\" role=\"alert\">Enter a valid email.\u003C\u002Fp>\n\u003C\u002Fdiv>\n```\n\n```css\n\u002F* Per-component theming via CSS custom properties — override anywhere up the tree *\u002F\n.field {\n  --field-border: var(--gray-7);\n  --field-ring: var(--accent-8);\n}\n.field:has(:focus-visible) { box-shadow: 0 0 0 2px var(--field-ring); }\n.field:has([aria-invalid=\"true\"]),\n.field[data-invalid]       { --field-border: var(--red-8); }\n.field input               { border: 1px solid var(--field-border); }\n@media (prefers-reduced-motion: reduce) {\n  * { animation-duration: .01ms !important; transition-duration: .01ms !important; }\n}\n```\n\n`data-state` (open\u002Fclosed\u002Factive\u002Floading) reads cleanly, is what Radix\u002FARK emit, and survives SSR. Reserve ARIA for *semantics the AT needs* (`aria-busy`, `aria-invalid`, `aria-expanded`), not for styling hooks you could express with `data-*`.\n\n## 7. Density, RTL, theming, composition, control model\n\n- **Density modes:** a single `--density` knob scaling heights\u002Fpadding (comfortable 40 \u002F compact 32 \u002F spacious 48). Drive via `data-density` on root → recompute token sizes. Don't shrink touch targets below platform minimums in compact mode on touch devices.\n- **RTL:** use **logical properties** everywhere (`margin-inline-start`, `padding-block`, `inset-inline-start`, `text-align: start`). Set `dir=\"rtl\"`; mirror directional icons (chevrons, back arrows) but not literal ones (clock, logos). `:dir(rtl)` selector for the rest.\n- **Theming hooks:** token layers — primitive (`--blue-500`) → semantic (`--accent-9`, `--fg`, `--bg`) → component (`--btn-bg`). Theme by reassigning semantic tokens (`[data-theme=dark]`). Support `color-scheme` + `prefers-color-scheme`. Never hardcode hex in a component.\n- **Composition over config:** prefer `\u003CCard>\u003CCard.Header\u002F>\u003CCard.Body\u002F>\u003C\u002FCard>` slots over a 20-prop `\u003CCard title subtitle media footer …\u002F>`. Slots scale; config props don't (rule of 3 before adding a prop).\n- **Controlled vs uncontrolled:** support both. Uncontrolled (internal state, `defaultValue`) for simple cases; controlled (`value` + `onChange`) when the parent owns truth. Pattern: `value ?? internalState`. Document which props make it controlled. Never silently switch a component between the two.\n\n## 8. Cross-platform component equivalences\n\n| Concept | Web | iOS (UIKit \u002F SwiftUI) | Android (Material 3) | Desktop |\n|---|---|---|---|---|\n| Button | `\u003Cbutton>` | `UIButton` \u002F `Button` | `Button` \u002F `FilledButton` | native button widget |\n| Switch | `role=switch` | `UISwitch` \u002F `Toggle` | `Switch` | toggle\u002Fcheckbox |\n| Select | `\u003Cselect>`\u002Fcombobox | `UIPickerView` \u002F `Picker` | `ExposedDropdownMenu` | `\u003Cselect>` \u002F NSPopUpButton |\n| Slider | `\u003Cinput type=range>` | `UISlider` \u002F `Slider` | `Slider` | native slider |\n| Modal | `\u003Cdialog>`\u002Frole=dialog | sheet \u002F `.sheet` | `Dialog` \u002F `ModalBottomSheet` | window\u002Fdialog |\n| Drawer\u002FSheet | role=dialog sheet | bottom sheet \u002F `.sheet` | `ModalBottomSheet` | side panel |\n| Toast | role=status | no native (build) | `Snackbar` | system notification |\n| Tabs | role=tablist | `UITabBar`(bottom) \u002F `TabView` | `TabRow` (top) | tab strip |\n| Segmented | radiogroup | `UISegmentedControl` \u002F `Picker(.segmented)` | `SegmentedButton` | segmented control |\n| Nav (primary) | top\u002Fside `\u003Cnav>` | bottom `UITabBar` | bottom `NavigationBar` \u002F rail | side menu \u002F titlebar |\n\nPlatform conventions differ: iOS puts primary nav at the **bottom tab bar**; Material uses **bottom navigation** (≤5 items) or a **nav rail\u002Fdrawer**; web is flexible (top or side). Respect each platform's default control rather than porting web pixel-for-pixel. Map *intent* to native components; don't reskin a web button to look iOS-native — use the platform control.\n\n## 9. Common mistakes (do \u002F don't)\n\n| Don't | Do |\n|---|---|\n| Strip `outline` \u002F only style `:focus` | Use `:focus-visible` with a 2px, 3:1-contrast ring + offset |\n| Disable a button with no explanation | Show *why* (inline error, tooltip on a wrapper) or keep enabled + validate on submit |\n| Convey state by **color alone** | Pair color with icon + text (error icon + message; status label) |\n| Hover-only affordances (desktop-only reveal) | Make actions reachable by keyboard + touch; hover is enhancement |\n| Skip loading \u002F empty \u002F error states | Design all four: rest, loading (skeleton\u002Fspinner), empty, error — every data view |\n| Width jumps when label → spinner | Reserve width; swap label visibility, keep box size |\n| `\u003Cdiv onClick>` everywhere (div soup) | Semantic `\u003Cbutton>\u002F\u003Ca>\u002F\u003Cinput>` — free a11y, focus, keyboard |\n| Placeholder as the label | Real `\u003Clabel>`; placeholder is a hint, disappears on type |\n| Per-component ad-hoc sizes | One shared size scale (sm\u002Fmd\u002Flg) across all controls |\n| Tooltip holding the only copy of info | Tooltips supplement; critical info lives in the DOM |\n| `!important` to win specificity | `:where()` for zero-specificity base, let app layers override |\n| Animate with no `prefers-reduced-motion` guard | Wrap motion; provide reduced\u002Finstant fallback |\n| `aria-*` to fake a native control | Use the native element; add ARIA only when HTML can't express it |\n| One Tab stop per radio\u002Fmenu item | Roving tabindex: group is one stop, arrows move within |\n\n**Checklist before \"component done\":** anatomy named · all §2 states defined incl. combined · focus-visible ring · disabled has a reason · loading\u002Fempty\u002Ferror exist · touch target ≥44\u002F48 · keyboard-operable · labelled for AT · sizes from the scale · RTL via logical props · reduced-motion honored · controlled+uncontrolled supported.\n",{"name":5,"tags":23,"description":7},[24,25,26,27,28],"design-systems","components","states","variants","patterns","main","4911ae44bbb35beef4511ba298475ba5a82b7e1c","design-system-skills\u002Fcomponents-and-states",0,"https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta","https:\u002F\u002Fdocs.vanta.theft.studio","https:\u002F\u002Fgithub.com\u002Fjpoindexter","jason.theft.studio","Just some guy trying to build stuff","2026-11-12 17:11:35",{"source":8,"skillName":5,"commands":40,"prompt":50,"zipAvailable":51},[41,44,47],{"tool":42,"command":43},"npx","npx skills add jpoindexter\u002FVanta --skill components-and-states",{"tool":45,"command":46},"bunx","bunx skills add jpoindexter\u002FVanta --skill components-and-states",{"tool":48,"command":49},"pnpm","pnpm dlx skills add jpoindexter\u002FVanta --skill components-and-states","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fdesign-system-skills\u002Fcomponents-and-states\u002FSKILL.md",true,[],[54,61,68,75,82,88],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":18},"01M7582PEM7XM8B98VFRDV0C0J","write-changelog","Turn a range of commits into a user-facing changelog","https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fvanta-ts\u002Fsrc\u002Fmigrate\u002F__fixtures__\u002Fopenclaw\u002Fskills\u002Fwrite-changelog\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7582KTQJMP5Y7GS83MS1C7Z","debug-flaky-test","Reproduce and isolate a flaky test before fixing it","https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fvanta-ts\u002Fsrc\u002Fmigrate\u002F__fixtures__\u002Fopenclaw\u002Fskills\u002Fdebug-flaky-test\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M7582HG7XFM4Z5NGG1YFECT8","triage-incident","First 10 minutes of an incident — stabilize, then diagnose","https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fvanta-ts\u002Fsrc\u002Fmigrate\u002F__fixtures__\u002Fhermes\u002Fskills\u002Ftriage-incident\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M7582DQABK7A96XHMB770KQZ","writing-plans","Write implementation plans: bite-sized tasks, paths, code.","https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fvanta-ts\u002Fskills-library\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":18},"01M7582BBK8H0HGSXKK08FCXJ1","vanta-port-adapter","https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fvanta-ts\u002Fskills-library\u002Fvanta-port-adapter\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":18},"01M75828P8PX5XSBMJ2BVVDA9Y","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002Fjpoindexter\u002FVanta\u002Fblob\u002Fmain\u002Fvanta-ts\u002Fskills-library\u002Ftest-driven-development\u002FSKILL.md",[],[]]