Skill v1.0.1

currentAutomated scan100/100

kachofugetsu09/akashic-agent/skill-creater

+3 new

──Details

PublishedOctober 26, 2026 at 08:19 PM

Content Hashsha256:db0bbf1ccaa4f6fc...

Git SHA0ac01d9a956c

Bump Typepatch

Compare with v1.0.0

──Files

Files (1 file, 2.5 KB)

SKILL.md2.5 KBactive

SKILL.md · 71 lines · 2.5 KB

version: "1.0.1" name: skill-creater description: 创建或改写 akashic-bot 技能（SKILL.md）。当用户要求新建技能、适配现有技能到当前格式、或修改技能内容时使用。

Skill 创建指南

技能目录结构

$AKASHIC_WORKSPACE/skills/{skill-name}/   ← 工作区技能（优先级最高）
  SKILL.md                                ← 必须
  scripts/                                ← 可选，放辅助脚本
  references/                             ← 可选，放参考文档
 
~/.akashic/skills/{skill-name}/           ← 用户级技能
随插件发布的技能                           ← 见 develop-akashic-plugin

用 write_file 或 edit_file 直接创建/修改文件，无需任何脚手架脚本。

SKILL.md 格式

markdown

---
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 行以内

触发词要全：中英文都写，覆盖用户可能说的各种表达方式。

创建流程

确认技能名称和保存位置（默认工作区；要随插件发布时改用 develop-akashic-plugin）
用 write_file 写入 SKILL.md
如有辅助脚本，写入 scripts/ 目录
验证：requires.bins 里的命令是否正确

改写已有技能

改写时重点检查：

frontmatter 是否有 metadata 字段（旧技能可能缺失）
requires.bins 是否列全了依赖
正文是否有指向不存在脚本的引用（如 init_skill.py）
安装命令是否适配当前系统（Linux 用 uv/pacman/apt，而非 brew）

← v1.0.0 All versions