award-level-web-design
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Warn
- process.env — Environment variable access in skills/award-level-web-design/scripts/shoot.mjs
- network request — Outbound network request in skills/award-level-web-design/scripts/shoot.mjs
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Agent skill: design web pages to Awwwards/Webby/FWA standard with an 8-dimension screenshot self-review loop (Claude Code, Codex, Cursor...)
award-level-web-design
一个让 AI 编程助手按 Awwwards / Webby Awards / FWA 获奖网站的品质标准来设计和实现网页的 Agent Skill。
页面完成后,它会实际渲染并截图,再从八个维度逐项打分、修改、重新截图,循环到没有明显可提升之处:
排版 · 留白 · 视觉层级 · 色彩 · 动效 · 微交互 · 响应式 · 原创性
在线主页与示例:https://abc-xiaoxuan.github.io/award-level-web-design/
遵循开放的 Agent Skills 格式,可用于 Claude Code、Codex、Cursor 等支持 skill 的工具。
效果示例
下面三个页面都是用这个 skill 生成的,每个都经过了多轮"截图—打分—修改"的自检。源码在 examples/,共享的菜单、动效控制和本地字体在 assets/。下载完整仓库后可直接打开 HTML;本地预览与验证方法见下文。
手机和平板有全屏导航;评分卡和 Echo 演示提供暂停按钮,也会在悬停、键盘聚焦、切换到后台时暂停。示例使用本地字体,无需连接 Google Fonts。
栖木咖啡 · 独立烘焙品牌
概念"一张烘焙记录卡":暖纸色 + Fraunces 衬线;签名时刻是一条自动绘制、可拖动查看任意时刻温度的烘焙曲线。

| 本季豆单 | 烘焙流程 | 手机端 |
|---|---|---|
![]() |
![]() |
![]() |
间 Studio Jian · 建筑事务所
概念"图纸即界面":可见的 12 栏发丝网格、尺寸标注线和图签;悬停项目时显示对应平面图,鼠标是一个带坐标读数的十字准线。

| 作品索引 | 手机端 |
|---|---|
![]() |
![]() |
回声 Echo · AI 语音笔记
概念"声音留下的等高线":暗色 + 酸性绿;背景等高线会绕开鼠标弯曲,下方是自动轮播的"录音 → 转写 → 整理"交互演示。

| 工作方式演示 | 手机端 |
|---|---|
![]() |
![]() |
安装
方式一:npx(支持 Claude Code、Codex 等 30+ 工具)
npx skills add ABC-xiaoxuan/award-level-web-design
安装到用户全局目录(所有项目可用):
npx skills add ABC-xiaoxuan/award-level-web-design -g
只装给某个工具,例如 Claude Code 和 Codex:
npx skills add ABC-xiaoxuan/award-level-web-design -g -a claude-code -a codex
方式二:Claude Code 插件市场
在 Claude Code 里依次输入:
/plugin marketplace add ABC-xiaoxuan/award-level-web-design
/plugin install award-level-web-design@award-level-web-design
方式三:手动复制
把 skills/award-level-web-design/ 整个文件夹复制到:
| 工具 | 目录 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.agents/skills/ |
使用
装好后不用特意调用。当你让 AI 做落地页、官网、作品集、产品页,或者提到"高级感""设计感""别像模板""Awwwards 风格"时,它会自动启用。
也可以显式调用:
- Claude Code:
/award-level-web-design - Codex:
$award-level-web-design
示例:
帮我做一个独立咖啡品牌的官网首页,要有高级感
它会做什么
- 先定设计概念:一句话创意、字体搭配、色彩方案、版式网格,以及至少一个"签名时刻"。
- 实现时守住底线:设计令牌、只动 transform/opacity 的流畅动效、完整的交互状态、WCAG AA 对比度、
prefers-reduced-motion、375–1920 四档宽度。 - 截图 + 自动审计:自带的
shoot.mjs一次截完 375 / 768 / 1440 / 1920 四个宽度,audit.js自动查出溢出、对比度、点击区、中文字体回退、标题孤字等客观问题。 - 打分修改循环:八维度 1–10 分打分,按影响排序批量修改,再重新截图。默认 2 轮、最多 3 轮;audit 无 error 且八项都 ≥ 9 分即停止。
- 交付说明:设计取舍、每轮改了什么、最终得分与 audit 结果、还需要你提供的素材。
截图脚本需要 Node 22+ 和本机的 Chrome / Edge / Chromium。没有的话,可以把 audit.js 粘贴到浏览器控制台执行;两者都用不了时,它会改为对照代码逐条审查,并告诉你这一点。
单独使用脚本:
node skills/award-level-web-design/scripts/shoot.mjs ./index.html --audit --sections "#work" --out shots
本地预览与验收
需要 Node 22+ 和本机 Chrome,在仓库根目录执行:
npm ci
npm run dev
# 打开 http://127.0.0.1:4173
npm test # 四个页面 × 四档宽度、菜单键盘操作、暂停/恢复、图片预算、分享标签
npm run test:lighthouse # 默认移动端模拟节流,四项分数低于 95 会失败
两项检查顺序运行,避免多个浏览器争用资源影响性能结果。报告保存在 verification/,验收口径和本轮结果见 verification/REVIEW.md。
修改页面后可重建展示资源:
python -m pip install fonttools brotli pillow
npm run build:fonts # 从仓库内的原始字体提取页面子集,不访问外网
npm run build:share # 生成 1200×630 分享图
npm run build:previews # 截取三个示例,生成 WebP 与 480/960 宽度版本
保留 assets/fonts/ 中的 OFL 许可证。发布 GitHub Pages 时需连同 assets/、examples/、favicon.svg 和 og-preview.png 一起发布;上线后再用分享平台调试工具确认抓取并刷新缓存。
文件结构
skills/award-level-web-design/
├── SKILL.md # 主流程
├── references/review-checklist.md # 八维度自检清单
├── scripts/shoot.mjs # 多宽度截图 + 调用审计
├── scripts/audit.js # 页面内自动审计(也可粘贴到控制台)
└── agents/openai.yaml # Codex 界面信息(其他工具会忽略)
examples/ # 三个示例页面 + 截图(不会被安装)
许可证
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found






