用途:skill-creator 提供创建有效技能的指导。技能是模块化、自包含的包,通过专门知识、工作流和工具扩展智能体能力,相当于特定领域或任务的“入门指南”,把通用智能体转变为具备流程知识与领域专长的专用智能体。
主要能力:技能可提供专门工作流(特定领域的多步骤流程)、工具集成(针对特定文件格式或 API 的说明)、领域专长(公司特定知识、模式、业务逻辑)以及捆绑资源(用于复杂重复任务的脚本、参考资料和资产)。
结构:每个技能包含必需的 SKILL.md 和可选的捆绑资源。SKILL.md 含必需的 YAML frontmatter 元数据(name、description 必填)和 Markdown 指令;可选目录包括 scripts/(可执行代码)、references/(按需加载到上下文的文档)、assets/(模板、图标、字体等输出用文件)。
存放位置:在 deepagents CLI 中,技能存放在 ~/.deepagents/<agent>/skills/,<agent> 为智能体配置名,默认是 agent,即 ~/.deepagents/agent/skills/。
创建流程:理解技能并给出具体示例;规划可复用内容;初始化技能;编辑技能并编写 SKILL.md;验证技能;根据实际使用迭代。初始化命令:npx tsx scripts/init_skill.ts <skill-name> --path <output-directory>,deepagents 场景用 npx tsx scripts/init_skill.ts <skill-name> --path ~/.deepagents/agent/skills。验证命令:npx tsx scripts/quick_validate.ts <path/to/skill-folder>,检查 YAML frontmatter 格式与必填字段、命名规范(连字符风格,最多 64 字符)、描述完整性(最多 1024 字符)以及 name 和 description 必填项。
核心原则:简洁是关键。上下文窗口是公共资源,技能与系统提示、对话历史、其他技能元数据及用户请求共享它。默认假设智能体本身已很强,只补充它尚不具备的上下文。
限制:资料未提供收费、价格、平台支持范围或效果保证等信息。