Agent Skills(技能)

​

技能是什么

my-skill/
├── SKILL.md              # 必需:frontmatter + 指令正文
├── references/           # 可选:深层资料,按需加载
│   └── checklist.md
└── agents/openai.yaml    # 可选:展示元数据

---
name: my-skill
description: 一段话说清这个技能做什么、agent 什么时候该用它。
---

# My Skill

agent 要遵循的分步指令……
深层资料:见 [references/checklist.md](references/checklist.md)。

• name —— 小写字母、数字、连字符(如 h3-cinematic-director)。它是技能在所有地方的身份:/ 面板、MCP prompt、skills/ 下的文件夹名。
• description —— “什么时候用”的那段话。在 agent 判定任务命中之前,它只能看到这一段,所以要写具体:技能产出什么、期望什么输入、哪些说法应该触发它。

​

技能放在哪

​

管理技能

• 启用 Agent Skills —— 全局开关(默认开)。关掉后 skill 工具和所有技能 prompt 从 MCP 上消失。
• 每个已装技能显示来源(内置/用户)和描述,带逐技能开关。
• 导入 —— 上传包含单个技能文件夹的 .zip(SKILL.md 在 zip 根,或在唯一的顶层文件夹里)。不合规的包会被拒并给出原因。
• 删除 —— 仅限用户技能;内置技能只能禁用。

​

使用技能

/h3-cinematic-director  ⏎
shot-design: 雨夜巷口追逐的开场,三个镜头

​

写自己的技能

1. 在 <user 目录>/comfytv/skills/ 下建文件夹(或打成 .zip 走导入)。
2. 写 SKILL.md —— frontmatter 的 name + description,然后是指令正文。写给 agent 看而不是给人看:祈使句分步、精确字段名、硬规则、失败情形。
3. 长篇参考资料放 references/*.md,在 SKILL.md 里链接过去——agent 通过同一个 skill 工具按需拉取。
4. 到设置 → 技能里检查:你的技能应该在列且已启用。显示 invalid 时,行内会写明原因(缺 description、name 不合规、frontmatter 坏了)。

​

另见

• ComfyTV Bot —— / 面板就在它的聊天输入框里
• Agent 接入(MCP) —— skill 工具与 prompt 映射
• 侧边栏 —— 管理技能的设置面板