Skip to content

notque/vexjoy-agent / skills/frontend/frontend

frontend

Unverified

Frontend: UI design, distinctive visual styles, HTML artifacts, Three.js 3D, TypeScript/React/Next.js apps, e-commerce, portfolios, React Native, web performance.

FileKindSize
SKILL.mdskill md22.5 KB
SPEC.mdmarkdown4.3 KB
agents/html-builder.mdmarkdown5.9 KB
assets/base-template.htmlother495 B
references/design-refs/accessibility-review.mdmarkdown13.0 KB
references/design-refs/design-critique.mdmarkdown10.4 KB
references/design-refs/design-handoff.mdmarkdown9.9 KB
references/design-refs/design-systems.mdmarkdown9.3 KB
references/design-refs/llm-design-failure-modes.mdmarkdown9.1 KB
references/design-refs/ux-copy.mdmarkdown9.5 KB
references/distinctive-frontend-design-refs/animation-patterns.mdmarkdown10.5 KB
references/distinctive-frontend-design-refs/background-techniques.mdmarkdown10.5 KB
references/distinctive-frontend-design-refs/balatro-shader-breakdown.mdmarkdown14.9 KB
references/distinctive-frontend-design-refs/card-shader-patterns.mdmarkdown10.9 KB
references/distinctive-frontend-design-refs/color-inspirations.jsonconfig9.4 KB
references/distinctive-frontend-design-refs/css-audit-patterns.mdmarkdown4.7 KB
references/distinctive-frontend-design-refs/font-catalog.jsonconfig9.7 KB
references/distinctive-frontend-design-refs/game-ui-polish.mdmarkdown6.3 KB
references/distinctive-frontend-design-refs/honest-placeholders.mdmarkdown3.2 KB
references/distinctive-frontend-design-refs/implementation-examples.mdmarkdown7.7 KB
references/distinctive-frontend-design-refs/macrostructure-catalog.mdmarkdown9.3 KB
references/distinctive-frontend-design-refs/oklch-color-harmony.mdmarkdown7.3 KB
references/distinctive-frontend-design-refs/performance-budgets.mdmarkdown10.6 KB
references/distinctive-frontend-design-refs/phase-details.mdmarkdown4.8 KB
references/distinctive-frontend-design-refs/pptx-conversion.mdmarkdown9.7 KB
references/distinctive-frontend-design-refs/roll-text.mdmarkdown7.2 KB
references/distinctive-frontend-design-refs/shader-integration-react.mdmarkdown16.7 KB
references/distinctive-frontend-design-refs/slide-controller.mdmarkdown9.4 KB
references/distinctive-frontend-design-refs/text-animation-patterns.mdmarkdown4.3 KB
references/html-artifact-refs/design-system.mdmarkdown10.2 KB
references/html-artifact-refs/diagram-layering.mdmarkdown3.9 KB
references/html-artifact-refs/infographic-layouts.mdmarkdown4.9 KB
references/html-artifact-refs/pdf-export.mdmarkdown6.0 KB
references/html-artifact-refs/pptx-export.mdmarkdown10.2 KB
references/html-artifact-refs/shape-diagram-illustration.mdmarkdown4.3 KB
references/nextjs-ecommerce.mdmarkdown3.4 KB
references/nextjs-ecommerce/admin-dashboard.mdmarkdown9.8 KB
references/nextjs-ecommerce/error-catalog.mdmarkdown7.9 KB
references/nextjs-ecommerce/expertise.mdmarkdown5.1 KB
references/nextjs-ecommerce/patterns-and-errors.mdmarkdown4.6 KB
references/nextjs-ecommerce/preferred-patterns.mdmarkdown8.0 KB
references/nextjs-ecommerce/shopping-cart-patterns.mdmarkdown7.7 KB
references/nextjs-ecommerce/stripe-integration.mdmarkdown9.5 KB
references/performance-optimization.mdmarkdown9.9 KB
references/performance-optimization/browser-dom-optimizations.mdmarkdown6.0 KB
references/performance-optimization/bundle-optimization.mdmarkdown7.9 KB
references/performance-optimization/core-web-vitals.mdmarkdown9.6 KB
references/performance-optimization/js-algorithm-optimizations.mdmarkdown9.6 KB
references/performance-optimization/metrics-and-monitoring.mdmarkdown8.8 KB
references/performance-optimization/nextjs-optimization.mdmarkdown10.6 KB
references/performance-optimization/performance-testing.mdmarkdown9.6 KB
references/performance-optimization/preferred-patterns.mdmarkdown7.4 KB
references/performance-optimization/react-async-patterns.mdmarkdown7.0 KB
references/performance-optimization/react-bundle-optimization.mdmarkdown6.3 KB
references/performance-optimization/react-rendering-performance.mdmarkdown12.0 KB
references/react-native.mdmarkdown4.4 KB
references/react-native/animation-patterns.mdmarkdown3.9 KB
references/react-native/error-handling.mdmarkdown7.7 KB
references/react-native/list-performance.mdmarkdown5.4 KB
references/react-native/monorepo-config.mdmarkdown2.3 KB
references/react-native/navigation-patterns.mdmarkdown2.0 KB
references/react-native/rendering-patterns.mdmarkdown3.2 KB
references/react-native/state-management.mdmarkdown3.3 KB
references/react-native/testing.mdmarkdown6.2 KB
references/react-native/ui-patterns.mdmarkdown5.0 KB
references/react-portfolio.mdmarkdown7.7 KB
references/react-portfolio/gallery-patterns.mdmarkdown2.5 KB
references/react-portfolio/image-optimization.mdmarkdown3.4 KB
references/react-portfolio/lightbox-patterns.mdmarkdown6.1 KB
references/react-portfolio/nextjs-app-router.mdmarkdown4.9 KB
references/react-portfolio/performance.mdmarkdown3.9 KB
references/react-portfolio/portfolio-seo.mdmarkdown4.8 KB
references/react-portfolio/responsive-design.mdmarkdown3.3 KB
references/threejs-builder-refs/advanced-animation.mdmarkdown12.1 KB
references/threejs-builder-refs/advanced-topics.mdmarkdown11.0 KB
references/threejs-builder-refs/build-recipes.mdmarkdown7.4 KB
references/threejs-builder-refs/game-architecture.mdmarkdown10.4 KB
references/threejs-builder-refs/game-patterns.mdmarkdown12.5 KB
references/threejs-builder-refs/gltf-loading.mdmarkdown8.6 KB
references/threejs-builder-refs/performance-patterns.mdmarkdown11.8 KB
references/threejs-builder-refs/react-three-fiber.mdmarkdown17.8 KB
references/threejs-builder-refs/shader-patterns.mdmarkdown15.0 KB
references/threejs-builder-refs/visual-polish.mdmarkdown16.3 KB
references/threejs-builder-refs/webgpu.mdmarkdown20.4 KB
references/typescript-frontend.mdmarkdown5.3 KB
references/typescript-frontend/engineering-rules.mdmarkdown7.8 KB
references/typescript-frontend/nextjs-security.mdmarkdown2.6 KB
references/typescript-frontend/react-view-transitions.mdmarkdown5.4 KB
references/ui-design.mdmarkdown10.2 KB
references/ui-design/ai-slop-detection.mdmarkdown8.5 KB
references/ui-design/design-conventions.mdmarkdown2.8 KB
references/ui-design/motion-and-interaction.mdmarkdown5.6 KB
scripts-distinctive-frontend-design/css_slop_rules.pyscript15.3 KB
scripts-distinctive-frontend-design/tests/test_css_slop_rules.pyscript6.9 KB
scripts-distinctive-frontend-design/tests/test_validate_design_advisory.pyscript3.3 KB
scripts-distinctive-frontend-design/tests/test_validate_design_macro.pyscript4.3 KB
scripts-distinctive-frontend-design/validate_design.pyscript22.2 KB
scripts-html-artifact/assemble-template.pyscript7.5 KB
scripts-html-artifact/css_slop_rules.pyscript15.4 KB
scripts-html-artifact/detect-shape.pyscript7.0 KB
scripts-html-artifact/fill-template.pyscript5.5 KB
scripts-html-artifact/pptx-bridge/__init__.pyscript490 B
scripts-html-artifact/pptx-bridge/_pptx_engine.pyscript26.4 KB
scripts-html-artifact/pptx-bridge/extract_slides.pyscript13.5 KB
scripts-html-artifact/pptx-bridge/render_pptx.pyscript6.9 KB
scripts-html-artifact/pptx-bridge/run-unified.pyscript11.6 KB
scripts-html-artifact/render-github-issues.pyscript7.5 KB
scripts-html-artifact/tests/test_assemble_template.pyscript29.5 KB
scripts-html-artifact/tests/test_css_slop_emission.pyscript7.9 KB
scripts-html-artifact/tests/test_detect_shape.pyscript5.3 KB
scripts-html-artifact/tests/test_fill_template.pyscript5.2 KB
scripts-html-artifact/tests/test_to_pdf.pyscript13.3 KB
scripts-html-artifact/tests/test_validate_artifact.pyscript13.6 KB
scripts-html-artifact/to-pdf.pyscript12.5 KB
scripts-html-artifact/validate-artifact.pyscript11.0 KB
templates/base-reset.cssother1.2 KB
templates/components/collapsible.cssother1.1 KB
templates/components/collapsible.jsscript516 B
templates/components/copy-button.cssother534 B
templates/components/copy-button.jsscript334 B
templates/components/drag-drop.cssother612 B
templates/components/drag-drop.jsscript1.1 KB
templates/components/filter.cssother1.1 KB
templates/components/filter.jsscript987 B
templates/components/keyboard-nav.cssother249 B
templates/components/keyboard-nav.jsscript900 B
templates/components/scrollytelling.cssother1.5 KB
templates/components/scrollytelling.jsscript2.0 KB
templates/components/slider.cssother848 B
templates/components/tabs.cssother770 B
templates/components/tabs.jsscript508 B
templates/components/theme-toggle.cssother1.2 KB
templates/components/theme-toggle.jsscript178 B
templates/fonts/ArchivoBlack-OFL.txtmarkdown4.4 KB
templates/fonts/archivo-black.cssother13.7 KB
templates/print/code-review-print.cssother1.9 KB
templates/print/data-viz-print.cssother1.5 KB
templates/print/deck-print.cssother1.5 KB
templates/print/default-print.cssother1.6 KB
templates/print/diagram-print.cssother1.6 KB
templates/print/editor-print.cssother2.1 KB
templates/print/prototype-print.cssother1.4 KB
templates/print/report-print.cssother1.8 KB
templates/print/spec-print.cssother1.4 KB
templates/saved/README.mdmarkdown1.8 KB
templates/saved/business-review.htmlother17.1 KB
templates/saved/business-review.slots.jsonconfig1.5 KB
templates/saved/github-issues.htmlother34.0 KB
templates/saved/project-kickoff.htmlother17.3 KB
templates/saved/project-kickoff.slots.jsonconfig1.7 KB
templates/saved/system-design.htmlother16.9 KB
templates/saved/system-design.slots.jsonconfig1.6 KB
templates/shapes/code-review.cssother2.7 KB
templates/shapes/data-viz.cssother2.3 KB
templates/shapes/deck.cssother1.9 KB
templates/shapes/diagram.cssother2.7 KB
templates/shapes/editor.cssother2.8 KB
templates/shapes/prototype.cssother2.7 KB
templates/shapes/report.cssother2.9 KB
templates/shapes/spec.cssother3.0 KB
templates/themes/birchline.cssother2.4 KB
templates/themes/dark-focus.cssother2.6 KB
templates/themes/interactive-warm.cssother4.5 KB
templates/themes/minimal-document.cssother2.6 KB

