Oh My Web — Frontend Craft Skill Avançado
alllyx520-bot/oh-my-web
Craft frontend awwwards-tier sem IA default — shaders, animações, tipografia CJK
Ver no GitHubSkill opinativa para Claude Code que substitui o design-frontend oficial, trazendo técnicas profissionais (shaders GLSL, Liquid Glass, scroll choreography, CSS 2026, suporte CJK de primeira classe) com 8 exemplos portfolio-grade. Elimina a estética padrão de IA e produz UIs nível Awwwards.
Instalação
npx convez-ai alllyx520-bot/oh-my-web1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Prototipar landing pages e hero sections com efeitos avançados
- Implementar scroll animations e micro-interactions com rigor técnico
- Criar interfaces em chinês/japonês/coreano com tipografia de primeira classe
- Integrar WebGL/WebGPU e shaders GLSL em projetos React/Vue/Next
Veredito

Skill maduro e opinado que eleva drasticamente a qualidade técnica do frontend gerado por Claude Code. Referência obrigatória para quem quer sair do visual genérico de IA e dominar animações, shaders e tipografia asiática em produção. Exige profundidade técnica, não é para iniciantes.
README
A tradução para o português deste README ainda está na fila.
中文 · English
oh-my-web
Claude Code 的高端前端工艺 skill —— 让 Claude 写出 awwwards 级 UI,告别 AI 默认审美。
Anthropic 官方 frontend-design skill 的替代品,定位是「资深创意开发者」级别的产出(对标 Active Theory / Resn / Lusion / Studio Freight / Linear / Vercel)。完整吸收了官方 skill 的设计纪律,并在上面叠了一整套高端站点需要的深度技法库。
仓库结构
oh-my-web/ # GitHub 仓库 = marketplace = plugin 本体
├── .claude-plugin/
│ ├── plugin.json # plugin 元数据
│ └── marketplace.json # marketplace 索引(自指一个 plugin)
├── skills/
│ └── oh-my-web/ # ← skill 主体(plain-skill 安装时只需要这一目录)
│ ├── SKILL.md # 入口文件 —— Claude Code 启动时先读这个
│ ├── references/ # 27 个深度参考,按需加载
│ │ ├── _canonical-facts.md # 零号文件 —— 浏览器支持/库版本/字体黑名单/CWV 阈值唯一权威源
│ │ ├── design-trends-2026.md
│ │ ├── design-principles.md
│ │ ├── composition-and-grid.md
│ │ ├── typography.md
│ │ ├── typography-chinese.md # 中文排版一等公民
│ │ ├── materials-and-textures.md
│ │ ├── advanced-shaders.md
│ │ ├── glsl-patterns.md
│ │ ├── liquid-glass-implementation.md
│ │ ├── modern-css-2026.md # scroll-driven CSS / View Transitions / Anchor Positioning / OKLCH
│ │ ├── intro-and-reveal.md
│ │ ├── scroll-and-motion.md
│ │ ├── interactions.md
│ │ ├── transitions.md
│ │ ├── webgl-threejs.md
│ │ ├── webgpu-and-tsl.md
│ │ ├── micro-details.md
│ │ ├── inspiration.md
│ │ ├── performance.md
│ │ ├── sound-and-audio.md
│ │ ├── tech-stack.md
│ │ ├── accessibility.md # a11y 5 杀手 / 键盘 / ARIA / 对比度(接 axe-core)
│ │ ├── functional-components.md # 四态纪律 / 可访问表单 / 原生 dialog / 骨架屏
│ │ ├── framework-integration.md # GSAP/Lenis/R3F 在 React/Next/Vue/Svelte 的失败模式手册
│ │ ├── graceful-degradation.md # 特性×fallback 矩阵 / capability detection / 弱设备降级
│ │ └── verification-runbook.md # 把声明式 checklist 变成 preview_*/axe/lighthouse 可执行验证
│ ├── scripts/
│ │ └── check-consistency.sh # 防 _canonical-facts 裁定过的事实在其他文件回流
│ └── examples/ # 8 个作品集级的完整一屏页
│ ├── hero-fluid-shader.html
│ ├── magnetic-cursor.html # Atelier Nord —— 柏林 agency
│ ├── scroll-reveal-text.html # The Quarterly, Issue №07 —— editorial
│ ├── horizontal-scroll-section.html # Atlas Cinema, MMXXVI
│ ├── image-distortion-hover.html # Atelier North, Plates 001–006
│ ├── kinetic-marquee.html # Signal / Noise, Vol. 04 —— brutalist
│ ├── page-transition-overlay.html # Maison Helix —— 奢华,View Transitions API
│ └── chinese-editorial-studio.html # 砚行 Yán Xíng —— 中文 editorial
├── README.md / README.en.md / LICENSE
└── .github/social-preview.png # GitHub 分享卡预览图
相比官方 frontend-design 多了什么
- Restraint ↔ Expression 双极框架 —— 设计前先选一极,治「modern + clean + bold」骑墙病。
- 16 个具名美学方向 —— brutalist / editorial / luxury / cinematic / agency-maximalist / tech-futurist / retro-futuristic / lo-fi zine / handcrafted……选一个极端、贯彻到底。
- 20+ 经调研的命名调色板 —— Midnight Opulence、Cyber Neon、Editorial Cream + Cobalt、Agency Noir + Chartreuse 等,每个都有来源。
- 完整 GLSL shader cookbook —— 7 个基础 + 8 个高级(curl-noise、iridescence、caustics、aurora、halftone、volumetric、Voronoi、ASCII)。
- Apple Liquid Glass 三层实现 —— CSS-only / SVG
<feDisplacementMap>/ WebGL shader 三个性能档位。 - Modern CSS 2026 平台原生特性 —— scroll-driven animations、View Transitions API、Anchor Positioning + Popover、OKLCH + Relative Color Syntax。
- GSAP + Lenis + ScrollTrigger 滚动编排实战配方,外加 Three.js r171 WebGPU + TSL 节点材质指南。
- 中文场景一等公民 ——
typography-chinese.md内置 premium 中文字库(思源/HarmonyOS Sans/阿里普惠/霞鹜文楷/得意黑)、5 套中英文混排配对、CJK 专属 CSS(text-spacing-trim、hanging-punctuation、word-break: keep-all、line-height ≥ 1.7)、cn-font-split子集化、传统色彩锚点。带中文内容的站点必须先读这个,禁用微软雅黑/宋体等系统默认中文字体。 - 8 个作品集级 examples,每个都是带完整虚拟工作室身份的一屏页(独立调色板、字体配对、文案、microtype)—— 不是技法 demo,而是开箱即可改 brand 的起点。
- Core Web Vitals 2026 预算,包括硬指标 INP < 200ms。
安装
推荐:通过 plugin marketplace 一键安装
在 Claude Code 会话里输入:
/plugin marketplace add alllyx520-bot/oh-my-web
/plugin install oh-my-web@oh-my-web
之后想升级:/plugin update oh-my-web;想卸载:/plugin uninstall oh-my-web。
备选:手动作为 skill 安装
如果你不想走 plugin 系统,也可以把 skill 目录直接拷到 ~/.claude/skills/:
# macOS / Linux
git clone --depth=1 https://github.com/alllyx520-bot/oh-my-web.git /tmp/omw && \
cp -r /tmp/omw/skills/oh-my-web ~/.claude/skills/ && rm -rf /tmp/omw
# Windows (PowerShell)
git clone --depth=1 https://github.com/alllyx520-bot/oh-my-web.git $env:TEMP\omw; `
Copy-Item -Recurse $env:TEMP\omw\skills\oh-my-web $env:USERPROFILE\.claude\skills\; `
Remove-Item -Recurse -Force $env:TEMP\omw
Claude Code 启动时会自动扫描 ~/.claude/skills/<skill-name>/SKILL.md,发现就加载。
怎么触发
只要你让 Claude Code 构建、设计、改样式、重做、美化任意 web UI(网站、落地页、dashboard、海报、React/Vue 组件、HTML/CSS 布局),这个 skill 就会自动触发,不需要手动调用。
如果想让它作为你的默认前端 skill(覆盖官方 frontend-design),在 ~/.claude/CLAUDE.md 里加一行:
前端默认调 oh-my-web。
Examples
8 个 example 全部是单文件自包含 HTML,仅用 CDN 引入,无需构建。任何一个都能直接打开:
# Windows
start skills\oh-my-web\examples\magnetic-cursor.html
# macOS
open skills/oh-my-web/examples/magnetic-cursor.html
每个 example 都遵循同一套纪律:承诺一个美学方向 + 一次 outsized gesture + 其余克制 + 10 个以上 micro-detail 显工艺。它们既是技法的起点,也是品味的起点 —— 改用时请保留设计纪律(命名调色板、配对字体、真实内容、microtype 标签),只换 brand。
8 个 example 一览
| 文件 | 工作室身份 | 调色板 | 字体配对 | 核心展示 |
|---|---|---|---|---|
hero-fluid-shader.html | — | warm noir + magenta-violet | system | GLSL fluid hero、fbm 域形变 |
magnetic-cursor.html | Atelier Nord(柏林 agency) | warm noir + 电光 chartreuse | Boska + Cabinet Grotesk | 三态光标、磁性 CTA、悬停图片预览、live clock、availability pulse |
scroll-reveal-text.html | The Quarterly, Issue №07 | cream + cobalt + ink | Erode + Cabinet Grotesk | Editorial 杂志风、drop cap、脚注 popover、多栏、阅读进度 |
horizontal-scroll-section.html | Atlas Cinema, MMXXVI | midnight + amber + cream | Boska + Cabinet Grotesk | 5 段不同处理的横向 pinned scroll、面板计数、视差摄影 |
image-distortion-hover.html | Atelier North, Plates 001–006 | cream + 朱砂 vermilion + ink | Erode + Satoshi | 非对称画廊、GLSL 悬停形变、stacked-stack 同辈暗化、VIEW 自定义光标 |
kinetic-marquee.html | Signal / Noise, Vol. 04 | 纯黑 + 酸黄 acid yellow | Tanker + Cabinet Grotesk | Brutalist hero、词翻转、3 条不同速度跑马灯、滚动速度倾斜 |
page-transition-overlay.html | Maison Helix(柏林 studio) | 森林绿 + 金 + bone | Boska + Cabinet Grotesk | 3 完整页面、View Transitions API 主路径 + GSAP 错峰金条降级 |
chinese-editorial-studio.html | 砚行 Yán Xíng(上海中文 studio) | 宣纸白 + 墨色 + 真金 + 朱砂(仅印章) | 霞鹜文楷 + 思源宋 + Erode + Cabinet Grotesk + JetBrains Mono | CJK 排版完整实战:lang 标记、line-height 1.85、word-break: keep-all、hanging-punctuation、text-spacing-trim、全角标点、中英文自动空格 |
和官方 frontend-design 是什么关系
本 skill 对选它做默认的用户来说取代官方的 frontend-design。官方那套核心 directive 全部吸收:
- ✓ Pre-coding 四问(Purpose / Tone / Constraints / Differentiation)
- ✓ 「承诺一个美学极端」的强制要求(在本 skill 里扩展为 16 个具名方向 + 具体调色板)
- ✓ 禁用字体清单(Inter、Roboto、Arial、Space Grotesk)+ 禁用 pattern 清单(purple-on-white、bento、套模板组件)
- ✓ 「实现复杂度匹配美学愿景」硬规则
- ✓ 「默认字体 = 默认思维」、「字体配对像演员选角」的话术
- ✓ 「Don't hold back」的创作许可
如果某个需求确实在本 skill 词典之外(比如纯内部小工具、跑通优先),官方的 frontend-design 仍然可以作为 fallback 保留安装。
License
MIT —— 见 LICENSE。
致谢
构建在 Anthropic 官方 frontend-design skill 之上(pre-coding 四问、禁用字体清单、「复杂度匹配愿景」纪律来自官方)。其余的 —— Restraint↔Expression 双极、16 个具名美学、命名调色板、shader cookbook、Liquid Glass 三层实现、modern-CSS-2026 模块、中文一等公民、8 个 example —— 都是在这之上的添加。