build-awwwards-quality-sites

Builds motion-rich marketing and portfolio websites with GSAP, smooth scrolling, and optional Three.js shaders.

Updated May 5, 2026
One-click install
npx skills add https://github.com/josippapez/ai-setup --skill build-awwwards-quality-sites-josippapez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-awwwards-quality-sites
Source: https://github.com/josippapez/ai-setup/tree/main/claude/plugins/better-design/skills/build-awwwards-quality-sites
Command: npx skills add https://github.com/josippapez/ai-setup --skill build-awwwards-quality-sites-josippapez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Generic AI-generated websites often look templated, use dishonest placeholder assets, and ship broken motion or accessibility. This Skill enforces a disciplined art-direction, asset, motion, and validation workflow so marketing, editorial, portfolio, and landing pages reach a distinctive, cohesive quality bar. ## Core Features & Use Cases - Art Direction First: Defines a visual thesis, type hierarchy, color system, and motion narrative before any code is written, extracting only high-level traits from user references without copying them. - Honest Asset System: Mandates original or properly licensed imagery, real photo avatars, Solar icons via Iconify, and truthful logo usage with provenance tracking. - Choreographed Motion: Uses GSAP with exactly one smooth-scroll engine (Lenis or Locomotive Scroll), word-by-word heading reveals, and full prefers-reduced-motion fallbacks. - Purposeful Three.js: Adds WebGL shaders only when they serve the concept, with DPR caps, disposal of GPU resources, and static poster fallbacks. - Use Case: A founder asks for a cinematic product landing page; the Skill produces a complete semantic page with a composed hero intro, scroll-choreographed sections, accessible split text, and a validated production build. ## Quick Start Ask the agent to build an Awwwards-quality landing page for your product with a motion-rich hero and scroll-driven section reveals.

Frequently Asked Questions about build-awwwards-quality-sites

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build an Awwwards-quality website with AI?

Start with a written art direction covering visual thesis, typography, color, and motion narrative before coding. Then build a composed GSAP hero intro, choreograph sections with ScrollTrigger, and validate the production build, keyboard navigation, and reduced-motion behavior before handoff.

Lenis vs Locomotive Scroll for smooth scrolling with GSAP?

Evaluate both for the project, then choose exactly one as the sole smooth-scroll engine and connect it to GSAP ScrollTrigger. Never install or initialize both, refresh measurements after media and font changes, and destroy the engine during cleanup.

When should I add Three.js shaders to a landing page?

Add Three.js only when spatial depth, texture transition, displacement, or pointer response materially supports the art direction, never as ornamental background. Cap device pixel ratio, pause offscreen rendering, dispose all GPU resources, and provide a static poster fallback.

How do I keep staggered text animations accessible?

Preserve an unsplit accessible name for staggered headings and hide decorative split words from assistive technology. Never split links or meaningful inline markup, and keep the unsplit content visible when JavaScript is unavailable.

Can I use AI-generated images and logos on marketing sites?

Use original generated or appropriately licensed imagery with provenance recorded, and photographs for every avatar rather than illustrated heads. Use Iconify SVG Logos only for real companies in truthful contexts and Logo Ipsum only for disclosed fictional brands.

What happens to animations when users prefer reduced motion?

Under prefers-reduced-motion, bypass smooth scrolling and scrubbed timelines entirely and render final states immediately rather than shortening animations. Replace WebGL canvases with a static poster and ensure the first frame is complete without JavaScript.