references/design-refs/design-handoff.md

View on GitHub
# Design Handoff Reference

Spec documentation patterns for developer handoff. Every section here represents a category developers need to build from a design without guessing.

---

## Handoff Artifact Checklist

Use this checklist to verify completeness before delivering a spec.

| Category | Artifact | Status |
|----------|----------|--------|
| **Layout** | Grid system documented | |
| | Breakpoints defined | |
| | Responsive behavior per breakpoint | |
| | Content area max-width | |
| **Tokens** | Color tokens mapped to usage | |
| | Typography tokens mapped to elements | |
| | Spacing tokens mapped to gaps/padding | |
| | Elevation tokens mapped to surfaces | |
| | Motion tokens mapped to transitions | |
| **Components** | Component name and variant for each element | |
| | Props/configuration for each instance | |
| | Custom overrides documented | |
| **States** | Default state for all interactive elements | |
| | Hover state | |
| | Focus state (keyboard) | |
| | Active/pressed state | |
| | Disabled state | |
| | Loading state | |
| | Error state | |
| | Selected state (where applicable) | |
| | Empty state | |
| **Interaction** | Click/tap behavior | |
| | Hover behavior (desktop) | |
| | Transitions and animations | |
| | Gesture support (mobile) | |
| | Drag behavior (if applicable) | |
| **Content** | Character limits per field | |
| | Truncation rules (ellipsis, line clamp, fade) | |
| | Empty state content and layout | |
| | Loading state treatment (skeleton, spinner, placeholder) | |
| | Error state content and layout | |
| **Edge Cases** | Minimum content (single item, short text) | |
| | Maximum content (overflow, long text, many items) | |
| | International text (30-40% expansion) | |
| | Slow/offline connection behavior | |
| | Missing/null data handling | |
| | Permission variations (what changes by role) | |
| **Accessibility** | Focus order documented | |
| | ARIA labels and roles specified | |
| | Keyboard interactions defined | |
| | Screen reader announcements noted | |
| | Color contrast verified for all pairings | |

