[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ANNMA0KT8HNVMH2G7SA7V3":3,"skill-same:01M7ANNMA0KT8HNVMH2G7SA7V3":48},{"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":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7ANNMA0KT8HNVMH2G7SA7V3","graphic-ux-ui-design",null,"Comprehensive UX\u002FUI and graphic design reference covering visual design fundamentals (color systems, typography, dark mode, layout), component and interaction patterns (navigation, forms, buttons, modals, loading states), accessibility standards (WCAG 2.2, APCA, screen readers), UX research methods, and design systems (token architecture, Atomic Design, governance, versioning). Use when designing interfaces, auditing accessibility, building or evaluating design systems, choosing component patterns, or applying evidence-based UX decisions.","the-vibey-project\u002Fvibey","the-vibey-project","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F329298758?v=4","01M7AJHGZ9722CTJ4JNQZVRH0Q","the vibey project","01M7AJHGZVMG2K7TGXQ6XFHVG3",5,"MIT","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Ffrontend-design\u002Fskills\u002Fgraphic-ux-ui-design\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: graphic-ux-ui-design\ndescription: \"Comprehensive UX\u002FUI and graphic design reference covering visual design fundamentals (color systems, typography, dark mode, layout), component and interaction patterns (navigation, forms, buttons, modals, loading states), accessibility standards (WCAG 2.2, APCA, screen readers), UX research methods, and design systems (token architecture, Atomic Design, governance, versioning). Use when designing interfaces, auditing accessibility, building or evaluating design systems, choosing component patterns, or applying evidence-based UX decisions.\"\n---\n\n# Graphic UX\u002FUI Design: Practitioner's Reference\n\n## Evidence Summary\n\nMost \"best practices\" are context rules. The strongest, most replicated findings (top-aligned labels, 50–75ch line length, dark-grey dark mode, skeleton screens for content loading, \"Load More\" over infinite scroll for goal-driven tasks, semantic HTML before ARIA) hold across platforms. Density, motion, and navigation choices depend on whether you serve consumers or power users. Accessibility is the single biggest gap between rhetoric and reality: WebAIM's 2026 scan found 83.9% of top 1M home pages have low-contrast text (up from 79.1% in 2025), 56.1 errors\u002Fpage. The fixes are trivial and known — they simply aren't implemented.\n\n---\n\n## Visual Design Fundamentals\n\n### Color Systems\n\nProduction color architecture uses three token tiers:\n- **Primitive tokens**: raw values — `blue-500: #3B82F6`\n- **Semantic tokens**: intent — `color-action-primary`, `color-text-primary`, `color-status-error`\n- **Component tokens**: scoped — `button-bg-primary`\n\nApplications consume semantic tokens, not primitives. Theming and dark mode become a matter of re-pointing semantic tokens, not editing components. Neutral scales (9–12 steps) carry most of the surface area.\n\n### WCAG Contrast Requirements\n\n| Level | Normal text | Large text (≥24px or 18.7px bold) | Non-text UI |\n|-------|-------------|-----------------------------------|-------------|\n| AA    | 4.5:1       | 3:1                               | 3:1         |\n| AAA   | 7:1         | 4.5:1                             | —           |\n\nGlobal regulations (Section 508, EN 301 549, AODA) target AA. AAA is aspirational and not always achievable. Low-contrast text is the #1 accessibility defect for seven straight years. **Do not wait for WCAG 3\u002FAPCA to be final** — keep conforming to WCAG 2.x AA for compliance; use APCA as a supplementary check (especially for dark themes); never claim \"WCAG 3 compliance\" (it doesn't exist yet as of 2026).\n\n### Oklch and Wide-Gamut Color\n\nCSS Color Level 4 (`oklch()`, `oklab()`, `color(display-p3)`) is Baseline Widely Available (Chrome\u002FEdge 111+, Firefox 113+, Safari 15.4+).\n\nWhy oklch matters:\n1. **Perceptual uniformity** — a fixed change in L looks equally different across hues; HSL does not have this property. Use it to generate consistent tint\u002Fshade scales programmatically.\n2. **Wide gamut** — Display P3 covers ~50% more colors than sRGB. Every iPhone since 7, every MacBook since 2016 supports it.\n\nAlways declare sRGB hex fallbacks first for old browsers.\n\n### Dark Mode\n\n**Never use pure black (#000000).** Material Design recommends #121212 as the base dark surface — pure black causes halation\u002Fblooming and disables shadows.\n\nExpress elevation through lightness, not shadow:\n\n| Layer       | Approximate L% |\n|-------------|----------------|\n| Base        | 10–12%         |\n| Sidebars    | 14–16%         |\n| Cards       | 17–20%         |\n| Modals      | 22–26%         |\n| Popovers    | 26–30%         |\n\nKeep ~3–5 points between each level. Desaturate accent colors (they vibrate against dark surfaces). Use off-white (~#E1E1E1 or white at 87% opacity) rather than pure white text. A naive light-palette inversion fails — light and dark modes have asymmetric perceptual requirements. Always let users toggle; don't force it.\n\n### Typography\n\n| Guideline             | Value                     |\n|-----------------------|---------------------------|\n| Optimal line length   | 50–75 characters (66ch sweet spot) |\n| WCAG line length cap  | 80 characters (40 for CJK) |\n| CSS implementation    | `max-width: 66ch`         |\n| Line height (body)    | ~1.5                      |\n| Fluid type            | `clamp()` to preserve ch range across viewports |\n\nHierarchy priority: size → weight → color → spacing. Adding typefaces is the classic mistake. Variable fonts are worth the complexity only when shipping multiple weights\u002Fwidths.\n\n**Web font loading**: `font-display: swap` (or `optional` for CLS-sensitive cases), `\u003Clink rel=\"preload\">` for the critical font, `size-adjust`\u002F`ascent-override` on fallback `@font-face` to minimize layout shift.\n\n### Layout and Grid\n\n- **8pt grid** with a 4pt sub-grid is the de facto spacing system\n- **12-column grids** dominate web layout\n- Use **CSS Grid** for two-dimensional layout; **Flexbox** for one-dimensional component distribution\n- The F-pattern (NN\u002Fg, 2006, confirmed 2017) is a symptom of poor formatting, not a goal. Good headings, bolding, and front-loaded content replace F-scanning with more thorough \"layer-cake\" scanning\n- Users read at most 28% of words on a page on average (Nielsen, 2008, ~50,000 page views); 20% is more likely\n- Gestalt principles (proximity, similarity, continuity, closure, figure-ground) are the most practically useful perceptual framework\n\n**Content density is a genuine fork:**\n- Dense UIs: correct for pro tools, dashboards, IDEs, analytics (information-per-screen, expert efficiency)\n- Airy UIs: correct for consumer onboarding and marketing (reduce cognitive load, guide one action)\n\n---\n\n## Component and Interaction Patterns\n\n### Navigation\n\n| Pattern    | When to use                                                  |\n|------------|--------------------------------------------------------------|\n| Top nav    | Marketing sites, shallow IA                                  |\n| Side nav   | Deep app-like hierarchies (SaaS, admin)                      |\n| Bottom nav | Mobile top-level (3–5 destinations, thumb zone)              |\n| Mega menus | Broad e-commerce\u002Fcontent taxonomies                          |\n\n**The \"≤7 menu items\" rule is a myth** — a misapplication of Miller's Law. Breadth often beats depth; it reduces clicks and keeps users oriented.\n\n### Forms\n\n**Top-aligned labels are the most usable and accessible default.** Advantages over left-aligned:\n- Eye travels in one direction (down only)\n- Label\u002Ffield sit close together — ~50ms to move from label to field vs ~500ms for left-aligned (Penzo, 2006 eye-tracking — treat as directional; the accessibility and localization advantages are the more durable case)\n- Better on mobile (left-aligned labels truncate the input)\n\nRules:\n- **Never use placeholder text as a label** — it disappears on input, fails contrast, and is unreliable for screen readers\n- Floating labels: fashionable but measurably worse for accessibility and motion sensitivity\n- Validate inline **after a field is completed**, not on every keystroke\n- Keep the submit button enabled; write recovery-oriented error messages\n- Break long forms into logical steps\n\n### Buttons and CTAs\n\nHierarchy: primary → secondary → tertiary\u002Fghost → destructive (visually distinct).\n\nAll interactive states must be visually distinct: hover, focus, active, disabled, loading.\n\n**Touch target sizes:**\n\n| Standard     | Minimum          |\n|--------------|------------------|\n| Apple HIG    | 44×44 pt         |\n| Material     | 48×48 dp (~9mm)  |\n| WCAG 2.2 AA  | 24×24 CSS px     |\n| WCAG 2.5.5 AAA | 44×44 CSS px   |\n| visionOS     | 60 pt (gaze-based) |\n\nAim for the larger platform values.\n\n### Modals and Dialogs\n\nUse for focused, must-complete decisions. Harmful when overused for non-blocking info. Drawers\u002Fsheets are better for secondary content and on mobile.\n\nRequired for every modal:\n- Focus trap\n- Restore focus on close\n- Support Escape key\n- Proper `aria-labelledby`\u002F`aria-describedby`\n\nInaccessible modals are a top accessibility failure.\n\n### Loading States\n\n| State type       | Best pattern                                      |\n|------------------|---------------------------------------------------|\n| Content loading  | Skeleton screens (generally reduce perceived wait) |\n| Short discrete actions | Spinner                                    |\n| No state at all  | Never — worst possible option                     |\n\nCaveat: A 2017 Viget study found skeletons performed *worst* on perceived duration in some conditions. The rule is: show structure for content loading, use a spinner for short discrete actions.\n\n### Lists: Infinite Scroll vs. Pagination vs. Load More\n\nBased on Baymard's multi-year, 50+ site studies:\n\n| Pattern         | Best for                                                  |\n|-----------------|-----------------------------------------------------------|\n| Load More + lazy-loading | Default; superior for most product lists       |\n| Pagination      | Goal-driven look-up, bookmarking, SEO                     |\n| Infinite scroll | Exploratory\u002Finspirational feeds (Pinterest, image galleries) |\n\nInfinite scroll \"can be downright harmful\" for goal-driven search — users lose their place, can't bookmark\u002Fcompare, the footer becomes unreachable.\n\n### Tables and Data Grids\n\nProvide: sorting, filtering, sticky headers, pagination or \"load more.\" Responsive patterns: horizontal scroll with frozen first column, or card stacking on mobile.\n\n### Notifications\n\n| Type       | Use for                                      | Behavior           |\n|------------|----------------------------------------------|--------------------|\n| Toast\u002Fsnackbar | Transient confirmations                  | Auto-dismiss       |\n| Banner     | Persistent page-level status                 | Stays until dismissed |\n| Inline     | Contextual\u002Ffield errors                      | Adjacent to source |\n\nNever put critical, action-required info in an auto-dismissing toast.\n\n### Motion and Microinteractions\n\nDan Saffer's model: trigger → rules → feedback → loops\u002Fmodes.\n\nDisney timing principles:\n- Ease-out for entrances\n- Ease-in for exits\n- UI transitions: ~150–300ms\n- Motion should communicate (state change, spatial relationship, progress), not decorate\n\n**Always honor `prefers-reduced-motion`** — disable or reduce non-essential animation for vestibular safety.\n\nWCAG 2.2 SC 2.5.7: drag interactions must have a single-pointer (non-drag) alternative.\n\n---\n\n## Accessibility and Inclusive Design\n\n### State of the Web (WebAIM Million)\n\n| Year | Pages with WCAG failures | Low-contrast text | Errors\u002Fpage |\n|------|--------------------------|-------------------|-------------|\n| 2025 | 94.8%                    | 79.1%             | 51.0        |\n| 2026 | (implied regression)     | 83.9%             | 56.1        |\n\nThe six issue types accounting for 96% of all errors:\n1. Low-contrast text (83.9% of pages)\n2. Missing alt text (55.5% of pages; ~18.5% of images)\n3. Missing form labels (48.2% of pages)\n4. Empty links (45.4%)\n5. Empty buttons\n6. Missing document language\n\n### WCAG 2.2 Key Additions (Oct 2023)\n\nAA-level additions designers must know:\n- **2.4.11 Focus Not Obscured (Minimum)**: sticky headers\u002Ffooters can't fully hide a focused element\n- **2.5.7 Dragging Movements**: drag must have a single-pointer alternative\n- **2.5.8 Target Size (Minimum)**: 24×24 CSS px or adequate spacing\n- **3.3.8 Accessible Authentication**: no cognitive-function test without an alternative\n- **3.2.6 Consistent Help** (Level A)\n- **3.3.7 Redundant Entry** (Level A)\n\nNote: 4.1.1 Parsing was removed in WCAG 2.2.\n\n### Semantic HTML and ARIA\n\n**Use native HTML elements first.** They carry built-in roles, keyboard handling, and focus management.\n\n\"No ARIA is better than bad ARIA\": pages *with* ARIA averaged ~34–41% *more* detected errors than pages without (WebAIM). ARIA adds semantics but never behavior — a `div role=\"button\"` still requires manual keyboard handlers. Reserve ARIA for genuinely custom widgets (tabs, comboboxes, live regions).\n\n### Keyboard and Screen Reader Testing\n\nProvide: logical tab order, visible focus indicators, skip links, managed focus in SPAs (move focus on route change, trap in modals, restore on close).\n\nTest with multiple screen readers — they differ in behavior:\n- VoiceOver (macOS\u002FiOS, Safari)\n- NVDA (Windows, Firefox\u002FChrome)\n- JAWS (Windows, Firefox\u002FChrome)\n\nAutomated tools (axe, Lighthouse, WAVE) catch only **30–40% of issues**. Manual keyboard + screen-reader testing is mandatory.\n\n### Color-Vision Deficiency\n\n~8% of men have a color-vision deficiency. Never rely on color alone — add icons, labels, patterns (WCAG SC 1.4.1 Use of Color).\n\n### Inclusive vs. Accessible Design\n\n- **Accessibility** = meeting the needs of people with disabilities (standards\u002Fcompliance)\n- **Inclusive design** = methodology of designing for the full range of human diversity (ability, language, context, device, situational constraints) from the start\n\nCompliance can be met while still excluding people. Inclusive design treats accessibility as one outcome of a broader commitment.\n\n---\n\n## UX Research Methods\n\n### Method Selection by Question Type\n\n| Phase      | Methods                                                       |\n|------------|---------------------------------------------------------------|\n| Generative\u002FDiscovery | User interviews, contextual inquiry, diary studies, JTBD |\n| Evaluative  | Usability testing (moderated\u002Funmoderated), tree testing      |\n| IA          | Card sorting (open\u002Fclosed\u002Fhybrid), tree testing              |\n| Behavioral at scale | Analytics, heatmaps, session recordings (Hotjar, FullStory) |\n| Quantitative UX | SUS, SUPR-Q, NPS                                        |\n\nA\u002FB testing works for high-traffic, isolatable changes with proper statistical significance. Misused for low-traffic pages or as a substitute for qualitative \"why.\"\n\n### Usability Benchmarks\n\n**SUS (System Usability Scale):**\n- Mean score across 446 studies: **68** (SD: 12.5) — this is the \"C\" \u002F 50th percentile\n- ≥80.3: \"A\" grade (top ~10–15%)\n- \u003C51: bottom ~15%\n- SUS is not a percentage\n\n**Cognitive laws (useful heuristics, not physics):**\n- **Hick's Law**: decision time grows logarithmically with number\u002Fcomplexity of choices → argues for progressive disclosure and chunking, not blanket minimalism\n- **Fitts's Law**: acquisition time depends on target size and distance → make primary targets big and close; make destructive actions small and far\n- **Miller's Law (\"7±2\")**: frequently misused to justify arbitrary 7-item limits; the real lesson is chunking and recognition-over-recall, not capping menus at 7\n\n**Nielsen's 10 Heuristics** — most commonly violated in practice:\n1. Visibility of system status\n2. Error prevention\n3. User control and freedom (undo\u002Fescape)\n4. Match between system and real world\n\n### Information Architecture\n\n- Card sorting + tree testing + sitemapping\n- Generally favor breadth over depth for findability\n- Design for both search AND browse\n- Faceted navigation + a sound taxonomy is the backbone of e-commerce and large content sites\n\n---\n\n## Design Systems\n\n### What a Design System Is\n\n\"A design system is a living, funded product with a roadmap & backlog, serving an ecosystem.\" (Nathan Curtis)\n\nComponents:\n- Component library (coded components)\n- Pattern library (documented solutions)\n- Tokens (the shared contract)\n- Guidelines + governance + people\n\n### Three-Tier Token Architecture\n\n```\nPrimitives      →   Semantic\u002FAlias     →   Component\nblue-500: #3B82F6   color-action-primary   button-bg-primary\n                    color-text-primary\n```\n\n- Applications consume **semantic** tokens, not primitives\n- Semantic names encode intent, not value: `color-text-primary`, not `color-blue-500`\n- Small teams can use two tiers (primitive + semantic)\n- Enterprise\u002Fmulti-brand\u002Fmulti-theme needs all three\n- More than three tiers is rarely justified\n- This architecture is what makes multi-mode theming (light\u002Fdark, density, brand) a matter of re-pointing tokens\n\n### Tooling Pipeline\n\n| Tool             | Role                                             |\n|------------------|--------------------------------------------------|\n| Style Dictionary | Transform design tokens into platform code      |\n| Tokens Studio    | Figma-based token management                    |\n| W3C DTCG format  | Standardizing JSON (`$value`\u002F`$type`)           |\n| Figma Variables  | Primitives, semantic tokens, multi-mode collections |\n| Storybook        | Code-first component documentation              |\n| Zeroheight \u002F Supernova | Design-first documentation                |\n\n### Atomic Design: What Holds and What Doesn't\n\nAtoms → Molecules → Organisms → Templates → Pages (Brad Frost, 2013).\n\n**What holds:** Systems-thinking, shared vocabulary that \"UIs are interconnected hierarchical systems,\" templates\u002Fpages for testing real content.\n\n**What's outdated:** The atom\u002Fmolecule\u002Forganism taxonomy is \"too fuzzy\" and abstracts too early. Practitioners now recommend starting with a flat component hierarchy and letting structure emerge. Frost himself has moved \"subatomic\" — toward design tokens as the smallest unit.\n\n### Governance Models (Nathan Curtis \u002F EightShapes)\n\n| Model       | Description                                                |\n|-------------|------------------------------------------------------------|\n| Solitary    | One team builds for its own needs (\"Overlords don't scale\") |\n| Centralized | Dedicated team makes and spreads decisions for other teams |\n| Federated   | Designers from multiple product teams decide together      |\n| Cyclical    | Centralized team + federated contributor community (Jina Anne\u002FSalesforce) |\n\nCurtis's contribution principle: \"central system team members can't make all the decisions… a system practice must model and foster a federated community.\"\n\nRelevance heuristic for what belongs in the system: useful to 3 products → discuss; useful to 5 → it probably belongs.\n\n### Versioning (SemVer)\n\n\"Every discussion about versioning design system outputs begins and ends with SemVer.\" (Curtis)\n\n- **MAJOR**: breaking changes\n- **MINOR**: backwards-compatible features\n- **PATCH**: backwards-compatible fixes\n\n**Library-level vs. component-level versioning:**\n- Library-level: one version across all assets — common for vanilla HTML\u002FCSS\n- Component-level: mix-and-match (e.g., Atlaskit Badge v15.0.8) — suited to React\u002Fcontinuous-release\n\nPackage tokens as a separate dependency so style can evolve independently of component APIs.\n\n### Adoption Measurement\n\nDistinguish:\n- **Usage** (breadth): which components, how often\n- **Coverage** (depth): how much of the UI is built from the system\n\nTools:\n- Figma Library Analytics: insertions, total instances, detaches\n- `react-scanner` for static component-instance analysis from code\n- Omlet, Preply's visual-coverage tool\n\nTrack detach rate as a diagnostic — a rising detach rate signals a bug, missing variant, or unmet need, and should trigger investigation, not enforcement.\n\n### Deprecation Process\n\nAtlassian's 6-step process: communicate intent → set a timeline → add docs notice → run deprecation commands → communicate again → delete.\n\nTimeline guidance by audience:\n- Salesforce: 18 months\n- Financial Times Origami: 3–6 months (tight developer community)\n\nRun enhanced + deprecated in parallel before removal in the next major version.\n\n---\n\n## AI Design Tools: Honest Assessment\n\n| Tool            | Strengths                                              | Weaknesses                                  |\n|-----------------|--------------------------------------------------------|---------------------------------------------|\n| v0 (Vercel)     | React + Tailwind + shadcn\u002Fui generation; best for dev iteration | Generic output without customization |\n| Figma Make      | Multi-screen prototypes, rapid concept exploration     | Variable credits; can't iterate after manual edits |\n| Stitch (ex-Galileo, Google Labs) | High-fidelity mockups, Figma export    | Labs-only, no SLA, weak for production work |\n\nConsistent verdict across reviewers: get you \"80% of the way there,\" require human judgment for UX quality, **frequently fail accessibility audits by default** (always verify contrast manually). Treat as accelerators, not replacements. Tool volatility is high — don't over-commit to any single one.\n\n---\n\n## Anti-Patterns and Dark Patterns\n\n- **Dark patterns** are now actively regulated. FTC's 2024 review of 642 subscription sites found 76% used at least one dark pattern; the EU Digital Services Act (fully effective Feb 2024) and CCPA\u002FCPRA prohibit dark patterns for consent. The FTC finalized its Click-to-Cancel\u002FNegative Option Rule in October 2024.\n- Over-designing: gold-plating where simplicity serves better\n- Building a design system prematurely (before products exist to serve)\n- Confirmation bias in design critique\n\n---\n\n## Staged Recommendations\n\n**Stage 1 — Fix cheap, high-impact accessibility failures (weeks 1–4):**\nRun axe\u002FLighthouse\u002FWAVE; manually fix the six WebAIM categories: contrast (4.5:1 \u002F 3:1 AA), alt text, form labels, empty links\u002Fbuttons, document language. Add visible focus styles and skip links. Verify keyboard operability of every interactive element.\n\n**Stage 2 — Standardize foundations as tokens (months 2–3):**\nEstablish three-tier token system; implement dark mode via semantic re-pointing (no pure black, elevation by lightness); set `max-width: 66ch` and `line-height: 1.5` on body; adopt 8pt grid; define button hierarchy + states + touch targets (≥44pt\u002F48dp). Move to `oklch()` with sRGB fallbacks.\n\n**Stage 3 — Apply pattern evidence to your context (ongoing):**\nTop-aligned labels; inline-after-completion validation; skeletons for content loading, spinners for short actions; Load More\u002Fpagination for goal-driven lists, infinite scroll only for exploratory feeds; honor `prefers-reduced-motion`. Decide density deliberately (dense for pro tools, airy for consumer\u002Fonboarding).\n\n**Stage 4 — Operationalize the design system (quarter 2+):**\nAdopt SemVer; pick a governance model (centralized to start, federate as contributors mature); define a deprecation process with an explicit window; measure adoption (coverage + usage).\n\n**Stage 5 — Pilot AI tooling without betting the system on it:**\nUse for rapid prototyping and concept exploration; require a human accessibility\u002Fcontrast pass before anything ships; re-evaluate tool choice quarterly.\n","# Graphic UX\u002FUI Design: Practitioner's Reference\n\n## Evidence Summary\n\nMost \"best practices\" are context rules. The strongest, most replicated findings (top-aligned labels, 50–75ch line length, dark-grey dark mode, skeleton screens for content loading, \"Load More\" over infinite scroll for goal-driven tasks, semantic HTML before ARIA) hold across platforms. Density, motion, and navigation choices depend on whether you serve consumers or power users. Accessibility is the single biggest gap between rhetoric and reality: WebAIM's 2026 scan found 83.9% of top 1M home pages have low-contrast text (up from 79.1% in 2025), 56.1 errors\u002Fpage. The fixes are trivial and known — they simply aren't implemented.\n\n---\n\n## Visual Design Fundamentals\n\n### Color Systems\n\nProduction color architecture uses three token tiers:\n- **Primitive tokens**: raw values — `blue-500: #3B82F6`\n- **Semantic tokens**: intent — `color-action-primary`, `color-text-primary`, `color-status-error`\n- **Component tokens**: scoped — `button-bg-primary`\n\nApplications consume semantic tokens, not primitives. Theming and dark mode become a matter of re-pointing semantic tokens, not editing components. Neutral scales (9–12 steps) carry most of the surface area.\n\n### WCAG Contrast Requirements\n\n| Level | Normal text | Large text (≥24px or 18.7px bold) | Non-text UI |\n|-------|-------------|-----------------------------------|-------------|\n| AA    | 4.5:1       | 3:1                               | 3:1         |\n| AAA   | 7:1         | 4.5:1                             | —           |\n\nGlobal regulations (Section 508, EN 301 549, AODA) target AA. AAA is aspirational and not always achievable. Low-contrast text is the #1 accessibility defect for seven straight years. **Do not wait for WCAG 3\u002FAPCA to be final** — keep conforming to WCAG 2.x AA for compliance; use APCA as a supplementary check (especially for dark themes); never claim \"WCAG 3 compliance\" (it doesn't exist yet as of 2026).\n\n### Oklch and Wide-Gamut Color\n\nCSS Color Level 4 (`oklch()`, `oklab()`, `color(display-p3)`) is Baseline Widely Available (Chrome\u002FEdge 111+, Firefox 113+, Safari 15.4+).\n\nWhy oklch matters:\n1. **Perceptual uniformity** — a fixed change in L looks equally different across hues; HSL does not have this property. Use it to generate consistent tint\u002Fshade scales programmatically.\n2. **Wide gamut** — Display P3 covers ~50% more colors than sRGB. Every iPhone since 7, every MacBook since 2016 supports it.\n\nAlways declare sRGB hex fallbacks first for old browsers.\n\n### Dark Mode\n\n**Never use pure black (#000000).** Material Design recommends #121212 as the base dark surface — pure black causes halation\u002Fblooming and disables shadows.\n\nExpress elevation through lightness, not shadow:\n\n| Layer       | Approximate L% |\n|-------------|----------------|\n| Base        | 10–12%         |\n| Sidebars    | 14–16%         |\n| Cards       | 17–20%         |\n| Modals      | 22–26%         |\n| Popovers    | 26–30%         |\n\nKeep ~3–5 points between each level. Desaturate accent colors (they vibrate against dark surfaces). Use off-white (~#E1E1E1 or white at 87% opacity) rather than pure white text. A naive light-palette inversion fails — light and dark modes have asymmetric perceptual requirements. Always let users toggle; don't force it.\n\n### Typography\n\n| Guideline             | Value                     |\n|-----------------------|---------------------------|\n| Optimal line length   | 50–75 characters (66ch sweet spot) |\n| WCAG line length cap  | 80 characters (40 for CJK) |\n| CSS implementation    | `max-width: 66ch`         |\n| Line height (body)    | ~1.5                      |\n| Fluid type            | `clamp()` to preserve ch range across viewports |\n\nHierarchy priority: size → weight → color → spacing. Adding typefaces is the classic mistake. Variable fonts are worth the complexity only when shipping multiple weights\u002Fwidths.\n\n**Web font loading**: `font-display: swap` (or `optional` for CLS-sensitive cases), `\u003Clink rel=\"preload\">` for the critical font, `size-adjust`\u002F`ascent-override` on fallback `@font-face` to minimize layout shift.\n\n### Layout and Grid\n\n- **8pt grid** with a 4pt sub-grid is the de facto spacing system\n- **12-column grids** dominate web layout\n- Use **CSS Grid** for two-dimensional layout; **Flexbox** for one-dimensional component distribution\n- The F-pattern (NN\u002Fg, 2006, confirmed 2017) is a symptom of poor formatting, not a goal. Good headings, bolding, and front-loaded content replace F-scanning with more thorough \"layer-cake\" scanning\n- Users read at most 28% of words on a page on average (Nielsen, 2008, ~50,000 page views); 20% is more likely\n- Gestalt principles (proximity, similarity, continuity, closure, figure-ground) are the most practically useful perceptual framework\n\n**Content density is a genuine fork:**\n- Dense UIs: correct for pro tools, dashboards, IDEs, analytics (information-per-screen, expert efficiency)\n- Airy UIs: correct for consumer onboarding and marketing (reduce cognitive load, guide one action)\n\n---\n\n## Component and Interaction Patterns\n\n### Navigation\n\n| Pattern    | When to use                                                  |\n|------------|--------------------------------------------------------------|\n| Top nav    | Marketing sites, shallow IA                                  |\n| Side nav   | Deep app-like hierarchies (SaaS, admin)                      |\n| Bottom nav | Mobile top-level (3–5 destinations, thumb zone)              |\n| Mega menus | Broad e-commerce\u002Fcontent taxonomies                          |\n\n**The \"≤7 menu items\" rule is a myth** — a misapplication of Miller's Law. Breadth often beats depth; it reduces clicks and keeps users oriented.\n\n### Forms\n\n**Top-aligned labels are the most usable and accessible default.** Advantages over left-aligned:\n- Eye travels in one direction (down only)\n- Label\u002Ffield sit close together — ~50ms to move from label to field vs ~500ms for left-aligned (Penzo, 2006 eye-tracking — treat as directional; the accessibility and localization advantages are the more durable case)\n- Better on mobile (left-aligned labels truncate the input)\n\nRules:\n- **Never use placeholder text as a label** — it disappears on input, fails contrast, and is unreliable for screen readers\n- Floating labels: fashionable but measurably worse for accessibility and motion sensitivity\n- Validate inline **after a field is completed**, not on every keystroke\n- Keep the submit button enabled; write recovery-oriented error messages\n- Break long forms into logical steps\n\n### Buttons and CTAs\n\nHierarchy: primary → secondary → tertiary\u002Fghost → destructive (visually distinct).\n\nAll interactive states must be visually distinct: hover, focus, active, disabled, loading.\n\n**Touch target sizes:**\n\n| Standard     | Minimum          |\n|--------------|------------------|\n| Apple HIG    | 44×44 pt         |\n| Material     | 48×48 dp (~9mm)  |\n| WCAG 2.2 AA  | 24×24 CSS px     |\n| WCAG 2.5.5 AAA | 44×44 CSS px   |\n| visionOS     | 60 pt (gaze-based) |\n\nAim for the larger platform values.\n\n### Modals and Dialogs\n\nUse for focused, must-complete decisions. Harmful when overused for non-blocking info. Drawers\u002Fsheets are better for secondary content and on mobile.\n\nRequired for every modal:\n- Focus trap\n- Restore focus on close\n- Support Escape key\n- Proper `aria-labelledby`\u002F`aria-describedby`\n\nInaccessible modals are a top accessibility failure.\n\n### Loading States\n\n| State type       | Best pattern                                      |\n|------------------|---------------------------------------------------|\n| Content loading  | Skeleton screens (generally reduce perceived wait) |\n| Short discrete actions | Spinner                                    |\n| No state at all  | Never — worst possible option                     |\n\nCaveat: A 2017 Viget study found skeletons performed *worst* on perceived duration in some conditions. The rule is: show structure for content loading, use a spinner for short discrete actions.\n\n### Lists: Infinite Scroll vs. Pagination vs. Load More\n\nBased on Baymard's multi-year, 50+ site studies:\n\n| Pattern         | Best for                                                  |\n|-----------------|-----------------------------------------------------------|\n| Load More + lazy-loading | Default; superior for most product lists       |\n| Pagination      | Goal-driven look-up, bookmarking, SEO                     |\n| Infinite scroll | Exploratory\u002Finspirational feeds (Pinterest, image galleries) |\n\nInfinite scroll \"can be downright harmful\" for goal-driven search — users lose their place, can't bookmark\u002Fcompare, the footer becomes unreachable.\n\n### Tables and Data Grids\n\nProvide: sorting, filtering, sticky headers, pagination or \"load more.\" Responsive patterns: horizontal scroll with frozen first column, or card stacking on mobile.\n\n### Notifications\n\n| Type       | Use for                                      | Behavior           |\n|------------|----------------------------------------------|--------------------|\n| Toast\u002Fsnackbar | Transient confirmations                  | Auto-dismiss       |\n| Banner     | Persistent page-level status                 | Stays until dismissed |\n| Inline     | Contextual\u002Ffield errors                      | Adjacent to source |\n\nNever put critical, action-required info in an auto-dismissing toast.\n\n### Motion and Microinteractions\n\nDan Saffer's model: trigger → rules → feedback → loops\u002Fmodes.\n\nDisney timing principles:\n- Ease-out for entrances\n- Ease-in for exits\n- UI transitions: ~150–300ms\n- Motion should communicate (state change, spatial relationship, progress), not decorate\n\n**Always honor `prefers-reduced-motion`** — disable or reduce non-essential animation for vestibular safety.\n\nWCAG 2.2 SC 2.5.7: drag interactions must have a single-pointer (non-drag) alternative.\n\n---\n\n## Accessibility and Inclusive Design\n\n### State of the Web (WebAIM Million)\n\n| Year | Pages with WCAG failures | Low-contrast text | Errors\u002Fpage |\n|------|--------------------------|-------------------|-------------|\n| 2025 | 94.8%                    | 79.1%             | 51.0        |\n| 2026 | (implied regression)     | 83.9%             | 56.1        |\n\nThe six issue types accounting for 96% of all errors:\n1. Low-contrast text (83.9% of pages)\n2. Missing alt text (55.5% of pages; ~18.5% of images)\n3. Missing form labels (48.2% of pages)\n4. Empty links (45.4%)\n5. Empty buttons\n6. Missing document language\n\n### WCAG 2.2 Key Additions (Oct 2023)\n\nAA-level additions designers must know:\n- **2.4.11 Focus Not Obscured (Minimum)**: sticky headers\u002Ffooters can't fully hide a focused element\n- **2.5.7 Dragging Movements**: drag must have a single-pointer alternative\n- **2.5.8 Target Size (Minimum)**: 24×24 CSS px or adequate spacing\n- **3.3.8 Accessible Authentication**: no cognitive-function test without an alternative\n- **3.2.6 Consistent Help** (Level A)\n- **3.3.7 Redundant Entry** (Level A)\n\nNote: 4.1.1 Parsing was removed in WCAG 2.2.\n\n### Semantic HTML and ARIA\n\n**Use native HTML elements first.** They carry built-in roles, keyboard handling, and focus management.\n\n\"No ARIA is better than bad ARIA\": pages *with* ARIA averaged ~34–41% *more* detected errors than pages without (WebAIM). ARIA adds semantics but never behavior — a `div role=\"button\"` still requires manual keyboard handlers. Reserve ARIA for genuinely custom widgets (tabs, comboboxes, live regions).\n\n### Keyboard and Screen Reader Testing\n\nProvide: logical tab order, visible focus indicators, skip links, managed focus in SPAs (move focus on route change, trap in modals, restore on close).\n\nTest with multiple screen readers — they differ in behavior:\n- VoiceOver (macOS\u002FiOS, Safari)\n- NVDA (Windows, Firefox\u002FChrome)\n- JAWS (Windows, Firefox\u002FChrome)\n\nAutomated tools (axe, Lighthouse, WAVE) catch only **30–40% of issues**. Manual keyboard + screen-reader testing is mandatory.\n\n### Color-Vision Deficiency\n\n~8% of men have a color-vision deficiency. Never rely on color alone — add icons, labels, patterns (WCAG SC 1.4.1 Use of Color).\n\n### Inclusive vs. Accessible Design\n\n- **Accessibility** = meeting the needs of people with disabilities (standards\u002Fcompliance)\n- **Inclusive design** = methodology of designing for the full range of human diversity (ability, language, context, device, situational constraints) from the start\n\nCompliance can be met while still excluding people. Inclusive design treats accessibility as one outcome of a broader commitment.\n\n---\n\n## UX Research Methods\n\n### Method Selection by Question Type\n\n| Phase      | Methods                                                       |\n|------------|---------------------------------------------------------------|\n| Generative\u002FDiscovery | User interviews, contextual inquiry, diary studies, JTBD |\n| Evaluative  | Usability testing (moderated\u002Funmoderated), tree testing      |\n| IA          | Card sorting (open\u002Fclosed\u002Fhybrid), tree testing              |\n| Behavioral at scale | Analytics, heatmaps, session recordings (Hotjar, FullStory) |\n| Quantitative UX | SUS, SUPR-Q, NPS                                        |\n\nA\u002FB testing works for high-traffic, isolatable changes with proper statistical significance. Misused for low-traffic pages or as a substitute for qualitative \"why.\"\n\n### Usability Benchmarks\n\n**SUS (System Usability Scale):**\n- Mean score across 446 studies: **68** (SD: 12.5) — this is the \"C\" \u002F 50th percentile\n- ≥80.3: \"A\" grade (top ~10–15%)\n- \u003C51: bottom ~15%\n- SUS is not a percentage\n\n**Cognitive laws (useful heuristics, not physics):**\n- **Hick's Law**: decision time grows logarithmically with number\u002Fcomplexity of choices → argues for progressive disclosure and chunking, not blanket minimalism\n- **Fitts's Law**: acquisition time depends on target size and distance → make primary targets big and close; make destructive actions small and far\n- **Miller's Law (\"7±2\")**: frequently misused to justify arbitrary 7-item limits; the real lesson is chunking and recognition-over-recall, not capping menus at 7\n\n**Nielsen's 10 Heuristics** — most commonly violated in practice:\n1. Visibility of system status\n2. Error prevention\n3. User control and freedom (undo\u002Fescape)\n4. Match between system and real world\n\n### Information Architecture\n\n- Card sorting + tree testing + sitemapping\n- Generally favor breadth over depth for findability\n- Design for both search AND browse\n- Faceted navigation + a sound taxonomy is the backbone of e-commerce and large content sites\n\n---\n\n## Design Systems\n\n### What a Design System Is\n\n\"A design system is a living, funded product with a roadmap & backlog, serving an ecosystem.\" (Nathan Curtis)\n\nComponents:\n- Component library (coded components)\n- Pattern library (documented solutions)\n- Tokens (the shared contract)\n- Guidelines + governance + people\n\n### Three-Tier Token Architecture\n\n```\nPrimitives      →   Semantic\u002FAlias     →   Component\nblue-500: #3B82F6   color-action-primary   button-bg-primary\n                    color-text-primary\n```\n\n- Applications consume **semantic** tokens, not primitives\n- Semantic names encode intent, not value: `color-text-primary`, not `color-blue-500`\n- Small teams can use two tiers (primitive + semantic)\n- Enterprise\u002Fmulti-brand\u002Fmulti-theme needs all three\n- More than three tiers is rarely justified\n- This architecture is what makes multi-mode theming (light\u002Fdark, density, brand) a matter of re-pointing tokens\n\n### Tooling Pipeline\n\n| Tool             | Role                                             |\n|------------------|--------------------------------------------------|\n| Style Dictionary | Transform design tokens into platform code      |\n| Tokens Studio    | Figma-based token management                    |\n| W3C DTCG format  | Standardizing JSON (`$value`\u002F`$type`)           |\n| Figma Variables  | Primitives, semantic tokens, multi-mode collections |\n| Storybook        | Code-first component documentation              |\n| Zeroheight \u002F Supernova | Design-first documentation                |\n\n### Atomic Design: What Holds and What Doesn't\n\nAtoms → Molecules → Organisms → Templates → Pages (Brad Frost, 2013).\n\n**What holds:** Systems-thinking, shared vocabulary that \"UIs are interconnected hierarchical systems,\" templates\u002Fpages for testing real content.\n\n**What's outdated:** The atom\u002Fmolecule\u002Forganism taxonomy is \"too fuzzy\" and abstracts too early. Practitioners now recommend starting with a flat component hierarchy and letting structure emerge. Frost himself has moved \"subatomic\" — toward design tokens as the smallest unit.\n\n### Governance Models (Nathan Curtis \u002F EightShapes)\n\n| Model       | Description                                                |\n|-------------|------------------------------------------------------------|\n| Solitary    | One team builds for its own needs (\"Overlords don't scale\") |\n| Centralized | Dedicated team makes and spreads decisions for other teams |\n| Federated   | Designers from multiple product teams decide together      |\n| Cyclical    | Centralized team + federated contributor community (Jina Anne\u002FSalesforce) |\n\nCurtis's contribution principle: \"central system team members can't make all the decisions… a system practice must model and foster a federated community.\"\n\nRelevance heuristic for what belongs in the system: useful to 3 products → discuss; useful to 5 → it probably belongs.\n\n### Versioning (SemVer)\n\n\"Every discussion about versioning design system outputs begins and ends with SemVer.\" (Curtis)\n\n- **MAJOR**: breaking changes\n- **MINOR**: backwards-compatible features\n- **PATCH**: backwards-compatible fixes\n\n**Library-level vs. component-level versioning:**\n- Library-level: one version across all assets — common for vanilla HTML\u002FCSS\n- Component-level: mix-and-match (e.g., Atlaskit Badge v15.0.8) — suited to React\u002Fcontinuous-release\n\nPackage tokens as a separate dependency so style can evolve independently of component APIs.\n\n### Adoption Measurement\n\nDistinguish:\n- **Usage** (breadth): which components, how often\n- **Coverage** (depth): how much of the UI is built from the system\n\nTools:\n- Figma Library Analytics: insertions, total instances, detaches\n- `react-scanner` for static component-instance analysis from code\n- Omlet, Preply's visual-coverage tool\n\nTrack detach rate as a diagnostic — a rising detach rate signals a bug, missing variant, or unmet need, and should trigger investigation, not enforcement.\n\n### Deprecation Process\n\nAtlassian's 6-step process: communicate intent → set a timeline → add docs notice → run deprecation commands → communicate again → delete.\n\nTimeline guidance by audience:\n- Salesforce: 18 months\n- Financial Times Origami: 3–6 months (tight developer community)\n\nRun enhanced + deprecated in parallel before removal in the next major version.\n\n---\n\n## AI Design Tools: Honest Assessment\n\n| Tool            | Strengths                                              | Weaknesses                                  |\n|-----------------|--------------------------------------------------------|---------------------------------------------|\n| v0 (Vercel)     | React + Tailwind + shadcn\u002Fui generation; best for dev iteration | Generic output without customization |\n| Figma Make      | Multi-screen prototypes, rapid concept exploration     | Variable credits; can't iterate after manual edits |\n| Stitch (ex-Galileo, Google Labs) | High-fidelity mockups, Figma export    | Labs-only, no SLA, weak for production work |\n\nConsistent verdict across reviewers: get you \"80% of the way there,\" require human judgment for UX quality, **frequently fail accessibility audits by default** (always verify contrast manually). Treat as accelerators, not replacements. Tool volatility is high — don't over-commit to any single one.\n\n---\n\n## Anti-Patterns and Dark Patterns\n\n- **Dark patterns** are now actively regulated. FTC's 2024 review of 642 subscription sites found 76% used at least one dark pattern; the EU Digital Services Act (fully effective Feb 2024) and CCPA\u002FCPRA prohibit dark patterns for consent. The FTC finalized its Click-to-Cancel\u002FNegative Option Rule in October 2024.\n- Over-designing: gold-plating where simplicity serves better\n- Building a design system prematurely (before products exist to serve)\n- Confirmation bias in design critique\n\n---\n\n## Staged Recommendations\n\n**Stage 1 — Fix cheap, high-impact accessibility failures (weeks 1–4):**\nRun axe\u002FLighthouse\u002FWAVE; manually fix the six WebAIM categories: contrast (4.5:1 \u002F 3:1 AA), alt text, form labels, empty links\u002Fbuttons, document language. Add visible focus styles and skip links. Verify keyboard operability of every interactive element.\n\n**Stage 2 — Standardize foundations as tokens (months 2–3):**\nEstablish three-tier token system; implement dark mode via semantic re-pointing (no pure black, elevation by lightness); set `max-width: 66ch` and `line-height: 1.5` on body; adopt 8pt grid; define button hierarchy + states + touch targets (≥44pt\u002F48dp). Move to `oklch()` with sRGB fallbacks.\n\n**Stage 3 — Apply pattern evidence to your context (ongoing):**\nTop-aligned labels; inline-after-completion validation; skeletons for content loading, spinners for short actions; Load More\u002Fpagination for goal-driven lists, infinite scroll only for exploratory feeds; honor `prefers-reduced-motion`. Decide density deliberately (dense for pro tools, airy for consumer\u002Fonboarding).\n\n**Stage 4 — Operationalize the design system (quarter 2+):**\nAdopt SemVer; pick a governance model (centralized to start, federate as contributors mature); define a deprecation process with an explicit window; measure adoption (coverage + usage).\n\n**Stage 5 — Pilot AI tooling without betting the system on it:**\nUse for rapid prototyping and concept exploration; require a human accessibility\u002Fcontrast pass before anything ships; re-evaluate tool choice quarterly.\n",{"name":5,"description":7},"develop","ae32736a1aabddabca5d2c96d665aa0ebc7d8700","src\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Ffrontend-design\u002Fskills\u002Fgraphic-ux-ui-design",3,"https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey","https:\u002F\u002Fthe-vibey-project.github.io\u002Fvibey\u002F","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project","https:\u002F\u002Fvibewithadam.matthewsteinberger.com","freedom for software engineers","2026-11-15 05:47:42",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add the-vibey-project\u002Fvibey --skill graphic-ux-ui-design",{"tool":40,"command":41},"bunx","bunx skills add the-vibey-project\u002Fvibey --skill graphic-ux-ui-design",{"tool":43,"command":44},"pnpm","pnpm dlx skills add the-vibey-project\u002Fvibey --skill graphic-ux-ui-design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Ffrontend-design\u002Fskills\u002Fgraphic-ux-ui-design\u002FSKILL.md",true,[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7AT1FQJAE1FQYAMDTF490Y4","white-paper-writing","Use when writing white papers, technical reports, policy documents, thought leadership pieces, or any long-form authoritative document. Triggers on requests to write, structure, outline, or review white papers, technical reports, position papers, policy briefs, or evidence-driven arguments. Also use for B2B content marketing strategy, technical documentation requiring authority, academic-style reports, or any document that must educate while persuading. Use when someone asks \"how should I structure this\" for a long-form document.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fwhite-paper-writing\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7AT16BJRJJKK2MASXRZS76G","prose-technical-mechanics","Use when editing or writing prose at a technical\u002Fmechanical level: choosing between Anglo-Saxon and Latinate diction, placing information in topic vs stress positions, writing periodic vs cumulative sentences, handling sentence rhythm, punctuation as logic, transitions, paragraph structure, or phonesthetics. Use when someone wants to understand WHY prose works or doesn't, not just surface-level style advice. Triggers on word choice, sentence structure, emphasis, rhythm, diction, or any deep writing mechanics question.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fprose-technical-mechanics\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7AT0W9HT0ZZ9Y287NW99MR3","prose-mechanics","Use when writing, editing, or analyzing prose style; when trying to avoid generic AI-sounding writing; when applying specific prose styles such as journalistic, academic, narrative, KJV biblical, Hemingway plain, Latinate\u002FJamesian, Orwellian, Augustan, Victorian, Early Modern (Bacon, Browne, Milton), or free indirect discourse; or when coaching someone on writing voice and mechanics. Triggers on any request to improve, analyze, or write in a specific prose style, to fix \"AI-sounding\" writing, to make prose more vivid or concrete, to vary sentence rhythm, or to understand how a particular writer achieves their effects.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fprose-mechanics\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7AT0KR635JX66X2X6F3E2CP","narrative-structure","Use when structuring stories, pitches, presentations, white papers, or any persuasive narrative; analyzing the hero's journey in fiction or non-fiction; applying StoryBrand for business communication; designing narrative arcs for thought leadership; or understanding Vogler, Snyder, Propp, or Campbell frameworks. Triggers on any narrative structure, storytelling, pitch structure, StoryBrand, hero's journey, three-act structure, Freytag, Save the Cat, narrative arc, or \"how should I structure this story\u002Fpitch\u002Fpresentation\" request.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fnarrative-structure\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7AT0AKGW09NKKZDYBT8VRDE","legal-brief-writing","Use when writing legal briefs, motions, or any court filing; when analyzing judicial cognition and persuasion; when applying elite brief-writing techniques from Roberts, Clement, Kagan, Garner; or when structuring legal arguments for maximum persuasion. Also use for autistic\u002Fneurodivergent advocates who need to understand how their natural communication style maps to elite legal advocacy. Triggers on any legal writing, brief drafting, motion preparation, or legal argument structuring request.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Flegal-brief-writing\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7AT00VWPS4Q8B5VEMXX9NQT","journal-publishability-criteria","Use whenever a research paper, article or preprint is being written, revised, reviewed or published, and specifically before every publication of docs\u002Fpaper.md. Covers what legitimate journals actually gate on, in order of gating — the editor's desk screen (scope, novelty, package problems), what reviewers judge (methodological soundness, claims the evidence can carry, statistical and qualitative reporting), EQUATOR reporting guidelines, the ICMJE authorship criteria, COPE's view of text recycling, the near-universal generative-AI policy (no AI author, disclosure, author responsibility), TOP 2025 transparency standards, how to verify a journal is legitimate, submitting without an institution, and a pre-submission checklist. Triggers on requests to evaluate, review, prepare or submit a paper, to judge publishability, to write a declarations or data-availability section, to disclose AI use, or to check a journal.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fjournal-publishability-criteria\u002FSKILL.md",[],[]]