convez.ai
SkillDesign & UIAvançado
alllyx520-bot

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 GitHub
InicialPluginScore · de 0 a 100

Skill 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-web

1 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

Estrelas
2
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v1.1.0
Issues abertas
0
Contribuidores
1

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-violetsystemGLSL fluid hero、fbm 域形变
magnetic-cursor.htmlAtelier Nord(柏林 agency)warm noir + 电光 chartreuseBoska + Cabinet Grotesk三态光标、磁性 CTA、悬停图片预览、live clock、availability pulse
scroll-reveal-text.htmlThe Quarterly, Issue №07cream + cobalt + inkErode + Cabinet GroteskEditorial 杂志风、drop cap、脚注 popover、多栏、阅读进度
horizontal-scroll-section.htmlAtlas Cinema, MMXXVImidnight + amber + creamBoska + Cabinet Grotesk5 段不同处理的横向 pinned scroll、面板计数、视差摄影
image-distortion-hover.htmlAtelier North, Plates 001–006cream + 朱砂 vermilion + inkErode + Satoshi非对称画廊、GLSL 悬停形变、stacked-stack 同辈暗化、VIEW 自定义光标
kinetic-marquee.htmlSignal / Noise, Vol. 04纯黑 + 酸黄 acid yellowTanker + Cabinet GroteskBrutalist hero、词翻转、3 条不同速度跑马灯、滚动速度倾斜
page-transition-overlay.htmlMaison Helix(柏林 studio)森林绿 + 金 + boneBoska + Cabinet Grotesk3 完整页面、View Transitions API 主路径 + GSAP 错峰金条降级
chinese-editorial-studio.html砚行 Yán Xíng(上海中文 studio)宣纸白 + 墨色 + 真金 + 朱砂(仅印章)霞鹜文楷 + 思源宋 + Erode + Cabinet Grotesk + JetBrains MonoCJK 排版完整实战: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 —— 都是在这之上的添加。

Ver o original no GitHub

Bom para

Relacionados