Communitygithub.com

divyanshu-iitian/agent-website-design-skills

AI Agent 网站设计技能,涵盖着陆页、设计系统、响应式 UI 质量检查、可访问性及转化率优化。

agent-website-design-skills 是什么?

此技能专为 AI Agent 设计,用于在网站前端页面、组件、游戏或交互式工具实现或修改后自动执行响应式 UI 质量检查。它定义了一个完整的工作流程:启动应用、在多个关键视口(如移动端 375x812、平板 768x1024、桌面 1440x900 及窄宽度 320px)进行检查、识别常见的布局问题(如重叠、文本裁剪、水平滚动、可读性差等),并指导修复。技能偏好使用响应式约束、网格变化、容器相对尺寸等现代 CSS 技术,避免直接根据视口缩放字体。该技能支持在各种 AI Agent 平台(如 Claude Code、Cursor、Codex)上使用,主要基于其内部的 SKILL.md 文档,并推荐结合 `references/qa-checklist.md` 进行最终视觉质量检查,以提升网站的专业性和用户体验。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add divyanshu-iitian/agent-website-design-skills

在你喜欢的 AI 中提问

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

文档

响应式 UI 质量检查

在实现或修改前端页面、组件、游戏或交互式工具后使用此技能。

工作流程

  1. 必要时使用仓库的正常命令启动应用。
  2. 至少检查以下视口:移动端 375x812、平板 768x1024、桌面 1440x900,以及一个狭窄的极限宽度 320px。
  3. 对每个关键路由/状态进行截图或使用浏览器检查。
  4. 检查是否存在重叠、文本裁剪、水平滚动、不可读的对比度、过小的点击目标、破损的粘性元素、空白的媒体/Canvas、以及隐藏在固定 UI 后的内容。
  5. 与导航、菜单、表单、标签页、对话框、悬停/焦点状态以及主要 CTA 进行交互。
  6. 使用响应式约束、网格调整、换行、最小/最大宽度、稳定的高度和溢出处理来修复布局。
  7. 在之前失败的视口/状态下重新测试。
  8. 对于 Canvas/3D/媒体体验,验证像素非空且场景正确取景。

修复偏好

  • 使用容器相对尺寸、minmax()、clamp() 处理尺寸、aspect-ratio 和显式网格轨道。
  • 不要直接根据视口宽度缩放字体大小。
  • 优先使用换行和回流,而不是缩小文本至不可读。
  • 仅对控件、工具栏、媒体框和已知格式的表面保留固定高度。
  • 确保键盘焦点可见且未被裁剪。

参考

在执行最终视觉质量检查时,阅读 references/qa-checklist.md。

Individual skills in this repo

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

相关技能