技能检查器

贴上一个技能文件，看清是什么让它无法与任务匹配。

文件在浏览器里读取。描述你们内部流程的说明不会离开这台机器。

从零写一个新技能

关于 技能检查器

一个从不运行的技能，多半没有语法问题。它加载了，出现在列表里，却始终不被选中——因为描述没说何时适用，或者用的是没人会用的措辞。这种失败在设计上就是无声的：没有报错，没有警告，也没有任何"哪里不对"的信号。这个检查器像加载器那样读文件，报告畸形的地方，然后把几乎全部注意力放在描述上：有没有点明触发时机、够不够长到能被匹配、是不是一开口就在重复"这是一个技能"。加载器忽略的字段也会被指出来，因为键名写错，看上去和一个完全正确的文件一模一样。

功能特性

• 用真正的 YAML 解析器读取 frontmatter，指出失败位置
• 标出加载器不读的字段——键名写错就是这个样子
• 检查描述的触发语句与长度
• 给出描述字数与上限的对比
• 检查说明是否超过了"低于此长度不起作用"的界线
• 错误权重高于建议的评分
• 拖入文件，或直接粘贴
• 一个故意写坏的例子，用来看它能抓到什么

如何使用 技能检查器

1. 拖入 SKILL.md，或粘贴内容
2. 从最严重的往下读提示
3. 如果描述被点名，先改它——要紧的就是它
4. 反复检查，直到评分干净

示例

输入

description: Helps with PDFs

输出

Warning: says what the skill is, but not when to use it

技能从不被选中，最常见的原因就是这个。

常见错误与故障排除

• 它说没有 frontmatter，可明明有。 — 三个连字符必须是文件的第一行：上面不能有空行、注释或任何东西。
• 描述一长，YAML 就解析失败。 — 含"冒号加空格"的描述必须加引号，否则 YAML 会把它读成另一个键。
• 它标出了我故意加的字段。 — 未知字段是提示而不是错误。加载器会忽略它们；提示存在，是因为写错的键与正确的键长得一模一样。
• 没有错误，评分却一直很低。 — 警告同样扣分。常见的组合是：描述缺少触发语句，加上说明太短。

常见问题

技能能加载，为什么从不被选中？

描述会与任务做匹配。如果它只描述主题——"处理电子表格"——就没有东西能和一个请求对上。补一句点明情境、文件类型或人们真会用的词，通常就解决了。

什么算触发语句？

任何点明技能适用时刻的说法："当用户要求……时使用""每当迁移文件发生变化""处理……类任务时"。检查器寻找的就是这种形状，找不到就发出警告。

描述长是坏事吗？

本身不是——上限相当宽松，字数也会显示。真正有害的是又长又始终没说何时使用的描述，这种组合出人意料地常见。

能检查别人写的技能吗？

这是很好的用法。把别处拿来的技能拖进来，立刻能看出它的描述会不会跟你自己的技能抢，以及有没有声明你意料之外的工具。

结果干净就代表技能能用吗？

不。它只代表文件会加载，描述具备被匹配的形状。说明写得好不好，是任何检查器都不会下的判断。

相关工具

• 技能构建器 — 编写 SKILL.md，边输入边检查 frontmatter。
• 子代理构建器 — 生成子代理定义文件，含工具与模型设置。
• 系统提示检查器 — 找出自相矛盾、无效指令与未替换的占位符。
• 工具模式校验器 — 粘贴工具定义，查清它为何被拒绝或被错误调用。
• 项目说明构建器 — 写一份对得起每次请求开销的 CLAUDE.md。
• 斜杠命令构建器 — 构建自定义命令，带参数与工具白名单。

更多AI 与智能体工具

• 技能构建器 — 编写 SKILL.md，边输入边检查 frontmatter。
• 子代理构建器 — 生成子代理定义文件，含工具与模型设置。
• 斜杠命令构建器 — 构建自定义命令，带参数与工具白名单。
• 项目说明构建器 — 写一份对得起每次请求开销的 CLAUDE.md。
• 插件清单构建器 — 生成 plugin.json，并查看它所预设的目录结构。
• 钩子构建器 — 构建 settings.json 钩子，找出永远不会触发的匹配式。
• 权限规则测试器 — 用真实命令测试允许、询问与拒绝规则。
• MCP 服务器配置 — 为 stdio、HTTP 或 SSE 生成 MCP 服务器条目。
• MCP 工具模式构建器 — 定义工具并得到 JSON Schema，严格模式一并校验。
• 工具模式校验器 — 粘贴工具定义，查清它为何被拒绝或被错误调用。
• 提示模板填充 — 把一条提示展开到整张表格，并看清缺了哪些值。
• 系统提示检查器 — 找出自相矛盾、无效指令与未替换的占位符。
• 提示差异比较 — 逐词比较两个提示版本，并给出 token 差额。
• 少样本示例构建器 — 把输入输出对转成带标签、JSON 或对话格式的示例。
• XML 提示分节构建器 — 用内容无法越出的标签包裹提示的各个部分。
• JSONL 查看与校验 — 逐行读取、筛选并检查 JSONL 文件。
• 对话记录转换 — 把消息数组转成可读记录，也能转回去。
• 微调数据集校验 — 检查 chat 格式 JSONL，找出会中断训练的错误。
• SSE 流查看器 — 粘贴原始流式响应，取回正文、工具调用与用量。
• 上下文窗口规划 — 在提示、工具、历史与回复之间分配上下文窗口。
• 提示缓存规划 — 重排请求的各块，让可缓存前缀尽可能长。
• 文本切分 — 把文档切成有重叠的片段，只在真正的边界处断开。
• 代理循环成本估算 — 逐轮估算成本，计入重发的历史与缓存。
• 批量请求构建器 — 把表格转成批量任务，每条请求都有唯一 id。

查看全部AI 与智能体工具 · 全部工具