1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | impeccable |
| 作者/维护者 | Paul Bakaus（独立开发者；公开履历含 jQuery UI 作者、前 Google Developer Advocate，来自 GitHub 个人资料） |
| 来源链接 | https://github.com/pbakaus/impeccable |
| 许可证 | Apache License 2.0（来自仓库 LICENSE 文件与 SKILL 元数据） |
| GitHub Stars | 47,021（来自 GitHub API） |
| Forks | 2,824（来自 GitHub API） |
| 最新版本 | Skill 3.9.1（GitHub Release 标签 skill-v3.9.1，发布于 2026-07-01） |
| 安装方式 | npx impeccable install（CLI，推荐）；Claude Code 插件市场；Git Submodule |
2. 功能介绍与亮点
Impeccable 是一套面向 AI 编码 agent 的前端设计指导技能：23 个可组合命令（polish／audit／critique／distill／animate／bolder／quieter／harden／onboard 等）覆盖从项目初始化到上线前打磨的全流程，配合 46 条确定性检测规则（不依赖 LLM 判断、可在 CLI 与浏览器扩展中复现）与 LLM 批判性检查双轨并行。
核心亮点：
- 按模型定制反模式库：内置针对不同大模型已知设计缺陷的专项规避规则，例如 Codex 常见的“1px 边框+宽阴影”叠加缺陷、Gemini 对图片元素滥用 hover 动效的问题，这在同类技能中较为少见
- 可离线复现的质检：CLI 与浏览器扩展运行确定性规则时不需要 LLM 也不需要 API key
- live 浏览器迭代模式：可在浏览器内对界面元素做截图对比、实时调整，而非仅输出静态建议
- 多 agent 原生集成：为 Claude Code、Codex、Cursor、Gemini CLI 等平台分别提供 provider 专属目录与 hook 集成，而非单一通用文本
3. 适用场景
所属分类：前端与设计
面向用 Claude Code/Codex 等 agent 做前端 UI 设计与打磨的开发者，尤其想摆脱 AI 生成界面同质化观感（紫蓝渐变、Inter 字体、卡片套卡片等“AI 味”）的个人开发者与小团队。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——文档以其为首要目标平台，提供
/plugin marketplace add pbakaus/impeccable插件市场安装方式与专属.claude集成目录 - Codex：✅ 原生支持——官方 provider 列表明确列出
codex，仓库含专属.codexhook 集成目录，SKILL 源文件内含专门针对 Codex 已知设计缺陷的规避规则 - OpenClaw：❓ 未验证——已抓取的 README、SKILL 源文件与 provider 列表均未提及
- Hermes Agent：❓ 未验证——同上，仅依据已抓取材料判断，未为此单独发起搜索
5. 推荐理由
jQuery UI 作者打造，23 条命令+46 条确定性规则打磨 AI 前端设计。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | 47,021 stars、2,824 forks（GitHub API）；但目前仅见作者官方渠道（X、官网）的产品说明，未发现独立于官方之外的第三方渠道讨论（详见第 8 章用户评价） |
| 可用性 | 9 | npx impeccable install 一条命令即可安装，另有 Claude Code 插件市场一键安装与 Git Submodule 团队方案；仓库最近一次提交为 2026-07-15，维护活跃；确定性规则运行不需要 LLM 或 API Key（见下方安全检查清单③），未见付费依赖 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合 | 8.7 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | SKILL 元数据 allowed-tools 明确限定为 Bash(npx impeccable *) 与 Bash(node {scripts_path}/*)，未见开放式 Bash 授权 |
| ② 运行时联网外发 | 已排查核心脚本，仅发现一处联网行为——向作者自有域名 impeccable.style/api/version 发起版本检查请求（自带超时、可用环境变量覆盖），未见向第三方外发用户代码或数据；脚本总量较大（单文件逾 40 万字符），本次未做逐行全量审计，仅完成关键网络出口点排查 |
| ③ API Key/凭据 | 不需要；文档明确确定性规则运行不依赖 LLM 与 API key |
| ④ 可疑指令（注入迹象） | 未发现注入迹象，抓取到的 SKILL 内容均为设计规范与反模式指导 |
| ⑤ 作者/组织信誉 | Paul Bakaus，GitHub 账号 2008 年创建，公开履历含 jQuery UI 作者、前 Google Developer Advocate，信誉良好 |
| ⑥ License | Apache License 2.0，明确 |
| ⑦ 最近维护时间 | 活跃，仓库最近一次提交为 2026-07-15，最新 skill 版本发布于 2026-07-01 |
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与本技能的差异 |
|---|---|---|
| UI/UX Pro Max（nextlevelbuilder，106K stars） | 本地可搜索的设计规则数据库（84 种风格/192 色板/74 字体搭配等），侧重生成建议 | 纯查询型数据库，无浏览器内实时迭代与确定性代码检测；其付费 Premium 层在 GitHub Issue 中被曝存在未解决的退款纠纷，信誉证据弱于本技能 |
| Taste Skill（Leonxlnx，63.8K stars） | 11 个设计变体+3 个图像生成技能，以 3 个 1–10 参数（DESIGN_VARIANCE 等）像调音台一样调节风格 | 参数化调性直观，但未见确定性检测规则与多 agent provider 级原生集成，安全细节透明度不如本技能 |
| frontend-design（Anthropic 官方） | 8 个预设“美学锚点”，各锁定一套调色板/字体/纹理直接套用 | 偏“选一种既定审美”，本技能偏“诊断问题+23 个命令持续打磨”，两者定位互补而非直接替代 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价：公开可见的内容仅有官方文档与作者本人在 X 与官网的产品说明，未见独立于官方渠道之外的第三方用户评价。
9. 其他补充
仓库同时包含独立 CLI（npm 包 impeccable）与浏览器扩展，二者共享同一套确定性检测规则，形成“规则可在无 LLM 场景复用”的架构；提供 Git Submodule 安装方式，便于团队统一版本管理；README 目前仅提供英文版本。
10. 安装使用方式
- CLI 一条命令（推荐）：
npx impeccable install，随后在编码 agent 内运行/impeccable init完成一次性设置（生成PRODUCT.md/DESIGN.md） - Claude Code 插件市场：
/plugin marketplace add pbakaus/impeccable，再于/plugin列表中安装 - Git Submodule（团队场景）：
git submodule add https://github.com/pbakaus/impeccable .impeccable，再执行npx impeccable link --source=.impeccable --providers=claude,cursor - 安装后注意：需重新加载 agent（reload harness）；Codex 用户安装/更新后需在
/hooks中重新批准项目级 hook；建议先执行/impeccable init建立项目设计上下文，再调用其余 22 个命令
11. 注意事项
- OpenClaw、Hermes Agent 生态的兼容性未经验证，若在这两个平台使用建议先小范围测试
- 核心脚本代码量较大（部分单文件逾 40 万字符），本报告的安全排查聚焦于关键网络出口点，未做逐行全量审计，安全敏感场景建议自行进一步代码审查
live等浏览器内迭代命令依赖 agent 自身具备浏览器控制/computer use 能力，不具备该能力的平台无法使用全部 23 个命令- 该技能尚无独立第三方用户评价可供参考，现有热度证据以 GitHub Star/Fork 与作者公开履历为主