Token导航 LogoToken导航TokenDH.com
研究检索只读github未标认证来源可访问许可证需确认审计提醒

modern-web-design现代网页设计

Agent Skill

用于辅助界面设计、视觉规范、排版、配色、布局和交互体验优化。它适合让 Agent 根据产品场景整理页面结构、生成 UI 方案、检查视觉一致性或改进组件层级。使用时需要结合现有品牌、设计系统和用户任务,不应只堆装饰元素;涉及真实页面改动时,应通过截图或浏览器预览检查文本溢出、对齐和响应式表现。

总安装

9,504

周安装

379

GitHub Stars

61

下载量

3,328
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:modern-web-design(现代网页设计)
来源仓库:https://github.com/freshtechbro/claudedesignskills
仓库路径:skills/modern-web-design
安装命令:
npx skills add https://github.com/freshtechbro/claudedesignskills --skill modern-web-design
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/freshtechbro/claudedesignskills --skill modern-web-design

简介

用于辅助界面设计、视觉规范和交互体验优化,支持页面结构整理和 UI 方案生成。

  • 适用于 Codex、Claude、Cursor、Gemini CLI 等宿主环境,帮助改进组件层级和视觉一致性。
  • 使用时需要结合品牌、设计系统和用户任务,避免只堆装饰元素;涉及页面改动应通过预览检查效果。
  • 建议配合截图或浏览器预览确认文本溢出、对齐和响应式表现,确保设计落地准确。
  • modern-web-design 属于研究检索类 Skill,可作为该场景下的辅助能力补充。

SKILL.md

Modern Web Design

Overview

Modern web design in 2024-2025 emphasizes performance, accessibility, and meaningful interactions. This skill provides comprehensive guidance on current design trends, implementation patterns, and best practices for creating engaging, accessible, and performant web experiences.

This meta-skill synthesizes knowledge from all animation, interaction, and 3D skills in this repository to provide holistic design guidance.

Core Design Principles (2024-2025)

1. Performance-First Design

Philosophy: Design decisions should prioritize Core Web Vitals and user experience on all devices.

Key Metrics:

  • Largest Contentful Paint (LCP): < 2.5s
  • First Input Delay (FID): < 100ms
  • Cumulative Layout Shift (CLS): < 0.1
  • Interaction to Next Paint (INP): < 200ms

Implementation Guidelines:

  • Defer non-critical animations until after page load
  • Use CSS transforms/opacity for animations (GPU-accelerated)
  • Implement lazy loading for images, videos, and 3D content
  • Progressive enhancement: core content without JavaScript

Related Skills: gsap-scrolltrigger, motion-framer, lottie-animations for optimized animations

2. Bold Minimalism

Characteristics:

  • Large, impactful typography (clamp() for fluid sizing)
  • Ample white space (negative space as design element)
  • Limited color palettes (3-5 primary colors)
  • Intentional use of bold accent colors
  • Geometric shapes and clean lines

Typography Scale (Modern fluid system):

/* Fluid typography using clamp() */
--font-size-xs: clamp(0.75rem, 0.7rem + 0.25vw, 0.875rem);
--font-size-sm: clamp(0.875rem, 0.8rem + 0.375vw, 1rem);
--font-size-base: clamp(1rem, 0.9rem + 0.5vw, 1.25rem);
--font-size-lg: clamp(1.25rem, 1.1rem + 0.75vw, 1.75rem);
--font-size-xl: clamp(1.75rem, 1.5rem + 1.25vw, 2.5rem);
--font-size-2xl: clamp(2.5rem, 2rem + 2.5vw, 4rem);
--font-size-3xl: clamp(3.5rem, 2.5rem + 5vw, 6rem);

Color System (Accessibility-first):

/* WCAG AAA compliant color system */
--color-primary: oklch(50% 0.2 250); /* Blue */
--color-accent: oklch(65% 0.25 30);  /* Coral */
--color-neutral-50: oklch(98% 0 0);
--color-neutral-900: oklch(20% 0 0);
/* Contrast ratio: minimum 7:1 for text */

Related Skills: animated-component-libraries for UI components

