Communitygithub.com

ComeOnOliver/skillshub

构建设计精准、富有感染力的界面,而不仅仅是渲染。此技能强制执行大胆、有意的设计。

skillshub 是什么?

此技能是一个全面的前端设计大师班,专注于使用 SvelteKit 5、Bun、Hono、shadcn-svelte 和 Tailwind CSS v4 等现代高性能堆栈构建用户界面。其核心原则是“每个像素都必须证明其存在的合理性”,强调有意为之的设计,反对通用的、低风险的“模板化”模式。该技能会引导用户在加载资源之前,通过产品类型、风格意图和受众等维度对设计意图进行分类,然后根据触发关键词加载特定的参考文件(如登陆页面、版式、颜色系统、动效等),以获取深入的实现模式。它提供了详细的设计思维工作流程、通用美学规范(如禁止使用默认字体、纯紫色主色调),以及一个包含视觉质量、交互和可访问性检查项的交付前检查清单,以确保最终产出既美观又专业。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aaaronmiller/frontend-design-masterclass/frontend-design-masterclass

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

前端设计大师班 v2.1

构建设计精准、富有感染力的界面,而不仅仅是渲染。此技能强制执行大胆、有意的设计,采用现代高性能技术栈。每一个像素都必须证明其存在的价值。

1. 核心技术栈

  • 框架:SvelteKit 5 搭配 Runes ($state, $derived, $effect)
  • 运行时:Bun (服务端、包管理)
  • 后端/API:Hono (边缘优先的路由、中间件)
  • UI 基元:shadcn-svelte (无头、完全可定制)。覆盖所有默认设置。
  • 图表:LayerChart (基于 Layer Cake,为 shadcn-svelte 图表提供支持)
  • 动效:Svelte Motion (@humanspeak/svelte-motion) 用于复杂编排。内置的 svelte/transition 和 svelte/animate 用于标准动效。CSS keyframes 用于简单的循环动效。
  • Mermaid:beautiful-mermaid 用于主题化 SVG 渲染,并与 Shiki 兼容
  • 样式:Tailwind CSS v4,扩展了 CSS 自定义属性
  • 测试:Playwright 用于视觉回归测试
  • 资源:Nano Banana 用于生成式图像和纹理
  • 部署:静态站点使用 @sveltejs/adapter-static,SSR 使用 @sveltejs/adapter-vercel

2. 意图识别 (资源加载前)

在加载参考资料之前,从三个维度对请求进行分类。这将影响每一个后续的设计决策。

A. 产品类型

识别正在构建的内容。每种产品类型都暗示着风格、颜色和布局规范。

产品类别推荐风格颜色方向
SaaS / B2B / 生产力工具瑞士网格,扁平 + 玻璃态信任蓝 + 强调对比色
电商 / 零售鲜艳色块,功能丰富的展示品牌主色 + 成功绿
奢侈品电商液态玻璃,电影感深中性色 + 金色/香槟色点缀
金融科技 / 加密货币数据密集,深色模式 OLED深海军蓝/炭黑色 + 霓虹点缀色
医疗健康 / 健康有机流动,柔和 UI柔和蓝绿色/鼠尾草绿 + 暖中性色
创意 / 个人作品集新粗野主义,动态排版高对比度 + 一种大胆的点缀色
游戏 / 娱乐赛博朋克,HUD/科幻深黑色 + 霓虹多色点缀
教育 / 文档编辑式宽幅版面,极简温暖纸张色 + 墨水层次感
AI / 机器学习平台极光 UI,动效驱动渐变主色 + 深色表面
仪表盘 / 分析便当网格,数据密集中性表面 + 语义化数据颜色

将此表作为起始指南针,而非约束。始终进行自定义。

B. 风格意图

根据上下文线索、明确请求或产品类型确定美学目标。有关 8 种永恒风格的完整规格,请参阅 references/landing-pages.md 第 3 节。

C. 受众与上下文

考虑谁在使用以及在哪里使用。企业级受众能容忍高密度信息;消费者级受众需要喘息空间。移动端优先会彻底改变触摸目标、字体比例和动效强度。

3. 资源加载协议

识别意图后,扫描请求中的触发关键词。加载 references/ 中匹配的参考文件,以获取深入的实现模式。

登陆页与英雄区域

触发词:"登陆页", "英雄区域", "首屏", "首页", "站点标题", "标题", "行动号召", "转化", "第一印象" 加载:references/landing-pages.md 提供:英雄区域结构、8 种永恒登陆页面风格 (Apple Keynote, Editorial Broadsheet, Geometric Playground, Cinematic Immersive, Swiss Grid, Neo-Brutalist, Organic Flow, Retro Terminal)、视觉流模式 (Z/F/Golden/Diagonal)、转化架构、移动端优先英雄策略、代码模式。

排版与字体选择

触发词:"字体", "排版", "字型", "标题", "文本样式", "字体搭配", "字号比例", "字距", "行高", "可读性", "展示字体" 加载:references/typography.md 提供:展示/正文/等宽字体目录及搭配建议、字号比例构建 (数学比率)、使用 clamp() 的响应式排版、可变字体、字体加载与性能优化、排版细节 (字距、悬挂标点、光学对齐)、可读性检查清单。

