AGENT SKILL

super-frontend-design

Master frontend UI/UX design and development skill combining the top 10 validated skills. Covers anti-generic strategy, Next.js 16 + Tailwind v4 tech stack, design systems, component architecture, Vercel-grade performance, WCAG AAA accessibility, visual storytelling, and end-to-end quality assurance for production-grade web experiences.

License 许可
MIT
最近更新
2026-06-24
Stars
★ 0
Forks
0

01 前言 Front Matter

name
super-frontend-design
license
MIT
version
1.0.0
description
Master frontend UI/UX design and development skill combining the top 10 validated skills. Covers anti-generic strategy, Next.js 16 + Tailwind v4 tech stack, design systems, component architecture, Vercel-grade performance, WCAG AAA accessibility, visual storytelling, and end-to-end quality assurance for production-grade web experiences.
allowed-tools
Read, Write, Edit, Glob, Grep, Bash, SearchWeb, FetchURL

02 资源文件 17

03 SKILL.md 正文

Super Frontend Design (Master Skill)

Meticulously combined from 10 top-tier frontend skills
Philosophy: Anti-Generic Mandate • Intentionality First • Performance by Default • Accessibility as Law
Coverage: Strategy → Design → Development → QA → Delivery


When to Use This Skill

Trigger Phrases (Combined from all 10 source skills):

  • "create a beautiful website" / "design a landing page" / "build a luxury UI"
  • "make it distinctive" / "avoid generic design" / "avant-garde UI"
  • "build React/TypeScript app" / "Next.js 16 project" / "Tailwind v4 migration"
  • "optimize performance" / "eliminate waterfalls" / "reduce bundle size"
  • "review UI" / "check accessibility" / "audit design" / "WCAG compliance"
  • "set up monorepo" / "add RemixIcon" / "implement shadcn/ui"
  • "create aesthetic interfaces" / "generate design images" / "add micro-interactions"
  • "mobile nav not working" / "debug Tailwind v4" / "security audit"

Use Cases:

  1. Building new frontend projects from scratch (luxury, SaaS, e-commerce, portfolios)
  2. Migrating legacy projects to modern stacks (Tailwind v3→v4, Next.js 15→16)
  3. Conducting full-stack performance audits (57 Vercel rules + OWASP 2025)
  4. Creating accessible, WCAG AAA compliant interfaces (ADA Title II ready)
  5. Implementing strategic, anti-generic design systems with intentional branding
  6. Setting up monorepos with Turborepo + shared component libraries
  7. Debugging production issues (mobile nav, visual discrepancies, animation failures)

Core Pillars (8 Unified Modules)

┌─────────────────────────────────────────────────────────────────────┐
│           SUPER-FRONTEND-DESIGN MASTER ARCHITECTURE                 │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  1. PHILOSOPHY & STRATEGY                                          │
│     Anti-Generic Mandate • Strategic Positioning • Intentionality   │
│     Source Skills: avant-garde-design-v4, aesthetic, frontend-design│
│                                                                     │
│  2. TECH STACK & SETUP                                              │
│     Next.js 16 • Tailwind v4 • React 19 • TypeScript 5.9+          │
│     Source Skills: nextjs16-tailwind4, frontend-development, web-frameworks │
│                                                                     │
│  3. DESIGN SYSTEM                                                   │
│     Typography • Color (OKLCH) • Spacing • Container Queries        │
│     Source Skills: tailwind-patterns, frontend-design, avant-garde-design-v4 │
│                                                                     │
│  4. COMPONENT ARCHITECTURE                                          │
│     shadcn/ui • Radix UI • MUI v7 • Feature-Based Organization     │
│     Source Skills: ui-styling, frontend-development, web-frameworks │
│                                                                     │
│  5. PERFORMANCE OPTIMIZATION                                        │
│     57 Vercel Rules • Waterfall Elimination • Budget Tracking        │
│     Source Skills: nextjs-react-expert, nextjs16-tailwind4, web-frameworks │
│                                                                     │
│  6. ACCESSIBILITY & COMPLIANCE                                      │
│     WCAG AAA • ADA Title II • OWASP 2025 • Auto-Auditing           │
│     Source Skills: web-design-guidelines, avant-garde-design-v4, ui-styling │
│                                                                     │
│  7. VISUAL DESIGN & MOTION                                          │
│     4-Stage Framework • Micro-Interactions • Framer Motion          │
│     Source Skills: aesthetic, avant-garde-design-v4, frontend-design │
│                                                                     │
│  8. QUALITY ASSURANCE                                               │
│     6-Phase SOP • Verification Gates • Security • Anti-Patterns      │
│     Source Skills: All 10 source skills                              │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