3. Micro-Interactions

Definition: Small, purposeful animations that provide feedback, guide users, and enhance perceived performance.

Categories:

a) Hover States (Desktop):

  • Scale transformations (1.05-1.1x)
  • Color transitions (200-300ms)
  • Shadow depth changes
  • Cursor transformations

b) Loading States:

  • Skeleton screens (better than spinners)
  • Progressive image loading (blur-up technique)
  • Optimistic UI updates
  • Staggered content reveals

c) Interactive Feedback:

  • Button press states (scale down 0.95x)
  • Toggle switches with spring physics
  • Form field validation (immediate, kind feedback)
  • Success/error states with motion

Implementation Example (Framer Motion):

// Button with micro-interaction
<motion.button
  whileHover={{ scale: 1.05, y: -2 }}
  whileTap={{ scale: 0.95 }}
  transition={{ type: "spring", stiffness: 400, damping: 17 }}
>
  Click me
</motion.button>

Related Skills: motion-framer, react-spring-physics, animejs for micro-interactions

4. Scrollytelling

Definition: Narrative-driven experiences where content reveals and transforms as the user scrolls.

Patterns:

a) Scroll-Triggered Reveals:

  • Fade-in on scroll entry (with offset)
  • Slide-in from sides with stagger
  • Scale + opacity transitions
  • Clip-path reveals

b) Scroll-Linked Animations:

  • Parallax layers (different scroll speeds)
  • Horizontal scrolling sections
  • Pinned sections with scrubbing animations
  • 3D object rotation tied to scroll

c) Progress Indicators:

  • Reading progress bars
  • Step-by-step visual guides
  • Animated SVG paths following scroll

Implementation Example (GSAP ScrollTrigger):

// Scroll-linked 3D rotation
gsap.to(".cube", {
  scrollTrigger: {
    trigger: ".section",
    start: "top top",
    end: "bottom top",
    scrub: 1, // Smooth scrubbing
  },
  rotationY: 360,
  ease: "none"
});

Related Skills: gsap-scrolltrigger, locomotive-scroll, scroll-reveal-libraries, react-three-fiber for 3D scrollytelling

5. Cursor UX

Evolution: Custom cursors that enhance interaction and provide contextual feedback.

Patterns:

a) Custom Cursor Shapes:

  • Circle/dot followers (delayed with easing)
  • Text-based cursors ("View", "Drag", "Click")
  • Blend modes for visual interest
  • Scale/morph on hover

b) Contextual Transformations:

  • Expand on links/buttons
  • Magnetic attraction to interactive elements
  • Color inversion over images
  • Custom icons for actions (play, zoom, expand)

c) Performance Considerations:

  • Use CSS transforms only (no top/left)
  • RequestAnimationFrame for JS cursors
  • Disable on mobile/touch devices
  • Respect prefers-reduced-motion

Implementation Example:

// Simple smooth cursor follower
const cursor = document.querySelector('.cursor');
let mouseX = 0, mouseY = 0;
let cursorX = 0, cursorY = 0;

document.addEventListener('mousemove', (e) => {
  mouseX = e.clientX;
  mouseY = e.clientY;
});

function updateCursor() {
  // Smooth easing
  cursorX += (mouseX - cursorX) * 0.1;
  cursorY += (mouseY - cursorY) * 0.1;

  cursor.style.transform = `translate(${cursorX}px, ${cursorY}px)`;
  requestAnimationFrame(updateCursor);
}
updateCursor();

Related Skills: gsap-scrolltrigger (for easing), motion-framer (for React cursor components)

6. Glassmorphism & Depth

Characteristics:

  • Frosted glass effect (backdrop-filter)
  • Layered UI with depth hierarchy
  • Subtle shadows and borders
  • Translucent backgrounds

Modern Glassmorphism (2024):

.glass-card {
  background: rgba(255, 255, 255, 0.1);
  backdrop-filter: blur(10px) saturate(180%);
  border: 1px solid rgba(255, 255, 255, 0.2);
  box-shadow: 0 8px 32px rgba(0, 0, 0, 0.1);
  border-radius: 16px;
}