---

## Spec Documentation Patterns

### Layout Specification

| Property | What to Specify | Example |
|----------|----------------|---------|
| Grid | Column count, gutter width, margins | 12-col grid, 24px gutter, 32px margins |
| Max width | Content area maximum | max-width: 1200px, centered |
| Sidebar | Width (fixed or percentage), collapse behavior | 280px fixed, collapses to icon-only at <1024px |
| Stacking order | z-index layers for overlapping elements | nav: 100, dropdown: 200, modal: 300, toast: 400 |
| Overflow | Scroll behavior per container | Content area scrolls independently, sidebar fixed |

### Responsive Behavior Specification

| Breakpoint | Name | Layout Changes |
|-----------|------|---------------|
| >= 1280px | Desktop Large | Full layout, sidebar expanded |
| 1024-1279px | Desktop | Full layout, sidebar collapsed |
| 768-1023px | Tablet | Single column, bottom navigation |
| < 768px | Mobile | Stacked layout, hamburger menu, full-width cards |

For each breakpoint, document:
- What elements reflow, hide, or change behavior
- Touch target size adjustments (44px minimum on touch devices)
- Typography scale changes (if any)
- Spacing adjustments (tighter on mobile)
- Navigation pattern changes

### Token-to-Value Mapping

| Token | Value | Where Used |
|-------|-------|-----------|
| `color-primary` | `#3B82F6` | CTA buttons, active tab, links |
| `color-primary-hover` | `#2563EB` | CTA hover state |
| `color-surface-primary` | `#FFFFFF` | Main background |
| `color-surface-secondary` | `#F9FAFB` | Card backgrounds, alternating rows |
| `color-border-default` | `#E5E7EB` | Card borders, dividers |
| `color-text-primary` | `#111827` | Headings, body text |
| `color-text-secondary` | `#6B7280` | Metadata, helper text |
| `font-heading-lg` | `24px/1.25 Inter 600` | Page titles |
| `font-body` | `16px/1.5 Inter 400` | Body text |
| `font-caption` | `12px/1.5 Inter 400` | Timestamps, badges |
| `spacing-section` | `32px` | Between major sections |
| `spacing-card-padding` | `16px` | Inside cards |
| `radius-card` | `8px` | Card corners |
| `radius-button` | `6px` | Button corners |