Quick Decision Tree

What do you need to do?
│
├─ 🎨 STRATEGY/DESIGN → Read references/01-philosophy-strategy.md
│   ├─ Anti-generic positioning
│   ├─ Audience psychographics
│   └─ 4-Stage aesthetic framework
│
├─ ⚙️ SETUP/STACK → Read references/02-tech-stack-setup.md
│   ├─ Next.js 16 + Tailwind v4 config
│   ├─ Monorepo (Turborepo) setup
│   └─ TypeScript strict mode
│
├─ 🎨 DESIGN SYSTEM → Read references/03-design-system.md
│   ├─ Typography pairing
│   ├─ Color palette (OKLCH)
│   └─ Spacing/layout rules
│
├─ 🧩 COMPONENTS → Read references/04-component-architecture.md
│   ├─ shadcn/ui + Radix patterns
│   ├─ MUI v7 integration
│   └─ File organization
│
├─ ⚡ PERFORMANCE → Read references/05-performance-optimization.md
│   ├─ Waterfall elimination
│   ├─ Bundle size optimization
│   └─ Performance budgets
│
├─ ♿ ACCESSIBILITY → Read references/06-accessibility-compliance.md
│   ├─ WCAG AAA audit
│   ├─ ADA Title II compliance
│   └─ Reduced motion handling
│
├─ ✨ VISUAL/MOTION → Read references/07-visual-design-motion.md
│   ├─ Animation timing
│   ├─ Micro-interactions
│   └─ Storytelling design
│
└─ ✅ QA/DELIVERY → Read references/08-quality-assurance.md
    ├─ 6-Phase SOP
    ├─ Verification checklists
    └─ OWASP 2025 security

Reference Navigation

File Core Content When to Read
01-philosophy-strategy.md Anti-Generic Mandate, Strategic Positioning Matrix, 4-Stage Aesthetic, UX Psychology First step for all new projects
02-tech-stack-setup.md Next.js 16 + Tailwind v4 config, Turborepo, TypeScript, RemixIcon Project initialization
03-design-system.md Typography, Color (OKLCH), Spacing, Container Queries Design system creation
04-component-architecture.md shadcn/ui, Radix UI, MUI v7, Feature-Based Structure Component development
05-performance-optimization.md 57 Vercel Rules, Waterfall Elimination, Budgets Performance tuning
06-accessibility-compliance.md WCAG AAA, ADA Title II, OWASP 2025, Audit Workflows Compliance checks
07-visual-design-motion.md 4-Stage Framework, Micro-Interactions, Framer Motion Visual design implementation
08-quality-assurance.md 6-Phase SOP, Checklists, Anti-Patterns, Security Pre-deploy validation

Script Navigation

Script Purpose Usage
ux_audit.py UX psychology + accessibility audit python scripts/ux_audit.py <project_path>
react_performance_checker.py Automated performance audit (Vercel rules) python scripts/react_performance_checker.py <project_path>
shadcn_add.py Add shadcn/ui components with dependencies python scripts/shadcn_add.py button card dialog
tailwind_config_gen.py Generate Tailwind v4 theme config python scripts/tailwind_config_gen.py --colors primary:oklch(0.7 0.15 250)

Asset Navigation

Asset Purpose Usage
design-guideline-template.md Document design decisions Copy to project/docs/design-guideline.md
design-story-template.md Document design narrative Copy to project/docs/design-story.md
decision-trees.md Context-specific design templates Reference for layout/color choices

Meticulous Approach SOP (6-Phase Workflow)

All projects using this skill follow the validated 6-phase process:

Phase 1: ANALYZE (Deep Requirement Mining)

  • Complete Intentionality Compass (audience psychographics)
  • Strategic Positioning Matrix (quadrant selection)
  • Competitive analysis + differentiation plan
  • Performance budget + accessibility requirements