Depth System (Layering):

/* Elevation scale */
--elevation-1: 0 1px 3px rgba(0,0,0,0.12);
--elevation-2: 0 4px 8px rgba(0,0,0,0.15);
--elevation-3: 0 8px 16px rgba(0,0,0,0.18);
--elevation-4: 0 16px 32px rgba(0,0,0,0.2);

Related Skills: animated-component-libraries for glassmorphic components

7. AI-Enhanced Personalization

Patterns:

a) Adaptive Content:

  • Dynamic layout based on user behavior
  • Personalized content recommendations
  • Adaptive color schemes (system preference + user history)
  • Smart defaults based on context

b) Intelligent Interactions:

  • Predictive search with instant results
  • Smart form completion
  • Context-aware suggestions
  • Progressive disclosure based on usage

c) Performance + Privacy:

  • Client-side personalization (localStorage, IndexedDB)
  • Edge computing for fast personalization
  • Privacy-preserving analytics
  • Transparent data usage

Implementation Considerations:

  • Fallback to default experience
  • No layout shift from personalization
  • Respect "Do Not Track"
  • GDPR/CCPA compliance

Common Design Patterns

Pattern 1: Immersive Hero Section

Use Case: Landing pages, product launches, portfolio sites

Characteristics:

  • Full viewport height
  • Subtle 3D background or animated gradient
  • Large headline with fluid typography
  • Smooth scroll indicator
  • Parallax on scroll exit

Implementation (Combined approach):

HTML Structure:

<section class="hero">
  <div id="bg-canvas"></div>
  <div class="hero__content">
    <h1 class="hero__title">Modern Design</h1>
    <p class="hero__subtitle">Performance meets beauty</p>
    <button class="hero__cta">Explore</button>
  </div>
  <div class="scroll-indicator">
    <span>Scroll</span>
  </div>
</section>

Technologies:

  • Background: Vanta.js WAVES effect (lightweight-3d-effects)
  • Text animation: GSAP SplitText with stagger (gsap-scrolltrigger)
  • Button: Framer Motion hover states (motion-framer)
  • Scroll indicator: CSS animation + GSAP fade out on scroll

Related Skills: lightweight-3d-effects, gsap-scrolltrigger, motion-framer

Pattern 2: Horizontal Scroll Gallery

Use Case: Portfolio work, product showcases, case studies

Implementation (GSAP ScrollTrigger):

gsap.to(".gallery__track", {
  x: () => -(document.querySelector(".gallery__track").scrollWidth - window.innerWidth),
  ease: "none",
  scrollTrigger: {
    trigger: ".gallery",
    pin: true,
    scrub: 1,
    end: () => "+=" + document.querySelector(".gallery__track").scrollWidth
  }
});

Enhancements:

  • Lazy load images as they scroll into view
  • Parallax within cards
  • Scale transformation on active card
  • Smooth momentum scrolling with Locomotive

Related Skills: gsap-scrolltrigger, locomotive-scroll

Pattern 3: 3D Product Viewer

Use Case: E-commerce, product marketing, showcases

Implementation (React Three Fiber):

import { Canvas } from '@react-three/fiber'
import { OrbitControls, useGLTF } from '@react-three/drei'

function ProductViewer() {
  return (
    <Canvas camera={{ position: [0, 0, 5], fov: 50 }}>
      <ambientLight intensity={0.5} />
      <spotLight position={[10, 10, 10]} angle={0.15} />
      <Product />
      <OrbitControls
        enableZoom={false}
        autoRotate
        autoRotateSpeed={2}
      />
    </Canvas>
  )
}

Enhancements:

  • Material variants (color picker)
  • Hotspots with annotations
  • AR mode on mobile
  • Screenshot/share functionality

Related Skills: react-three-fiber, threejs-webgl, model-viewer-component

Pattern 4: Animated Data Visualization

Use Case: Dashboards, analytics, infographics

Patterns:

  • Count-up animations on scroll into view
  • Animated chart reveals (progress bars, pie charts)
  • Staggered grid animations
  • Particle backgrounds representing data

Implementation (Framer Motion + IntersectionObserver):

