用途:本技能是创建生产级 Agent Skill 的指南,适用于新建技能、改进已有技能,或诊断某个技能为何无法有效触发与工作。
核心理念:技能不是教 AI 做事,而是知识外化。工具定义模型“能做什么”(如 bash、read_file、write_file、WebSearch),技能注入模型“知道怎么做”的判断方式(如 PDF 处理、前端设计、代码审查)。其公式为:好技能 = 专家独有知识 − Claude 已有知识。相比训练,编辑 skills/SKILL.md 保存后即于下次触发生效,成本为 0,无需训练。
六项质量标准:一是 Token 效率,每段都需证明其 token 成本,只写 Claude 不知道的内容、决策树、陷阱清单与边界情况;二是心智模型优于机械步骤,传递专家如何思考;三是反模式清单,明确写出绝不要做的事;四是描述触发,description 是主要激活机制,需同时说明功能与使用场景;五是自由度校准,创意设计给高自由度,代码审查中等,文件格式操作低自由度并用精确脚本;六是加载触发设计,用 MANDATORY 强制读取语法与按任务类型的条件路由表,明确何时加载哪个 reference 文件。
五种技能类型:极简心智型(30-50 行,无引用目录,如 frontend-design);工具操作型(200-500 行,决策树加强制加载与详细代码,如 docx、xlsx、pdf);流程导向型(150-300 行,多阶段工作流与阶段检查点,如 mcp-builder);理念加执行型(100-150 行,先立理念再表达,如 canvas-design);导航路由型(20-50 行,主文件仅作路由,细节放 examples,如 internal-comms)。
创建流程:步骤一用具体示例理解使用方式;步骤二规划可复用内容(脚本、引用、资产);步骤三初始化结构,必须运行 scripts/init_skill.py <skill-name> --path <output-directory>;步骤四实现资源并删除占位文件;步骤五编写 skills/SKILL.md,使用祈使句、以代码示例代替冗长解释,目标 500 行以内。frontmatter 包含 name、description,可选 dependencies、allowed-tools;description 最长 1024 字符。
限制:资料未提供安装方式、收费标准、价格与具体平台支持范围,这些事实暂未提供。