Phase 2: PLAN (Structured Execution Roadmap)

  • Component architecture diagram (Server/Client split)
  • File structure (Next.js + feature-based)
  • Animation strategy (reduced motion compliance)
  • Data flow map

Phase 3: VALIDATE (Explicit Confirmation)

  • Present 3 style tiles + color swatches
  • Verify WCAG contrast ratios
  • Confirm mobile navigation pattern
  • Sign-off on performance budgets

Phase 4: IMPLEMENT (Modular, Tested Builds)

  • Sub-phase 4.1: Foundation (Tailwind v4 theme, fonts, layout)
  • Sub-phase 4.2: Components (shadcn/ui + Radix, library discipline)
  • Sub-phase 4.3: Sections (Hero, Features, CTA)
  • Sub-phase 4.4: Responsive + Accessibility
  • Sub-phase 4.5: Animation (150-300ms, compositor-only properties)

Phase 5: VERIFY (Rigorous QA)

  • Visual debugging protocol
  • Mobile navigation verification
  • Accessibility audit (WCAG AAA)
  • Performance check (57 Vercel rules)
  • Security scan (OWASP 2025)

Phase 6: DELIVER (Complete Handoff)

  • Source code + clean commit history
  • Design documentation (strategy + story)
  • Runbook (setup, build, deploy)
  • Quality report (Lighthouse, accessibility, security)
  • Knowledge transfer (architecture decisions)

Related Skills

Skill When to Use
chrome-devtools-mcp Capture inspiration screenshots, debug production issues
ai-multimodal Generate design images, analyze aesthetic quality
webapp-testing-journey End-to-end user journey testing
code-review-and-audit Deep security + quality review
context7-docs Fetch latest library documentation

Quick Start Checklist

New project? Follow this order:

  1. [ ] Read references/01-philosophy-strategy.md → Complete Intentionality Compass
  2. [ ] Read references/02-tech-stack-setup.md → Initialize Next.js + Tailwind v4
  3. [ ] Read references/03-design-system.md → Define typography + color palette
  4. [ ] Read references/04-component-architecture.md → Set up shadcn/ui
  5. [ ] Implement components following Phase 4 sub-phases
  6. [ ] Run python scripts/react_performance_checker.py . → Fix issues
  7. [ ] Read references/06-accessibility-compliance.md → Run audit
  8. [ ] Read references/08-quality-assurance.md → Complete verification gates
  9. [ ] Deliver with full documentation

Meticulous Reminder: Every element must justify its existence. Reject generic AI tropes. Prioritize intentionality over trends. Accessibility is non-negotiable.

04 同仓库更多 Skills

nordeim
nordeim/onestopnews

webapp-testing

Web application testing principles. E2E, Playwright, deep audit strategies.

★ 0
nordeim
nordeim/onestopnews

web-search

Implement web search capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to search for real-time information from the web, retrieve up-to-date content beyond the knowledge cutoff, or find the latest news and data. Returns structured search results with URLs, snippets, and metadata.

★ 0
nordeim
nordeim/onestopnews

web-reader

Implement web page content extraction capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to scrape web pages, extract article content, retrieve page metadata, or build applications that process web content. Supports automatic content extraction with title, HTML, and publication time retrieval.

★ 0
nordeim
nordeim/onestopnews

web-frameworks

Build modern full-stack web applications with Next.js (App Router, Server Components, RSC, PPR, SSR, SSG, ISR), Turborepo (monorepo management, task pipelines, remote caching, parallel execution), and RemixIcon (3100+ SVG icons in outlined/filled styles). Use when creating React applications, implementing server-side rendering, setting up monorepos with multiple packages, optimizing build performance and caching strategies, adding icon libraries, managing shared dependencies, or working with TypeScript full-stack projects.

★ 0
nordeim
nordeim/onestopnews

video-understand

Implement specialized video understanding capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to analyze video content, understand motion and temporal sequences, extract information from video frames, describe video scenes, or perform video-based AI analysis. Optimized for MP4, AVI, MOV, and other common video formats.

★ 0
nordeim
nordeim/onestopnews

video-generation

Implement AI-powered video generation capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to generate videos from text prompts or images, create video content programmatically, or build applications that produce video outputs. Supports asynchronous task management with status polling and result retrieval.

★ 0