Skills

Skill 是一组按需加载的可复用指令，例如 release checklist、项目约定或多步流程。在真正使用前，完整内容不会进入 context，因此安装很多 skill 也不会让每次请求都变大。

创建和安装 skill

Skill 的结构

每个 skill 是一个包含 SKILL.md 的目录。文件 frontmatter 中必须有 name 和 description：

~/.minacode/skills/
  release-notes/
    SKILL.md
    generate.py        # optional bundled script

---
name: release-notes
description: Draft release notes from the git log since the last tag.
---

1. Run `git log $(git describe --tags --abbrev=0)..HEAD --oneline`.
2. Group the commits by type and summarize each group.
3. If a bundled script is needed, run it with Bash — see paths below.

使用 skill 前，minacode 只会看到它的 name 和 description；正文会按需加载。

Skill 的来源

minacode 从两个位置发现 skill：

  • .minacode/skills/ — 项目级 skill，可随仓库提交

  • ~/.minacode/skills/ — 个人 skill，在所有项目中可用；自定义 paths.data_dir 后位于 <data_dir>/skills/

如果两处存在同名 skill，项目级版本优先。使用 /skills 查看已安装列表。

使用 skill

  • 按需加载 — 当请求与某个 skill 相关时，minacode 会自行加载。

  • 行内引用 — 在消息中输入 $name（支持 Tab 补全），为当前一轮显式加载该 skill。

使用 `$skill` 引用行内加载 skill 指令

通过 $name 行内加载 skill。

配套脚本

Skill 可以在 SKILL.md 旁附带辅助脚本。正文中的 {skill_dir}（或 ${SKILL_DIR}）会展开为 skill 的绝对目录，因此可以让 agent 通过 Bash 运行脚本：

Run the generator: `python {skill_dir}/generate.py`