技能库：导入与管理

把常用的 Agent Skills 保存进 Dinox：在手机上阅读和修改技能说明，把脚本、参考资料、模板一起保存，再通过 Skills API 下载到你的 Agent 工作环境。

本指南以 PDF 技能为例，展示 导入 → 检查 → 保存 → 下载使用 的完整流程。截图来自当前 iOS 客户端，Android 的文件选择界面由系统提供。

先了解保存的是什么

一个技能至少包含 SKILL.md：开头的 YAML 描述技能名称与用途，后面是 Markdown 指令正文，还可以附带 scripts/、references/、assets/ 等目录。格式参考 Agent Skills 规范。

导入后，Dinox 把它拆成你可以管理的笔记内容：

导入不会执行技能里的脚本，也不会自动把它安装到手机中的 AI 对话。 下载后，由支持该技能格式的 Agent 加载；Python、命令行工具等依赖仍需在运行环境中准备。

第一步：打开导入入口

在移动端打开新建内容面板，找到「解读文档」下方的 导入技能。进入后，可以选择 GitHub 链接或 ZIP 包。

如果没有看到入口，请使用包含技能导入功能的客户端版本；以下界面以当前实现为准。

第二步：选择来源

从公开 GitHub 仓库导入

1. 复制仓库、技能目录，或 SKILL.md 文件的 GitHub 网页链接。
2. 粘贴到「GitHub 技能链接」，点击 从 GitHub 读取。
3. 如果找到多个技能，先选择其中一个；只有一个时会直接进入预览。

例如，Anthropic 的 PDF 技能可以使用下面的目录链接：

https://github.com/anthropics/skills/tree/main/skills/pdf

也支持以下形式：

https://github.com/owner/repo
https://github.com/owner/repo/tree/branch-or-tag/path/to/skill
https://github.com/owner/repo/blob/branch-or-tag/path/to/skill/SKILL.md

当前支持公开仓库。Dinox 会把所选分支或标签解析到具体 commit，再读取仓库压缩包，因此来源版本可以追溯到当时的内容。即使只选择一个技能目录，读取阶段仍会下载仓库压缩包，过大的仓库可能超过导入限制。

从 ZIP 包导入

1. 把技能 ZIP 保存到手机可访问的文件位置。
2. 点击 上传 ZIP 包，在系统文件选择器中选择 ZIP。
3. 等待读取，再选择技能并检查预览。

ZIP 可以直接包含一个技能，也可以有一层外包装目录或包含多个技能。需要保留 SKILL.md 和附属文件的相对位置，例如：

pdf.zip
└── pdf/
    ├── SKILL.md
    ├── reference.md
    └── scripts/
        └── convert_pdf_to_images.py

不要只上传 SKILL.md 而遗漏它引用的脚本、模板或参考资料。ZIP 不包含可验证的 GitHub 来源信息，因此两个来源属性默认留空。

第三步：检查预览并保存

预览中会显示技能标识、用途描述和指令正文；向下滚动可以检查附属文件。确认选择正确后，点击底部 确认导入。

保存成功会提示「技能已保存，文件将在后台上传」，点击 查看技能 打开笔记。

第四步：在笔记中维护技能

导入完成后，顶部是技能属性，下方是可编辑的指令正文。示例 PDF 技能有 11 个附属文件；截图使用 ZIP 导入，因此来源链接和来源版本为空。

五个默认属性

导入器按固定的属性 key 创建或复用定义。界面显示名可以沿用你已有的名称；开发者接入应依赖 key。

skill_ 前缀用于区分技能属性和其他业务属性。当前没有自动创建 is_official 字段；来自公开仓库也不等于经过 Dinox 官方审核。

技能标识与笔记标题是两回事：你可以把笔记标题改成「我的 PDF 工具」，但继续用 pdf 作为技能标识。标识应使用小写英文字母、数字和单个连字符，长度不超过 64 个字符，不能以连字符开头或结尾；描述不能为空，最多 1024 个字符。

如果同一个 key 已存在但类型不匹配，导入会提示错误，不会擅自替换原来的属性定义。可先在 属性管理 中检查冲突，再重试。

正文和文件如何修改

编辑笔记正文，会改变下一次下载时的技能指令。修改「技能标识」「描述」会改变导出的 SKILL.md 元数据。无需把 YAML 头重新粘贴进正文，导出服务会生成它。

附属文件通过「文件」属性管理。文件名和路径也是技能的一部分：例如正文引用 scripts/convert_pdf_to_images.py，这个路径就必须与文件属性中的路径一致。删除或改名后，请同时检查正文和其他文件中的引用；导出校验无法判断脚本内部的所有依赖是否仍然正确。

来源版本与下载版本有什么区别

目前不会自动检查或拉取 GitHub 上游更新，也不会把手机里的修改推回 GitHub。 来源信息用于追溯。需要更新时，可以重新导入为一条新笔记，对比后再决定保留哪一份，尤其要先保留自己的修改。

第五步：下载到 Agent 使用

云端同步完成后，开发者或自建脚本可以：

1. 调用 Skills 列表接口，找到 exportable: true 的技能。
2. 用笔记 ID 请求下载信息，获取短期链接。
3. 下载 tar.gz，核对 SHA-256，再检查并解压。
4. 将完整技能目录放入目标 Agent 支持的位置，按照该工具的说明加载。

完整的请求示例、下载脚本和错误处理见 Skills API。当前没有专用的 dino skills install 命令，也没有自动把技能同步到本地 Agent 的安装器。

格式与大小限制

界面中的 MB 对应上述二进制大小限制。绝对路径、.. 越界路径、重复或冲突路径会被拒绝。导出保留文件内容与相对目录，但不保留 Unix 执行位或符号链接；Markdown 会经过保存和重新生成，不保证与原始 SKILL.md 逐字节一致。

常见问题

GitHub 读取失败或提示访问过于频繁

检查链接是否指向公开仓库和实际存在的目录。GitHub 匿名请求可能触发 403/429；稍后重试，或把完整技能目录打成符合大小限制的 ZIP 后导入。读取时间过长时可以取消并重试。

ZIP 中没有找到技能

确认包含大小写正确的 SKILL.md，开头有合法 YAML，且填写了 name 和 description。只有普通 Markdown 正文的压缩包不属于技能包。

保存成功，API 却显示不可导出

先等待文件上传和笔记同步。若仍失败，查看列表条目的 error：属性类型、缺失路径、已删除附件或存储访问异常也会导致不可导出。不要把不可导出等同于笔记已删除。

改完来源版本，为什么下载版本没有变

来源版本是一条追溯记录，不是导出内容版本。仅修改来源链接或来源版本不会改变技能指令和文件，因此不会单独触发 version_id 更新。

导入后，AI 为什么没有自动学会这个技能

导入完成的是保存和管理。执行端还需要下载完整目录、加载技能，并具备技能要求的工具与依赖；Dinox 不会仅因为笔记里出现脚本就执行它。

继续阅读：Skills API · 属性、模板与视图 · 让 AI 操作 Dinox：CLI Skills