--- name: skill-radar description: 测评一个 AI skill(SKILL.md 那种技能包)并生成一份简约的单页长滚动 HTML。指向一个 skill 文件夹,自动读 SKILL.md 及配套文件,讲解它是什么、适合谁、怎么装、结构架构、工作流程,并做六维打分。产出一个可直接在浏览器打开、可分享的单文件 HTML。触发词:测评这个skill、skill测评、讲清楚这个skill、给这个skill做个介绍页、skill radar、评估一下这个技能包。 --- # skill-radar · AI Skill 测评与讲解 指向一个 skill 文件夹 → 读懂它 → 讲清楚 + 打分 → 产出一个简约的单页长滚动 HTML。 面向的痛点:现在 skill 太多,相似的也多,博主介绍得也不直观。这个 skill 用一个标准化的 HTML 页,把某个 skill 的「是什么/适合谁/怎么装/什么结构/怎么跑/值不值」一次性讲透。 **注意**:本 skill 测评的是「AI skill 技能包」,跟 `skill-review`(测评职场技能值不值得学)不是一回事,别混。 ## 何时使用 - "帮我测评一下这个 skill" + 给一个文件夹路径 - "把这个 skill 讲清楚,做个介绍页" - "评估下这个技能包,出个 HTML" ## 工作流(四步) **Step 1 · 读文件夹。** 读 skill 根目录的 SKILL.md(重点:name、description、触发词、工作流、边界),再扫 references/、examples/、templates/ 等配套文件。搞清楚它到底干什么、怎么干、有没有示例。 **Step 2 · 提炼六要素 + 打分。** 按下面「HTML 八段结构」抽内容,按「六维评分」打分。打分要有具体依据(引用 SKILL.md 里的证据),不能拍脑袋。 **Step 3 · 拿不准就反问。** 有几样文件夹里读不出来、必须问用户的,一次性问清(别逐条打断): - 安装方式(放进哪个平台?Claude Code / Claude 桌面 / 网页 / 其他,路径是什么) - 目标人群定位(如果 description 没写清) - 有没有想强调的亮点或已知短板 **Step 4 · 生成单文件 HTML。** 按 `references/layout-and-style.md` 的视觉规范,产出一个自包含的单文件 HTML(CSS 内联,结构图/流程图用纯 HTML+CSS 画,不依赖外部图片和 JS 库)。文件名 `skill-radar-.html`。 ## 六维评分(专给 AI skill,别用职场技能那套) 每维 1-10 分,每个分数必须配一句 20 字内的具体依据(引 SKILL.md 里的实际内容)。 | 维度 | 权重 | 看什么 | |------|------|--------| | 功能完整度 | 2 | 能不能真把事办成,覆盖多少场景,有没有半成品感 | | SKILL.md 质量 | 2 | 触发词/流程/边界是否清晰,Claude 好不好照着执行 | | 独特性/护城河 | 1.5 | 跟相似 skill 比,凭什么选它;可替代性高不高 | | 易用性 | 1 | 上手门槛、输入要求、要不要额外配置 | | 可复用/稳定性 | 1 | 换场景灵不灵,输出稳不稳,会不会经常翻车 | | 文档与示例 | 0.5 | 有没有 example、references,说明够不够 | **综合分** = Σ(各维分 × 权重) / Σ权重(总权重 8),保留一位小数。 评分档位参考:8.5+ 强烈推荐 / 7-8.5 推荐 / 5.5-7 视情况 / <5.5 暂不推荐。 ## HTML 八段结构(单页长滚动) 0. **`` 标签**:必须用被测 skill 的名字,格式 `<被测skill名> · Skill Radar 测评`。复制别的样板改内容时,务必先改 title,别留上一个 skill 的名字。 1. **封面**:skill 名 + 一句话结论(20 字内)+ 综合分(大号数字)+ 推荐档位 2. **这是什么**:解决什么痛点,核心能力一句话说清 3. **适合谁 / 不适合谁**:两栏对照,各 3 条,具体到人 4. **怎么装**:面向小白,给「通用三种装法」,跨平台通用(不只 Claude),从最省事往下排: - **① 让 AI agent 帮你装(首选)**:给出一句**完整可复制的提示词**,格式 `帮我把这个 skill 装上:<仓库/文件链接>`,用户整段复制发给正在用的 agent(Claude Code / Codex / WorkBuddy 等)即可。这句话要放进一个**带「复制」按钮的 copybox** 里(见下方组件),方便一键复制。 - **② 到技能市场搜索安装**:在平台的技能市场/技能商店搜 skill 名,点安装。适合不想碰链接的人。 - **③ 手动放置目录**:下载仓库后,把整个 skill 文件夹(含 references/ 等)放进技能目录,例如 `~/.claude/skills/<name>/`。 - 最后补一句触发方式。若该 skill 没有公开仓库链接(只有本地/zip 分发),则①改成 zip 导入或直接从②开始。 **copybox 组件**(提示词 + 复制按钮,需配一小段 `cp()` JS,见样板): ```html <div class="copybox"><div class="txt" id="p1">帮我把这个 skill 装上:<链接></div> <button onclick="cp('p1',this)">复制</button></div> ``` 这是本 skill 唯一允许的 JS(仅剪贴板复制),其余仍纯 HTML+CSS。`cp()` 要带 `execCommand` 兜底,因为 `file://` 本地打开时 `navigator.clipboard` 可能失败(见样板 script)。 5. **结构与架构**:文件构成 + 结构图(纯 CSS 画树状/框图) 6. **工作原理 / 流程**:分步流程图(纯 CSS 画箭头流程),讲清输入→处理→输出 7. **六维测评**:雷达图(纯 CSS/SVG)或评分条 + 每维依据 8. **总评与建议**:一段话总结 + 给谁在什么场景用 ## 小红书配图输出(可选,用户要发小红书时生成) 除主报告 HTML 外,额外生成一个 `xhs-cards-<skillname>.html`,包含 **1 封面 + 4 内容卡**,供截图后发小红书。 **卡片结构(5 张固定)**: - **封面**:深色底,skill 名大字,金色分数,一句钩子,账号署名 - **卡1 · 这是什么**:2-3 句核心能力 + 关键词标签 - **卡2 · 适合谁**:双栏对照(适合 / 不适合,各 3 条) - **卡3 · 六维评分**:评分条 + 综合分突出 - **卡4 · 怎么装 + 总评 + CTA**:首选安装提示词 + 一句总评 + 引导完整报告 **视觉风格**:小红书高饱和感,与主报告的墨水极简风有意区分。具体规范见 `references/layout-and-style.md` 的「小红书卡片」节。 **文件尺寸**:每张卡片 750×1000px,页面竖向排列,用户逐张截图。不依赖外部 JS。 ## 参考 - 视觉规范见 `references/layout-and-style.md`(沿用 consulting-deck 墨水 DNA + 单页滚动) - 样板产出见 `examples/`(拿真实 skill 跑的一版 HTML) - 打分体系的历史参照见桌面 guizang 测评记录(那是职场技能版,仅作加权公式参考)