用途:在 ai-agent-skills 目录中查找、比较和评估技能,帮助用户为任务挑选合适的技能,避免上下文被大量输出淹没,也避免未经评估直接安装。
主要能力与约束:使用 list/search/info 时始终加 --fields 控制输出体积,默认字段为 name,tier,workArea,description;安装前始终先执行 --dry-run;未经用户明确确认,一次安装不超过 3 个技能;在非交互式流水线中优先使用 --format json,当 stdout 不是 TTY 时 CLI 默认输出 JSON;浏览大型目录时使用 --limit,建议从 --limit 10 开始。
使用方式(命令保持原样): 搜索或浏览目录:npx ai-agent-skills search <query> --fields name,tier,workArea,description --limit 10 查看候选详情:npx ai-agent-skills info <skill-name> --fields name,description,tags,collections,installCommands 预览技能内容:npx ai-agent-skills preview <skill-name> 试运行安装:npx ai-agent-skills install <skill-name> --dry-run 确认试运行输出后再安装:npx ai-agent-skills install <skill-name>
注意事项:preview 命令会对技能内容做净化,剥离提示注入模式;若内容看起来被截断,可能是可疑模式被移除。集合安装会拉取多个技能,安装前务必先 --list 或 --dry-run。上游(非 vendored)技能在安装时需要联网获取,可用 --dry-run 验证来源是否可达。
适用场景:需要在安装前评估技能、比较候选技能、控制输出规模或验证安装来源时使用。限制:资料未提供具体收费、价格、平台支持范围及效果说明。