超限的技能会在列表里标黄

Cursor CLI v2026.10.08 的 /skills 会给超限但仍能加载的技能标出黄色警告数。点开后列出要改的项:名字超过 64 字符或不是小写连字符,frontmatter 的 name 和文件夹不一致,描述超过 1024 字符,正文大约超过 5000 token。技能不会因此卸载。

超限的技能会在列表里标黄

技能还能用,但规格已经超了。Cursor CLI v2026.10.08 在 /skills 里给这种技能加上黄色警告计数。cursor cli skills 超限警告 点开某一条之后,会列出要改什么。更新日志写明四项:名字超过 64 个字符,或不是小写加连字符;frontmatter 里的 name 和文件夹不一致;描述超过 1,024 个字符;正文大约超过 5,000 个 token。

作者:CodePass 技术编辑

警告不是卸载

日志写的是「能加载,但超出 Agent Skills 规格的限制」。黄色数字出现,不表示这条技能已被关掉。选中它看到的是要修的清单,不是一条禁用开关。低于 v2026.10.08 的 CLI 没有这句,超限技能可能仍静静加载。

「大约 5,000 token」带了 about。正文刚好卡在附近时,警告出不出现,日志没有精确到个位。描述的 1,024 是字符。名字的 64 也是字符,并且要求小写连字符形式。中文名字对不上这个形式时,会落在「不是小写连字符」这一项,日志没有为中文另开例外。

frontmatter 的 name 必须和文件夹一致。文件夹改了、文件头没改,警告会指出这一处。它没有写会自动改名。

规格细节在 SKILL.md,不在这句里

更新日志让读者去看 SKILL.md 格式。本文不把那份格式重抄一遍。/skills 的警告只覆盖上面四项。别的字段缺了、工具权限写错,不要用「没有黄标」当成格式全部合格。

多个技能同时超限时,列表上是一个警告计数。点进某一条才看到该项的问题。日志没有写计数是按技能条数还是按问题条数。写作日没有在 CLI 里制造一条超限技能做对照。

描述超长和正文超长要分开改。描述是给人和列表看的短句,正文是技能被用到时送进上下文的内容。只缩短描述、正文仍大约超过 5,000 token,黄标会留着。只改文件夹名字、frontmatter 的 name 仍是旧的,同样留着。四项都清掉之后,日志没有写黄标会在不重启的情况下立刻消失。改完再打开一次 /skills 更稳妥。

参考资料