---
name: create-custom-skill
description: 当用户要把重复工作整理成可复用的 Agent skill，创建技能说明、配套文件与维护记录时使用。
---

# 把重复做法写成技能

先解决一个真实任务，再提炼哪些信息能改变 Agent 的判断或执行。技能只补充任务需要的知识，避免复述已有全局规则。

1. 阅读当前工作区约束和已有技能，确认重复任务、输入、输出与验收方式。同一目标优先更新已有技能。
2. 确认用户实际维护的内容正本和 Agent 技能目录，不猜机器路径。不以安装副本覆盖已有正本。
3. 用稳定的 name 和具体的 description 写 SKILL.md；正文保留适用条件、必要步骤、依赖与验收。配置由使用者提供，不写入私人路径、凭据或公司资料。
4. 只有确实需要时添加 references、scripts、assets 或 agents 元数据。配套文件用技能目录相对路径引用；确定性脚本应包含明确失败退出。
5. 用目标任务和相邻任务核实触发范围；有脚本时做无外部副作用的最小验证。记录已验证与未验证的内容。
6. 交付完整文件夹和使用条件；公开前检查所有配套文件。安装、上传、发布按用户当前任务的授权执行。

```text
my-skill/
  SKILL.md
  references/       # 长材料按需放入
  scripts/          # 可重复的确定性操作
```

维护方式由用户选择，可以是普通版本仓库，也可以是技能内容库。记录版本、更新时间、依赖和实际验证范围。新增技能先作为草稿；内容变化时递增版本，重新检查文件完整性。

若用户正在维护支持 catalog.json 的本站内容库，并且当前工作区存在 scripts/skills.cjs，可按 [本站内容库约定](references/site-library.md) 使用命令。普通用户无需安装这个网站或使用本站结构。