用途:create-skill 提供创建有效技能的指导,当用户想新建或更新一个扩展代理能力的技能时使用。技能是模块化、自包含的包,为特定领域或任务提供专门知识、工作流和工具,相当于针对某领域的“上手引导”。
主要能力:讲解技能能提供什么(专门工作流、工具集成、领域专长、捆绑资源);阐述核心原则,如简洁优先、按任务脆弱性设置自由度;说明技能结构:必需的 SKILL.md(含 name、description 的 YAML frontmatter 与 Markdown 正文)以及可选的 scripts/、references/、assets/ 目录;介绍三级渐进式加载(元数据、SKILL.md 正文、捆绑资源)与拆分模式;给出创建流程:用具体示例理解技能、规划可复用内容、初始化技能、编辑技能、按实际使用迭代。
使用方式:按流程操作。命名采用动词开头,如 execute-plan、create-report。默认创建项目本地技能,路径为 {{local_skills_path}}/<skill-name>/;仅当用户明确要求全局技能时使用 {{global_skills_path}}/<skill-name>/。初始化示例:mkdir -p {{local_skills_path}}/edit-pdf/{scripts,references,assets},并创建 SKILL.md 与脚本,如 pdftk "$1" cat 1-endright output "$2",再 chmod +x。SKILL.md 正文保持精炼、建议 500 行以内,详细内容放入 references 并在 SKILL.md 中说明何时读取。
适用场景:需要为代理补充公司特定知识、文件格式或 API 操作、多步流程、可复用脚本与模板时。
限制:技能中不应包含 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等多余文档;避免深层嵌套引用;脚本需实际运行测试。资料未提供收费、价格、平台或效果信息。