kachofugetsu09 Skill 创建指南
技能目录结构
$HOME/.akashic/workspace/skills/{skill-name}/ ← 用户自定义技能（优先）
SKILL.md ← 必须
scripts/ ← 可选，放辅助脚本
references/ ← 可选，放参考文档
项目/skills/{skill-name}/ ← 内置技能
SKILL.md
用 write_file 或 edit_file 直接创建/修改文件，无需任何脚手架脚本。
SKILL.md 格式
---
name: skill-name
description: 一句话说明技能功能 + 触发场景。触发词：词1, 词2, 词3
metadata: {"akashic": {"always": false, "requires": {"bins": ["curl"], "env": ["API_KEY"]}}}
---
# 技能标题
正文指令...
frontmatter 字段说明
name：技能目录名（小写，连字符）description：最重要的字段。agent 靠它判断何时触发此技能，务必包含功能描述和触发词metadata：运行配置always：true= 每轮对话都注入完整正文；false= 按需加载（默认）requires.bins：所需 CLI 工具，缺失时技能标记为不可用requires.env：所需环境变量，缺失时技能标记为不可用
写作原则
简洁优先：SKILL.md 会被注入到 context，每个 token 都有成本。
- 只写 agent 不已知的信息
- 用示例命令代替大段文字解释
- 把冗长的参考内容放到
references/子文件，在 SKILL.md 里注明"详见 references/xxx.md" - 正文控制在 100 行以内
触发词要全：中英文都写，覆盖用户可能说的各种表达方式。
创建流程
- 确认技能名称和保存位置（workspace 还是内置）
- 用
write_file写入 SKILL.md - 如有辅助脚本，写入
scripts/目录 - 验证：
requires.bins里的命令是否正确
改写已有技能
改写时重点检查：
- frontmatter 是否有
metadata字段（旧技能可能缺失） requires.bins是否列全了依赖- 正文是否有指向不存在脚本的引用（如
init_skill.py） - 安装命令是否适配当前系统（Linux 用
uv/pacman/apt，而非brew）