skill creater
- Repo stars 277
- Author repo akashic-agent
- Domain
- Other
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @kachofugetsu09 · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Required · Vendor-specific
- Operating systems
- Linux
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Env read
- Network behavior
- External requests
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# Skill 创建指南
## 技能目录结构
```
$HOME/.akashic/workspace/skills/{skill-name}/ ← 用户自定义技能(优先)
SKILL.md ← 必须
scripts/ ← 可选,放辅助脚本
references/ ← 可选,放参考文档
项目/skills/{skill-name}/ ← 内置技能
SKILL.md
```
用 `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 行以内
**触发词要全**:中英文都写,覆盖用户可能说的各种表达方式。
## 创建流程
1. 确认技能名称和保存位置(workspace 还是内置)
2. 用 `write_file` 写入 SKILL.md
3. 如有辅助脚本,写入 `scripts/` 目录
4. 验证:`requires.bins` 里的命令是否正确
## 改写已有技能
改写时重点检查:
- frontmatter 是否有 `metadata` 字段(旧技能可能缺失)
- `requires.bins` 是否列全了依赖
- 正文是否有指向不存在脚本的引用(如 `init_skill.py`)
- 安装命令是否适配当前系统(Linux 用 `uv`/`pacman`/`apt`,而非 `brew`)
Sections and files
Listed in source order.
sections -> See the original source for section headings
terms -> No English key terms available
files/cmd -> write_file · edit_file · name · description · metadata · always · true · false
body sha256 -> de1748fa29da