**Rule**: Every visual value in the spec references a token. If a value has no token, flag it as "needs token" — this prevents design system drift.

---

## Interaction Documentation

### State Transitions

Document each interactive element as a state machine:

| Element | Trigger | From State | To State | Transition | Notes |
|---------|---------|-----------|----------|-----------|-------|
| CTA Button | Mouse enter | Default | Hover | `background-color 150ms ease` | Darken 10% |
| CTA Button | Mouse down | Hover | Active | `transform 100ms ease` | Scale to 0.98 |
| CTA Button | Click | Active | Loading | `opacity 150ms ease` | Show spinner, disable |
| CTA Button | API success | Loading | Default | Instant | Show success toast |
| CTA Button | API error | Loading | Default | Instant | Show error message |
| Sidebar | Toggle click | Expanded | Collapsed | `width 250ms ease-in-out` | Icons remain visible |
| Modal | Trigger click | Closed | Open | `opacity 250ms ease-out` + backdrop | Focus first element |
| Modal | Escape/backdrop | Open | Closed | `opacity 200ms ease-in` | Return focus to trigger |
| Accordion | Header click | Collapsed | Expanded | `max-height 250ms ease-out` | Scroll into view if needed |

### Gesture Documentation (Mobile)

| Gesture | Element | Action | Threshold | Feedback |
|---------|---------|--------|-----------|----------|
| Swipe left | List item | Reveal delete action | 80px | Red background slides in |
| Swipe right | List item | Reveal archive action | 80px | Green background slides in |
| Pull down | List view | Refresh content | 60px + release | Spinner at top |
| Long press | Card | Enter selection mode | 500ms | Haptic + visual selection indicator |
| Pinch | Image | Zoom in/out | Two fingers | 1x to 3x range, spring back at limits |

