# 安装 Dinox Skills

> 把 13 个 Dinox Skills 装进 Claude Code、Codex、Hermes Agent 和 OpenClaw，让 AI 助手用自然语言操作你的 Dinox 知识库，并学会检查、升级和清理技能。

- 网页：https://dinox.info/guides/cli/skills
- 本页 Markdown：https://dinox.info/guides/cli/skills.md
- 全部文档索引：https://dinox.info/llms.txt

**Skills（技能）** 是写给 AI 助手看的说明书。装好 Dinox Skills 后，你对 Claude Code 或 Codex 说「帮我把这周的会议纪要整理一下」，它就知道该调用哪些 `dino` 命令、按什么顺序、哪些操作要先问你。

Dinox Skills 遵循开放的 [Agent Skills 规范](https://agentskills.io)，可以用在 Codex、Claude Code、Hermes Agent、OpenClaw 等兼容的 AI 助手里。

![截图：Dinox Skills 的安装与工作方式（装好 dino 并登录 → 一条命令把技能装进各个 AI 助手 → 你说人话 → AI 选技能、调用 dino）](https://dinox.info/assets/docs/cli/diagram-skills.webp)

## 安装前准备

先按 [安装与登录](https://dinox.info/guides/cli/install.md) 装好 `dino` 并扫码登录。Skills 只是告诉 AI 怎么用 `dino`，真正干活的还是本机的 `dino`。

## 案例：一次装进所有 AI 助手

### 第 1 步：让 dino 告诉你安装命令

Skills 的版本必须和 CLI 一致。不用自己拼命令，`dino info` 会直接给出与当前版本匹配的那一条：

```bash
dino info --format json --select skills_version,skills_install_command
```

![截图：获取 Skills 安装命令（skills_install_command：固定安装器版本、固定到 v2.20.2 tag、显式列出四个 AI 助手）](https://dinox.info/assets/docs/cli/skills-install.webp)

### 第 2 步：运行这条命令

```bash
npx --yes skills@1.5.16 add ryzencool/dinox-cli-skills#v<版本号> -g -a codex -a claude-code -a hermes-agent -a openclaw --skill '*' -y
```

`-g` 表示全局安装（所有项目都能用），`--skill '*'` 装全部 13 个技能。只给某一个助手装时，保留固定版本号，只写一个 `-a`，例如 `-a claude-code`。

### 第 3 步：重启 AI 助手

装好后，各个助手从下面的目录读取技能。重启对应的助手，技能就生效了：

| AI 助手        | 技能目录                  |
| ------------ | --------------------- |
| Claude Code  | `~/.claude/skills/`   |
| Codex        | `~/.agents/skills/`   |
| Hermes Agent | `~/.hermes/skills/`   |
| OpenClaw     | `~/.openclaw/skills/` |

在 Claude Code 里输入 `/` 就能看到以 `dino-` 开头的技能；不过平时不需要手动调用，直接说你要做什么，它会自己挑。

> **注意**
> 不要省略 `-a` 列表。安装器的自动检测可能沿用上次的选择、悄悄跳过某些助手，却仍然显示安装成功。也不推荐项目级安装（去掉 `-g`）：Hermes 默认不读项目里的技能目录。

## 13 个技能各管什么

![截图：13 个 Dinox Skills 一览（每个技能负责一个领域，AI 根据你说的话自动挑选）](https://dinox.info/assets/docs/cli/diagram-skill-map.webp)

| 技能                       | 负责                                  | 你可以这样说                |
| ------------------------ | ----------------------------------- | --------------------- |
| `dino-note`              | 笔记：搜索、阅读、新建、编辑、导出、插图、加星、删除、标签和文件夹归属 | 「找找我关于习惯的笔记，整理成一条新笔记」 |
| `dino-manage-todo`       | 待办：查询、添加、完成、优先级、截止时间、子任务            | 「通知团队升级做完了，帮我勾掉」      |
| `dino-manage-tags`       | 标签层级：新建、改名、移动、合并、清理                 | 「把终端技巧改名叫命令行技巧」       |
| `dino-manage-boxes`      | 文件夹层级：新建、改名、移动、合并、清理                | 「建一个『读书/2026』文件夹」     |
| `dino-manage-properties` | 属性定义和笔记上的属性值                        | 「把《深度工作》的阅读状态改成在读」    |
| `dino-manage-views`      | 保存的视图：查询、统计、新建                      | 「我的书单里有哪些书？」          |
| `dino-manage-prompts`    | 提示词库                                | 「找出我存的周报提示词」          |
| `dino-storage`           | 自定义存储：列出、测试、上传、统计                   | 「把这张图传到我的存储」          |
| `dino-sync`              | 同步、刷新、排查数据不是最新                      | 「手机上的笔记电脑上看不到」        |
| `dino-auth`              | 登录状态、身份、退出                          | 「我现在登录的是哪个账号？」        |
| `dino-config`            | CLI 配置，例如同步超时                       | 「把同步等待时间改成 20 秒」      |
| `dino-update-cli`        | 升级 CLI 和配套技能                        | 「dino 是最新版吗？」         |
| `dino-dinox`             | 安装、体检、命令结构、后台服务、Gateway 等基础设施       | 「dino 好像坏了，帮我体检一下」    |

每个技能都可以单独安装、单独使用，互不依赖。每个技能的真实对话过程见 [Skills 实战案例](https://dinox.info/guides/cli/skills-cases.md)。

## 升级与检查

升级 CLI 之后，或者 AI 的做法和文档对不上时，运行：

```bash
dino skills doctor
```

![截图：dino skills doctor 输出（上半部分：旧版技能是否还在（absent 表示已经没有了）；下半部分：每个当前技能的版本是否与 CLI 一致）](https://dinox.info/assets/docs/cli/skills-doctor.webp)

* 每个技能的状态：`current`（一致）、`outdated`（过期）、`missing`（没装）、`foreign`（同名但不是官方来源）。
* 用 `--format json` 时，`data.current.inSync` 为 `false` 就运行 `data.current.installCommand` 重新安装。
* 也可以直接问 AI 助手，`dino-update-cli` 技能会帮你核对：

![截图：Claude Code 检查 dino 和技能版本（「dino 是最新版吗？技能和命令行版本对得上吗？」—— 对比 npm 最新版、登录状态和技能版本）](https://dinox.info/assets/docs/cli/chat-update.webp)

### 清理旧版技能

早期版本的技能叫 `dinox`、`manage-tags`、`search-notes`、`dino-shared` 等，已经退役。它们会和新技能抢着被调用，还会教 AI 用过时的命令。清理前先预览：

```bash
dino skills migrate --dry-run
dino skills migrate --confirm
```

`migrate` 只删除名称、来源和内容都与官方退役清单完全一致的技能；你改过的、同名但来源不同的，一律保留，由你自己决定。

## 技能从哪里来

* 技能源码在 Dinox CLI 仓库里，每次发布 CLI 时同步发布到镜像仓库 [ryzencool/dinox-cli-skills](https://github.com/ryzencool/dinox-cli-skills)，并打上与 CLI 相同的版本 tag。安装命令里的 `#v2.20.2` 就是这个 tag，保证技能和 CLI 严格匹配。
* 安装器会在 `~/.agents/.skill-lock.json` 记录每个技能的来源和内容哈希，`dino skills doctor` 就是靠它判断版本和来源的。

> **提示**
> 想把 GitHub 或 ZIP 里的**其他**技能包保存到 Dinox、在手机上管理？请看 [技能库：导入与管理](https://dinox.info/guides/mobile/agent-skills-memory.md)；从自己的程序下载技能，请看 [Skills API](https://dinox.info/guides/skills-api.md)。