skill-creator
创建或更新 EDITH Skill,把可复用的工作方法、领域知识和资源组织成结构清晰的 Skill。当用户要求新增 Skill、修改已有 Skill、为某类任务沉淀流程时使用。
- License 许可
- MIT
- 所属仓库
- lucy971326/EDITH
- 最近更新
- 2026-08-18
- Stars
- ★ 71
- Forks
- 2
01 前言 Front Matter
- name
- skill-creator
- description
- 创建或更新 EDITH Skill,把可复用的工作方法、领域知识和资源组织成结构清晰的 Skill。当用户要求新增 Skill、修改已有 Skill、为某类任务沉淀流程时使用。
02 资源文件 4
- 参考文档edith.yaml108 B
- 脚本scripts/init_skill.py3.5 KB
- 脚本scripts/quick_validate.py3.6 KB
- 脚本scripts/sync_overview.py2.4 KB
03 SKILL.md 正文
EDITH Skill 创建指南
Skill 用来描述 Agent 如何完成一类任务;Tool 用来执行具体动作。
Skill = 工作方法、规则、判断流程
Tool = 文件操作、进程操作、外部 API 等执行能力
存放位置
EDITH 有两类 Skill:
skills/system/<skill-name>/ 公共 Skill:平台提供,只读
skills/custom/<skill-name>/ 用户 Skill:当前用户自己的内容,可编辑
skills/custom/overview.md 用户 Skills 摘要索引,由脚本生成
创建或修改用户 Skill 时,只能使用 skills/custom/ 下的路径,不能修改 skills/system/。
所有路径都必须是 Sandbox 工作区相对路径,不能使用绝对路径或 ..。
目录结构
最小 Skill 只需要一个 SKILL.md:
<skill-name>/
├─ SKILL.md 必须:摘要和完整规则
├─ edith.yaml 可选:EDITH 页面展示信息
├─ references/ 可选:按需读取的详细资料
├─ scripts/ 可选:需要稳定执行的脚本
└─ assets/ 可选:模板、图片等输出资源
SKILL.md 必须以 YAML 头部开始,并且只保留 name 和 description:
---
name: daily-summary
description: 帮助用户创建每日总结任务;当用户提到日报、每日总结或定时提醒时使用。
---
# 每日总结
这里写 Agent 执行这类任务时必须遵守的规则和步骤。
name 使用小写字母、数字和连字符,目录名与 Skill 名保持一致;description 同时说明能力和触发场景。
edith.yaml 只负责页面展示,不参与 Agent 的触发判断:
display_name: 每日总结
short_description: 创建和管理每日总结任务。
编写原则
- 只写模型不知道的内容:删除常识和空泛背景,优先保留规则、边界和决策条件。
- 先写稳定流程:把必须遵守的步骤写清楚;可变化的部分给 Agent 合理选择空间。
- 保持短小:
SKILL.md只放主流程,详细资料放到references/,脚本放到scripts/。 - 渐进加载:先让 Agent 看到摘要,只有任务需要时才读取正文和资源。
- 一层引用:
SKILL.md直接链接参考文件,不要继续嵌套多层引用。 - 不要堆无关文件:不要创建 README、安装说明、变更日志等辅助文档。
创建流程
按下面顺序完成,不要只写一个空目录:
确定 Skill 的任务边界和触发场景
↓
确定 name、description 和目录名
↓
创建 skills/custom/<skill-name>/
↓
写入 SKILL.md 的摘要和执行规则
↓
按需添加 references、scripts 或 assets
↓
重新读取并检查格式、路径和规则是否完整
使用 Sandbox 文件工具创建用户 Skill:
- 用
sandbox_make_directory创建目录。 - 用
sandbox_write_file写入SKILL.md和edith.yaml。 - 用
sandbox_read_file重新读取文件,检查 YAML 头部、正文和展示字段。 - 用
sandbox_list_files确认目录只包含实际需要的文件。 - 运行
sync_overview.py,更新skills/custom/overview.md。
Skill 自带三个可复用脚本:
skills/system/skill-creator/scripts/init_skill.py
skills/system/skill-creator/scripts/quick_validate.py
skills/system/skill-creator/scripts/sync_overview.py
需要创建骨架时运行 init_skill.py;完成创建、修改或删除后运行 quick_validate.py 和 sync_overview.py。
overview.md 是自动生成的摘要索引,不能手动编辑。这些脚本只使用 Python 标准库,不依赖额外安装包。
更新已有 Skill
- 先读取现有
SKILL.md,理解原有触发条件和规则。 - 只修改用户自己的
skills/custom/内容。 - 保留稳定的
name;除非用户明确要求,不要随意改名。 - 修改后重新读取完整文件,确认摘要仍准确、正文没有互相矛盾的规则。
- 修改后重新运行
sync_overview.py,保持用户 Skills 摘要索引同步。
运行时边界
Skills 摘要 ──► AgentRun ──► ManagedRunner
完整正文 ────► Agent 按需调用 Sandbox 文件工具读取
不要把完整 Skill 正文无条件复制到每次请求的指令中;不要把 Skill 当成 Tool,也不要在 Skill 中伪造用户身份或越过 Sandbox 的路径限制。
04 同仓库更多 Skills
skill-creator
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends EDITH's capabilities with specialized knowledge, workflows, or tool integrations.
cold-joke-explainer
拆解冷笑话的笑点机制(谐音/双关/反转/逻辑错位),让听者"懂一下"。适用于用户给出冷笑话并请求解释,或希望把笑点讲清楚的场景。
skill-creator
创建或更新用户私有 Skills。用户要求新增可复用的专业能力、工作流、领域规范,或要求修改已有用户 Skill 时使用。
concept-explanation
从问题倒推概念:先重建困境,再揭示本质,最后用跨领域类比建立心智模型
current-time
需要知道当前时间时,调用 get_current_time 工具。
dual-verify
派两个子 Agent 独立探索同一问题,主 Agent 对比审核结果,防止单 Agent 幻觉。用于源码分析、架构理解、外部研究、重要事实核查等场景。