function AnimatedStat({ end, label }) {
  const [count, setCount] = useState(0);
  const ref = useRef();
  const isInView = useInView(ref, { once: true });

  useEffect(() => {
    if (isInView) {
      // Count up animation
      const duration = 2000;
      const steps = 60;
      const increment = end / steps;
      let current = 0;

      const timer = setInterval(() => {
        current += increment;
        if (current >= end) {
          setCount(end);
          clearInterval(timer);
        } else {
          setCount(Math.floor(current));
        }
      }, duration / steps);
    }
  }, [isInView, end]);

  return (
    <motion.div
      ref={ref}
      initial={{ opacity: 0, y: 20 }}
      animate={isInView ? { opacity: 1, y: 0 } : {}}
      transition={{ duration: 0.6 }}
    >
      <h2>{count}+</h2>
      <p>{label}</p>
    </motion.div>
  );
}

Related Skills: motion-framer, pixijs-2d for canvas-based visualizations

Pattern 5: Page Transitions

Use Case: Multi-page apps, portfolio sites, storytelling experiences

Implementation (Barba.js + GSAP):

barba.init({
  transitions: [{
    name: 'slide',
    leave(data) {
      return gsap.to(data.current.container, {
        xPercent: -100,
        duration: 0.5
      });
    },
    enter(data) {
      return gsap.from(data.next.container, {
        xPercent: 100,
        duration: 0.5
      });
    }
  }]
});

Modern Alternatives:

  • View Transitions API (Chrome 111+, progressive enhancement)
  • Framer Motion's AnimatePresence for React SPAs
  • Shared element transitions

Related Skills: barba-js, gsap-scrolltrigger, motion-framer

Pattern 6: Interactive Cursor Effects

Use Case: Creative agencies, portfolios, interactive experiences

Patterns:

  • Text cursor that follows with delay
  • Magnetic buttons (cursor attracted to elements)
  • Blend mode cursor (inverts colors)
  • Cursor that reveals content

Implementation (Vanilla JS + GSAP):

const links = document.querySelectorAll('a');
const cursor = document.querySelector('.cursor');

links.forEach(link => {
  link.addEventListener('mouseenter', () => {
    gsap.to(cursor, {
      scale: 2,
      duration: 0.3,
      ease: "power2.out"
    });
  });

  link.addEventListener('mouseleave', () => {
    gsap.to(cursor, {
      scale: 1,
      duration: 0.3,
      ease: "power2.out"
    });
  });
});

Related Skills: gsap-scrolltrigger, motion-framer

Pattern 7: Staggered Content Reveals

Use Case: Feature sections, testimonials, team grids

Implementation (Framer Motion variants):

const container = {
  hidden: { opacity: 0 },
  show: {
    opacity: 1,
    transition: {
      staggerChildren: 0.1
    }
  }
};

const item = {
  hidden: { opacity: 0, y: 20 },
  show: { opacity: 1, y: 0 }
};

function FeatureGrid() {
  return (
    <motion.div
      variants={container}
      initial="hidden"
      whileInView="show"
      viewport={{ once: true, amount: 0.3 }}
      className="grid"
    >
      {features.map((feature, i) => (
        <motion.div key={i} variants={item}>
          {feature}
        </motion.div>
      ))}
    </motion.div>
  );
}

Related Skills: motion-framer, gsap-scrolltrigger, scroll-reveal-libraries

Integration with Other Skills

Animation Skills Integration

GSAP ScrollTrigger (gsap-scrolltrigger):

  • Use for scroll-driven storytelling
  • Pin sections for multi-step reveals
  • Scrub animations tied to scroll position
  • Batch animations for performance

Framer Motion (motion-framer):

  • React component animations
  • Page transitions with AnimatePresence
  • Gesture-based interactions (drag, hover, tap)
  • Layout animations (shared element transitions)

React Spring (react-spring-physics):

  • Physics-based animations (more natural feel)
  • Interactive springs (drag, pull)
  • Trail animations (sequential reveals)
  • Use for UI feedback that feels "real"