---

## Edge Case Documentation

### Content Extremes

| Scenario | How to Handle | Example |
|----------|---------------|---------|
| Empty text field | Show placeholder, not broken layout | "No description provided" in muted text |
| Single character name | Layout holds with minimal content | "A" in avatar, card width unchanged |
| 200-character name | Truncate with ellipsis | "Alexandra Constantino..." at max-width |
| 0 items in list | Show empty state with CTA | Illustration + "No items yet" + [Create first item] |
| 1 item in list | Layout works with single item | Same card layout, no "showing 1 of 1" |
| 10,000 items | Virtualized list or pagination | Show first 50, load more on scroll |
| Mixed content lengths | Consistent card height or flexible grid | Cards align to grid regardless of content |

### Data States

| State | Visual Treatment | Content |
|-------|-----------------|---------|
| Loading (initial) | Skeleton placeholders matching content shape | No text, pulsing gray rectangles |
| Loading (more) | Spinner at bottom of list | Existing content visible |
| Loading (action) | Button spinner, disabled state | "Saving..." text optional |
| Error (page) | Full-page error with retry | "Something went wrong. [Try again]" |
| Error (inline) | Inline error below the failing element | Specific error message + fix suggestion |
| Error (toast) | Toast notification | Brief error + action if applicable |
| Offline | Banner at top of page | "You're offline. Changes will sync when you reconnect." |
| Stale data | Subtle indicator | "Last updated 5 min ago. [Refresh]" |

### Internationalization

| Factor | Spec Requirement |
|--------|-----------------|
| Text expansion | All text containers handle 40% longer strings |
| Number formatting | Use locale-aware formatting (`1,234.56` vs `1.234,56`) |
| Date formatting | Use locale-aware dates (use date formatting libraries instead of hardcoded month names) |
| RTL support | Layout mirrors for RTL locales (flex-direction, text-align, icon placement) |
| Currency | Symbol position varies by locale (`$100` vs `100 $`) |
| Pluralization | Support plural rules beyond singular/plural (some languages have 6 forms) |

---

## Developer Q&A Template

Include with every handoff spec. Pre-answer the questions developers always ask.

| Question | Answer |
|----------|--------|
| What component library/framework? | [React / Vue / Angular / SwiftUI / etc.] |
| Which design tokens file? | [Path or URL to tokens] |
| Where do I find the icons? | [Icon library + specific icon names used] |
| What happens when [element] overflows? | [Truncation rule, scroll behavior, or wrap behavior] |
| What are the loading states? | [Per-element loading treatment] |
| What happens on error? | [Error display strategy per context] |
| What animations are needed? | [Token references, durations, easings] |
| Is there a mobile-specific behavior? | [Per-breakpoint differences] |
| What's the focus order? | [Tab order specification] |
| What ARIA attributes are needed? | [Per-component ARIA spec] |
| Where does the data come from? | [API endpoint or data source for each dynamic element] |
| What are the permission levels? | [What changes based on user role] |
| What are the feature flags? | [Any conditional rendering based on flags] |

---

## Handoff Quality Checks

Before delivering, verify:

| Check | Method |
|-------|--------|
| Every interactive element has all states | Cross-reference against state checklist |
| Token references used throughout | Search for raw hex/px values — flag any found |
| Responsive behavior explicit | Each breakpoint has documented changes |
| Edge cases documented | Empty, loading, error, overflow, missing data all addressed |
| Accessibility requirements stated | Focus order, ARIA, keyboard, screen reader all specified |
| Developer questions pre-answered | Q&A template filled out |
| Content specs complete | Character limits, truncation rules, placeholder text defined |
| Animation specs include token references | Duration and easing use token names |
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall