<objective>create-agent-skills 是一个用于创建、编写、构建与优化 Claude Code Skills 的技能,提供从技能结构设计到具体工作流的专家级指导。</objective>
<主要用途> 该技能面向需要编写或改进 Claude Code Skills 的场景,目标包括:学习技能如何工作、按最佳实践创建新技能、审计和修改已有技能、为现有技能添加组件,以及在缺乏明确方向时获取选择建议。
<核心原则> 根据资料,技能遵循以下基本原则:
- 技能即提示词(Skills Are Prompts):所有提示词最佳实践都适用,要求清晰、直接、使用 XML 结构,并假定 Claude 足够聪明,只补充其不具备的上下文。
- SKILL.md 始终会被加载:当技能被调用时,Claude 会读取 SKILL.md。关键原则应放在 SKILL.md 中(无法被跳过),工作流专属内容放入 workflows/,可复用知识放入 references/。
- 复杂技能采用路由模式(Router Pattern)。
- 使用纯 XML 结构:技能正文中不使用 markdown 标题(#, ##, ###),而使用语义化 XML 标签,如 <objective>、<process>、<success_criteria>;内容内部仍可保留加粗、列表、代码块等 markdown 格式。
- 渐进式披露(Progressive Disclosure):SKILL.md 保持在 500 行以内,将详细内容拆分到引用文件,仅加载当前工作流所需部分。
<目录结构> 资料给出的路由模式目录结构如下: skill-name/ ├── SKILL.md # 路由 + 原则 ├── workflows/ # 分步流程(FOLLOW) ├── references/ # 领域知识(READ) ├── templates/ # 输出结构(COPY + FILL) └── scripts/ # 可复用代码(EXECUTE)
各文件夹用途:workflows/ 为 Claude 遵循的多步骤流程;references/ 为 Claude 阅读以获取上下文的领域知识;templates/ 为 Claude 复制并填充的一致输出结构(计划、规格、配置);scripts/ 为 Claude 原样运行的可执行代码(部署、安装、API 调用)。
<简单技能与复杂技能> 简单技能(单文件)包含:YAML frontmatter(name、description),以及 <objective>、<quick_start>、<process>、<success_criteria> 等标签。 复杂技能(路由模式)的 SKILL.md 包含 <essential_principles>(始终适用)、<intake>(要询问的问题)、<routing>(将回答映射到工作流)。其中 workflows/ 包含 <required_reading>、<process>、<success_criteria>。
<使用方式> 技能以 <intake> 开场询问用户想做什么,提供四个选项:1. 创建新技能;2. 审计/修改现有技能;3. 添加组件(工作流/引用/模板/脚本);4. 获取指导。随后等待用户回答再继续。
<routing> 根据回应或用户明确意图进行路由:
- 选择 1 或“create”“new”“build” → 询问“任务执行型技能还是领域专家型技能?”,再路由到对应创建工作流。
- 选择 2 或“audit”“modify”“existing” → 询问技能路径,再路由到相应工作流。
- 选择 3 或“add”“component” → 询问添加什么类型,路由到 workflows/add-{type}.md。
- 选择 4 或“guidance”“help” → 通用指导,路由到 workflows/get-guidance.md。
- 意图路由示例:“audit this skill”“check skill”“review” → workflows/audit-skill.md;“verify content”“check if current” → workflows/verify-skill.md;“create domain expertise”“exhaustive knowledge base” → workflows/create-domain-expertise-skill.md;“create skill for X”“build new skill” → workflows/create-new-skill.md;“add workflow”“add reference”等 → workflows/add-{type}.md;“upgrade to router” → workflows/upgrade-to-router.md。阅读工作流后需严格遵循。
<工作流列表> 资料列出的工作流包括:create-new-skill.md(从零构建技能)、create-domain-expertise-skill.md(为 build/ 构建详尽领域知识库)、audit-skill.md(对照最佳实践分析技能)、verify-skill.md(检查内容是否仍然准确)、add-workflow.md、add-reference.md、add-template.md、add-script.md(向现有技能添加对应组件)、upgrade-to-router.md(将简单技能转换为路由模式)、get-guidance.md(帮助决定构建何种技能)。
<领域知识引用> references/ 中包含:结构与原则类 recommended-structure.md、skill-structure.md、core-principles.md、be-clear-and-direct.md、use-xml-tags.md;模式类 common-patterns.md、workflows-and-validation.md;资产类 using-templates.md、using-scripts.md;进阶类 executable-code.md、api-security.md、iteration-and-testing.md。
<YAML 要求> 必需字段为 name(小写连字符,与目录名匹配)和 description(说明做什么以及何时使用,第三人称)。命名约定包括:create-、manage-、setup-、generate-、build-*。
<成功标准> 一个结构良好的技能应满足:具有有效 YAML frontmatter;使用纯 XML 结构(正文无 markdown 标题);在 SKILL.md 中内联关键原则;根据用户意图直接路由到合适工作流;SKILL.md 保持在 500 行以内;仅在确实需要时提出最少的澄清问题;并已通过真实使用测试。
<许可与来源> 资料显示该技能引用上游文档,作者声明指向 paperclipai/companies 仓库中的 SKILL.md;引用文档来源为 glittercowboy/taches-cc-resources 的 skills/create-agent-skills/SKILL.md,修订版本为 0d915b80b95f9889673e1dc6a9059ed239764cde,署名 TÂCHES,许可证为 MIT。关于具体收费、价格、平台支持范围及更多使用步骤,资料暂未提供。
引用文档
以下为作者声明的引用来源,保留指定版本、署名和许可。
- glittercowboy/taches-cc-resources/skills/create-agent-skills/SKILL.md — 署名:TÂCHES;许可:MIT;版本:
0d915b80b95f9889673e1dc6a9059ed239764cde。