Anime.js (animejs):

  • SVG path animations (line drawing)
  • SVG morphing transitions
  • Stagger grid animations
  • Timeline-based sequences

Lottie (lottie-animations):

  • Complex designer-created animations
  • Icon animations and micro-interactions
  • Loading states
  • Scroll-driven playback

3D Skills Integration

Three.js (threejs-webgl):

  • Custom 3D scenes and experiences
  • Shader effects and post-processing
  • WebGL-based particle systems
  • Advanced lighting and materials

React Three Fiber (react-three-fiber):

  • 3D in React applications
  • Product viewers and configurators
  • Interactive 3D UI components
  • Scroll-driven 3D animations

Babylon.js (babylonjs-engine):

  • Physics-based 3D experiences
  • VR/XR applications
  • Game-like interactions
  • PBR materials for realism

Lightweight 3D (lightweight-3d-effects):

  • Background effects (Vanta.js)
  • Subtle 3D illustrations (Zdog)
  • Tilt effects (Vanilla-Tilt)
  • Performance-friendly 3D accents

Component Libraries

Animated Components (animated-component-libraries):

  • Magic UI components (backgrounds, text effects)
  • Pre-built interactive components
  • Design system foundations
  • Rapid prototyping

Scroll Reveals (scroll-reveal-libraries):

  • Simple fade/slide on scroll
  • AOS library integration
  • Lightweight alternative to ScrollTrigger
  • Quick implementation for basic reveals

Accessibility Best Practices

1. Motion & Animation

Respect User Preferences:

@media (prefers-reduced-motion: reduce) {
  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
    scroll-behavior: auto !important;
  }
}

JavaScript Detection:

const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;

if (prefersReducedMotion) {
  // Disable or simplify animations
  gsap.config({ nullTargetWarn: false });
  // Skip scroll animations, use instant reveals
}

2. Color Contrast

WCAG AAA Standards:

  • Normal text: 7:1 contrast ratio
  • Large text (18pt+): 4.5:1 contrast ratio
  • Use OKLCH color space for perceptual uniformity

Testing:

// Check contrast ratio
function getContrastRatio(color1, color2) {
  const l1 = getLuminance(color1);
  const l2 = getLuminance(color2);
  const lighter = Math.max(l1, l2);
  const darker = Math.min(l1, l2);
  return (lighter + 0.05) / (darker + 0.05);
}

3. Keyboard Navigation

Requirements:

  • All interactive elements focusable
  • Visible focus indicators (not outline: none)
  • Logical tab order
  • Skip links for long navigation
  • Escape key closes modals/overlays

Focus Styles (Modern):

:focus-visible {
  outline: 3px solid var(--color-accent);
  outline-offset: 2px;
  border-radius: 4px;
}

/* Remove focus ring for mouse users */
:focus:not(:focus-visible) {
  outline: none;
}

4. Screen Reader Support

Semantic HTML:

  • Use proper heading hierarchy (h1-h6)
  • Landmark regions (header, nav, main, footer)
  • aria-labels for icon buttons
  • aria-live regions for dynamic content

Animation Announcements:

<!-- Announce when content loads -->
<div role="status" aria-live="polite" aria-atomic="true">
  Loading complete. 12 items displayed.
</div>

5. Touch Targets

Minimum Size: 44x44px (iOS), 48x48px (Android)

Spacing: Minimum 8px between touch targets

Implementation:

.button {
  min-height: 44px;
  min-width: 44px;
  padding: 12px 24px;
  /* Tap target includes padding */
}

Performance Optimization

1. Animation Performance

60 FPS Checklist:

  • Use CSS transforms (translateX/Y/Z, scale, rotate) - GPU accelerated
  • Use opacity for fades - GPU accelerated
  • Avoid: top/left, width/height, margin, padding animations
  • Use will-change sparingly (memory cost)
  • RequestAnimationFrame for JS animations

GSAP Performance:

// Force GPU acceleration
gsap.set(element, { force3D: true });

// Use will-change during animation only
gsap.to(element, {
  x: 100,
  onStart: () => element.style.willChange = 'transform',
  onComplete: () => element.style.willChange = 'auto'
});

2. Loading Strategies

Critical Path:

  • Inline critical CSS (above-the-fold)
  • Defer non-critical CSS
  • Async JavaScript loading
  • Preload fonts and hero images

Progressive Enhancement:

<!-- Load essential styles first -->
<style>
  /* Critical CSS inlined */
</style>

<!-- Defer non-critical styles -->
<link rel="preload" href="animations.css" as="style" onload="this.onload=null;this.rel='stylesheet'">
<noscript><link rel="stylesheet" href="animations.css"></noscript>

3. Image Optimization

Modern Formats:

<picture>
  <source srcset="image.avif" type="image/avif">
  <source srcset="image.webp" type="image/webp">
  <img src="image.jpg" alt="Description" loading="lazy">
</picture>

Responsive Images:

<img
  srcset="image-400.jpg 400w,
          image-800.jpg 800w,
          image-1200.jpg 1200w"
  sizes="(max-width: 640px) 100vw,
         (max-width: 1024px) 50vw,
         33vw"
  src="image-800.jpg"
  alt="Description"
  loading="lazy"
>

4. 3D Content Optimization

Loading Strategy:

  • Show placeholder while loading
  • Load low-poly model first
  • Progressive enhancement with high-poly
  • Lazy load 3D scenes below fold

Runtime Performance:

  • Use object pooling
  • Implement LOD (Level of Detail)
  • Frustum culling
  • Texture compression (Basis Universal)

Related Skills: threejs-webgl, react-three-fiber, babylonjs-engine

5. JavaScript Bundle Size

Code Splitting:

// Dynamic imports
const AnimationModule = lazy(() => import('./animations'));

// Route-based splitting
const Gallery = lazy(() => import('./pages/Gallery'));

Tree Shaking:

  • Use ES6 imports
  • Import only what you need
  • Use modern build tools (Vite, esbuild)

Common Pitfalls

Pitfall 1: Over-Animation

Problem: Too many animations distract from content and hurt performance.

Solution:

  • Limit animations to meaningful interactions
  • Use animation to guide attention, not demand it
  • Follow the principle: "Animation with purpose"
  • Measure performance impact (Chrome DevTools Performance tab)

Rule of Thumb: If you can't explain why an animation exists, remove it.

Pitfall 2: Ignoring Mobile Performance

Problem: Animations work on desktop but lag on mobile devices.

Solution:

  • Test on real devices (not just simulators)
  • Reduce animation complexity on mobile
  • Disable expensive effects (parallax, 3D) on low-end devices
  • Use matchMedia for device-specific experiences
const isLowEndDevice = () => {
  return /Android|webOS|iPhone|iPad|iPod|BlackBerry/i.test(navigator.userAgent) &&
         navigator.hardwareConcurrency < 4;
};

if (isLowEndDevice()) {
  // Simplify or disable animations
}

Pitfall 3: Missing Fallbacks

Problem: Experience breaks without JavaScript or on older browsers.

Solution:

  • Progressive enhancement mindset
  • Core content accessible without JS
  • Feature detection before using modern APIs
  • Polyfills for critical features
// Feature detection
if ('IntersectionObserver' in window) {
  // Use scroll-triggered animations
} else {
  // Show content immediately
}

Pitfall 4: Accessibility Oversight

Problem: Forgetting keyboard users, screen readers, or motion-sensitive users.

Solution:

  • Test with keyboard only
  • Test with screen reader (NVDA, VoiceOver)
  • Always check prefers-reduced-motion
  • Use semantic HTML
  • Maintain proper focus management

Checklist:

  • All interactive elements keyboard accessible
  • Focus indicators visible
  • Color contrast meets WCAG AAA
  • Motion can be disabled
  • Screen reader announcements make sense

Pitfall 5: Ignoring Loading States

Problem: Blank screen or layout shifts during content load.

Solution:

  • Skeleton screens for predictable layouts
  • Smooth loading transitions
  • Reserve space for dynamic content
  • Show meaningful loading indicators
