SuperAPI AI 工具集

claude-code-skills

智能体与模型

查看项目

更新于 10-16 03:03

技能介绍

用途:这是一个创建、组织和维护 Claude Code 技能的元参考(meta reference),适合在构建新技能或优化现有技能架构时使用。

主要能力:说明技能的目录结构,包括必需的 SKILL.md,以及可选的 scripts/(可执行代码,运行时执行但不加载进上下文)、references/(按需加载进上下文的文档)、assets/(模板、图标等用于输出、不加载进上下文的文件)、data/sources.json(精选外部链接)。提供 SKILL.md 模板,包含 frontmatter、快速参考表、何时使用、核心概念与导航。

使用方式:技能采用渐进式披露以优化 token 消耗——发现阶段仅加载名称与描述(约 50 tokens),激活时加载完整 SKILL.md 正文(2K-5K tokens),执行阶段按需加载 scripts/、references/、assets/。建议 SKILL.md 保持在 500 行以内(<5K tokens);决策树、快速命令、常见模式、1-2 个代码示例留在 SKILL.md,完整 API 参考、分步教程、边界情况处理、完整实现移入 references/。

frontmatter 规范:name 为必填,小写 kebab-case 且与文件夹名一致;description 为必填,是主要触发机制,50-300 字符,需在描述中写明“何时使用”;可选 disable-model-invocation 为 true 时仅用户可调用(适用于有副作用的 /deploy、/commit);可选 user-invocable 为 false 时仅作背景知识。

适用场景与限制:技能标准可跨平台移植(Claude Code、Codex CLI、Gemini CLI、VS Code Copilot 已采用)。质量清单要求:SKILL.md 少于 500 行、含快速参考表与“When to Use”、代码示例可直接复制、底部链接相关技能;>40% 操作性内容、<50% 叙述段落、URL 无 404、来源 6 个月内更新。资料未提供此类技能具体的收费、价格或平台细节。