颜色系统与主题

触发词:"颜色", "调色板", "主题", "深色模式", "浅色模式", "强调色", "配色方案", "品牌色", "对比度", "色相", "饱和度" 加载:references/color-system.md 提供:结构化的 3 组调色板架构 (基础色调、主色调、强调色调)、色彩理论和谐模型、调色板生成流程、浅色主题构建、深色主题构建 (独立规则)、带有额外主题的主题选择器 (暖色/冷色/单色/高对比度变体)、语义化颜色令牌、CSS 自定义属性系统、WCAG 对比度合规性。

图像、纹理与背景

触发词:"图像", "背景", "纹理", "照片", "插画", "抖动处理", "叠加层", "视差背景", "英雄图像", "Nano Banana", "双色调", "图案" 加载:references/imagery.md 提供:图像角色分类、尺寸与格式策略、三层背景构成、抖动算法 (Atkinson/Floyd-Steinberg/Bayer)、叠加层与几何边界 (对角线、clip-path 形状、角标、网格叠加)、图像中的动感、艺术风格选择 (照片真实感/插画风/生成式/混合媒体/双色调)、按钮与横幅图像、Nano Banana 集成、AI 图像提示指南。

数据图形、表格、图表与信息图

触发词:"表格", "图表", "信息图", "数据", "统计", "指标", "仪表盘 KPI", "比较", "时间线", "流程图", "数字展示" 加载:references/data-graphics.md 提供:超越默认的表格设计 (无网格表格、状态指示器、折线图单元格、固定表头、强调技巧)、图表美学与叙事 (渐变填充、辉光效果、注释、网格替代)、Mermaid 图表集成、信息图表模式 (数字块、时间线、比较网格、流程图)、数据视觉 AI 提示、打印就绪的数据图形。

微动效与交互控件

触发词:"动效", "悬停", "点击", "按钮", "切换", "反馈", "涟漪", "加载", "骨架屏", "过渡", "吸附", "磁吸", "滚动动效", "微交互", "响应式控件", "状态转换", "表单动效" 加载:references/microanimations.md 提供:完整的 5 态按钮系统 (默认/悬停/激活/聚焦/禁用)、导航反馈 (菜单项、汉堡菜单、标签指示器)、滚动驱动动效 (交错显示、进度条、计数器动效)、表单交互 (浮动标签、验证反馈、自定义复选框)、加载状态 (骨架屏、成功/错误)、页面过渡、触感模式 (按压、弹跳、卡片抬起、涟漪)、吸附与磁吸行为、性能规则、缓动与时间参考表。

视觉动效与深度

触发词:"3D", "深度", "视差", "倾斜", "伪 3D", "空间感", "动态", "动效", "玻璃态", "全息" 加载:references/visual-kinetics.md 提供:动效层级系统 (CSS -> Svelte -> Svelte Motion -> GSAP)、全息倾斜卡片带眩光、使用 Nano Banana 图层的视差英雄区、玻璃态 2.0、动态排版 (揭示遮罩、跑马灯、文字拆分)、滚动触发的显示、基于物理的缓动、磁吸按钮、性能检查清单。

数据可视化 (图表与仪表盘)

触发词:"layerchart", "图表组件", "仪表盘布局", "便当网格", "折线图", "实时", "霓虹图表", "编辑式图表" 加载:references/data-visualization.md 提供:LayerChart 可组合模式、shadcn-svelte 图表集成、图表美学模式 (霓虹/编辑式/极简)、表格样式方案、便当网格仪表盘布局、折线图、实时数据模式、备用库。

图表 (Mermaid)

触发词:"mermaid", "图表", "流程图", "时序图", "架构图" 加载:references/mermaid-theming.md 提供:beautiful-mermaid 设置与主题化、Shiki 集成、原生 Mermaid themeVariables 映射、SVG 后处理 (纹理叠加、阴影、边框)、SvelteKit 组件模式、图表类型样式说明、打印注意事项。

当检测到多个触发词时,加载所有相关的参考文件。 当未检测到触发词时,直接应用下方的通用强制规则。

4. 反同质化强制令

大语言模型倾向于收敛于训练数据中高概率的“安全”设计模式。这是分布性收敛。请刻意与之对抗。

拒绝:原样使用 Bootstrap/Tailwind 默认设置、Inter/Roboto/Arial/系统字体、白底紫色配色方案、可预测的卡片网格、千篇一律的英雄区域、完全居中的布局、库存照片、通用渐变、UI 中的 Emoji 图标、魔法数字间距、不可见的悬停状态、变换导致布局偏移的悬停缩放、透明度低于 30% 的浅色模式玻璃卡片、对比度低于 gray-500 的淡化文本。

拥抱:有意的排版层级、非对称构图、氛围深度、动态反馈、编辑式网格、几何视觉引导、印刷级精确度、基于色彩理论构建的自定义调色板、独特的字体搭配、具有一致 viewBox 的 SVG 图标系统 (Lucide, Heroicons)、每个可点击元素添加 cursor-pointer、使用颜色/透明度 (而非破坏布局的变换) 实现稳定的悬停状态。

5. 设计思维 (编码前)

在编写代码之前,确定一个方向:

  1. 目的:解决什么问题?谁在使用?
  2. 产品类型:使用 2A 节中的表格进行初步方向分类。
  3. 美学基调:选择一个并完全投入。详见 references/landing-pages.md 第 3 节的 8 种经过验证的风格。或者创造一种混合风格。
  4. 颜色方向:选择主色相,通过色彩理论和谐派生强调色。完整流程见 references/color-system.md 第 3 节。
  5. 字体:从 references/typography.md 目录中选择展示字体 + 正文字体 + 等宽字体的三元组。
  6. 令人难忘的细节:确定用户会记住的一个元素。
  7. 复杂度匹配:极繁主义 = 精细的代码。极简主义 = 手术刀般的精确。

6. 通用美学强制规则

字体

选择独特、有特色的搭配。从 Google Fonts 或 Fontsource 加载。完整的字体目录和搭配策略请参见 references/typography.md。绝不使用 Inter、Roboto、Open Sans、Lato 或默认系统字体,除非进行了大幅修改。绝不在不同生成任务中收敛于 Space Grotesk。

颜色 (结构化调色板)

构建 3 组调色板:基础色调、主色调、强调色调。完整系统请参见 references/color-system.md。 浅色主题:硬阴影、粗体排版、细线。 深色主题:彩色辉光、米白色文本 (#E8E8E8)、微妙的表面渐变。 绝不使用纯紫色 (色相: 270-280) 作为主色。改为靛蓝、蓝绿色、珊瑚色或翡翠绿。

图像与纹理

绝不在英雄区域使用纯色、扁平背景。三层构成技术、抖动算法和 Nano Banana 集成模式请参见 references/imagery.md。

微动效 (强制)

每个交互元素都必须提供动效反馈。完整的 5 态按钮系统、滚动驱动动效和触感模式请参见 references/microanimations.md。

空间构成

垂直脚手架、非对称、负空间、打破网格的元素。视觉流模式请参见 references/landing-pages.md 第 4 节。

可访问性 (不可妥协)

  • 语义化 HTML:<article>, <section>, <nav>, <aside>, <main>
  • 焦点状态:绝不使用 outline: none。样式化为 outline: 2px solid var(--accent); outline-offset: 4px
  • WCAG AA 对比度最低要求。参见 references/color-system.md 第 9 节。
  • 所有自定义交互组件需添加 ARIA 标签
  • prefers-reduced-motion:禁用视差、倾斜、复杂动效
  • 颜色绝不能作为状态的唯一指示符
  • 所有图像需要 alt 文本;表单输入需要标签

打印与 PDF

当 @media print 激活时,网站必须能够兼作可打印的报告。隐藏导航/页脚/按钮,强制白色背景,保留 SVG 图表,在卡片/图表/表格上使用 break-inside: avoid。

7. 实施工作流程

  1. 识别:对产品类型、风格意图和受众进行分类 (第 2 节)。
  2. 加载:扫描资源触发词。加载相关的参考文件 (第 3 节)。
  3. 研究:对于复杂的构建,进行深度研究 (最多 10 次网络搜索),查找同类获奖网站、模式和库的功能。
  4. 架构:规划 SvelteKit 文件结构。定义 CSS 变量令牌。
  5. 编码:编写语义化的 HTML、扩展的 Tailwind、Svelte 5 Runes。生产就绪,无占位符。
  6. 打磨:应用微动效、纹理层、悬停状态、滚动触发器。
  7. 验证:运行交付前检查清单 (第 8 节)。修复所有失败项。
  8. 迭代:与美学愿景进行比较。调整直至效果突出。

8. 交付前检查清单

在交付任何 UI 代码之前运行此清单。每个项目都是已知的失败模式。

视觉质量

  • 未在 UI 中使用 Emoji 图标 (请使用 Lucide 或 Heroicons SVGs)
  • 所有图标来自一套具有匹配 viewBox 的一致集合 (24x24)
  • 品牌徽标已根据官方来源验证 (Simple Icons)
  • 悬停状态不会导致布局偏移 (使用透明度/颜色,而非缩放变换)
  • 没有未经自定义的默认 Tailwind 颜色类
  • 字体搭配是有意的并已加载 (非系统回退)

交互

  • 每个可点击元素都有 cursor-pointer
  • 每个交互元素都有可见的悬停反馈
  • 过渡使用 150-300ms 持续时间 (UI 绝不超过 500ms,绝不设为 0ms)
  • 焦点状态可见且已样式化 (非浏览器默认,绝不被移除)
  • 移动端触摸目标最小为 44x44px

浅色/深色模式

  • 浅色模式:文本对比度通过 WCAG...

[因翻译截断]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Next.js 16+ uses App Router with Server Components by default. Client Components are only used when interactivity is needed (hooks, event handlers, browser APIs).

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

相关技能