// Skeleton screen pattern
function ProductCard({ loading, data }) {
  if (loading) {
    return (
      <div className="skeleton">
        <div className="skeleton__image" />
        <div className="skeleton__title" />
        <div className="skeleton__price" />
      </div>
    );
  }

  return <ProductCardContent data={data} />;
}

Pitfall 6: Scroll Hijacking

Problem: Overriding native scroll behavior frustrates users.

Solution:

  • Preserve browser's native scroll (momentum, keyboard)
  • Use ScrollTrigger/Locomotive without changing scroll physics
  • Allow users to scroll at their own pace
  • Never disable scroll entirely
  • Avoid scroll-jacking for full-page sections

Good Practice: Enhance scroll, don't replace it.

Design System Architecture

Token Structure

Modern Design Tokens (CSS Custom Properties):

:root {
  /* Colors - OKLCH for perceptual uniformity */
  --color-primary: oklch(50% 0.2 250);
  --color-accent: oklch(65% 0.25 30);

  /* Spacing - Consistent scale */
  --space-2xs: clamp(0.25rem, 0.2rem + 0.25vw, 0.375rem);
  --space-xs: clamp(0.5rem, 0.4rem + 0.5vw, 0.75rem);
  --space-sm: clamp(0.75rem, 0.6rem + 0.75vw, 1.125rem);
  --space-md: clamp(1rem, 0.8rem + 1vw, 1.5rem);
  --space-lg: clamp(1.5rem, 1.2rem + 1.5vw, 2.25rem);
  --space-xl: clamp(2rem, 1.6rem + 2vw, 3rem);
  --space-2xl: clamp(3rem, 2.4rem + 3vw, 4.5rem);

  /* Typography - Fluid scale */
  --font-size-base: clamp(1rem, 0.9rem + 0.5vw, 1.25rem);

  /* Animation - Consistent timing */
  --duration-fast: 150ms;
  --duration-normal: 250ms;
  --duration-slow: 400ms;

  /* Easing - Natural motion */
  --ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
  --ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);
}

Component Architecture

Atomic Design (Brad Frost):

  1. Atoms: Buttons, inputs, labels
  2. Molecules: Form fields, cards
  3. Organisms: Navigation, hero sections
  4. Templates: Page layouts
  5. Pages: Specific instances

Related Skills: animated-component-libraries for component patterns

Resources

This skill references the following skills for implementation:

Animation & Interaction

  • gsap-scrolltrigger - Scroll-driven animations, pinning, scrubbing
  • motion-framer - React animations, gestures, layout animations
  • react-spring-physics - Physics-based animations
  • animejs - SVG animations, stagger effects
  • lottie-animations - Designer-created animations
  • scroll-reveal-libraries - Simple scroll reveals (AOS)

3D & WebGL

  • threejs-webgl - Custom 3D scenes and effects
  • react-three-fiber - 3D in React applications
  • babylonjs-engine - Physics-based 3D, VR/XR
  • lightweight-3d-effects - Vanta.js backgrounds, Zdog illustrations

Page Transitions & Scroll

  • barba-js - Page transitions
  • locomotive-scroll - Smooth scrolling

Component Libraries

  • animated-component-libraries - Magic UI, React Bits
  • pixijs-2d - Canvas-based 2D graphics

Detailed References

See the references/ directory for in-depth documentation:

  • design_trends_2024.md - Current web design trends and forecasts
  • interaction_patterns.md - Comprehensive micro-interaction catalog
  • accessibility_guide.md - WCAG compliance patterns and testing
  • performance_checklist.md - Optimization strategies and metrics

Scripts

The scripts/ directory includes tools for implementing design patterns:

  • pattern_generator.py - Generate design pattern boilerplate
  • design_audit.py - Audit existing designs for compliance

Assets

The assets/ directory contains design system templates and starter files. See assets/README.md for details.

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Codex

38.05%
按下载量换算1,266

Claude

28.53%
按下载量换算949

Cursor

21.21%
按下载量换算706

Gemini CLI

8.55%
按下载量换算285

安全审计

Gen Agent Trust Hub

通过

Socket

可疑

Snyk

通过

权限和风险

只读

该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在 warning/failed 结果,不能写成本站确认安全。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills