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
- 资产文件assets/decision-trees.md16.9 KB
- 资产文件assets/design-guideline-template.md3.4 KB
- 资产文件assets/design-story-template.md2.6 KB
- 参考文档docs/wool-sneakers-design-guideline.md8.6 KB
- 参考文档docs/wool-sneakers-design-story.md8.5 KB
- 参考文档references/01-philosophy-strategy.md8.0 KB
- 参考文档references/02-tech-stack-setup.md8.6 KB
- 参考文档references/03-design-system.md7.5 KB
- 参考文档references/04-component-architecture.md8.9 KB
- 参考文档references/05-performance-optimization.md6.8 KB
- 参考文档references/06-accessibility-compliance.md6.3 KB
- 参考文档references/07-visual-design-motion.md9.7 KB
- 参考文档references/08-quality-assurance.md10.4 KB
- 脚本scripts/react_performance_checker.py9.8 KB
- 脚本scripts/shadcn_add.py7.8 KB
- 脚本scripts/tailwind_config_gen.py13.3 KB
- 脚本scripts/ux_audit.py38.5 KB
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:
- Building new frontend projects from scratch (luxury, SaaS, e-commerce, portfolios)
- Migrating legacy projects to modern stacks (Tailwind v3→v4, Next.js 15→16)
- Conducting full-stack performance audits (57 Vercel rules + OWASP 2025)
- Creating accessible, WCAG AAA compliant interfaces (ADA Title II ready)
- Implementing strategic, anti-generic design systems with intentional branding
- Setting up monorepos with Turborepo + shared component libraries
- 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:
- [ ] Read
references/01-philosophy-strategy.md→ Complete Intentionality Compass - [ ] Read
references/02-tech-stack-setup.md→ Initialize Next.js + Tailwind v4 - [ ] Read
references/03-design-system.md→ Define typography + color palette - [ ] Read
references/04-component-architecture.md→ Set up shadcn/ui - [ ] Implement components following Phase 4 sub-phases
- [ ] Run
python scripts/react_performance_checker.py .→ Fix issues - [ ] Read
references/06-accessibility-compliance.md→ Run audit - [ ] Read
references/08-quality-assurance.md→ Complete verification gates - [ ] 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
webapp-testing
Web application testing principles. E2E, Playwright, deep audit strategies.
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.
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.
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.
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.
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.