前言¶

在 Agent 里做「记一笔」「把网页收进资料库」「在知识库里搜某段话」，常见做法是各写一套提示词或零散脚本，笔记和知识库两套能力也对不齐。下面介绍 SkillHub 上的社区 Skill「1」：它把 IMA OpenAPI 下的笔记管理与知识库操作收进同一份 SKILL 说明，让模型按统一规则识别意图并走对应流程。

这是什么¶

「1」是面向 Agent 的 knowledge-management 类 Skill，坐标为 @user_aca80b9b/sk-3a9384a808454868983f9f9adea41c96，当前版本 1.0.0，来源为 community，由发布者 user_aca80b9b 维护。官方定位是：统一的 IMA OpenAPI 技能，支持笔记管理和知识库操作——即通过 IMA 开放接口，在同一 Skill 内覆盖个人笔记与知识库两类能力，而不是拆成多个互不相关的技能包。

SkillHub 页面标注标签 requires_api_key=false（表示技能元数据侧未声明必须配置 API Key；具体运行时是否还要 IMA 侧鉴权，以安装后 SKILL.md 与 IMA 文档为准）。

核心功能¶

以下能力均来自 SkillHub 简介与技能触发说明，未在资料中出现的接口名、参数不展开。

知识库¶

• 上传文件到知识库
• 将网页添加到知识库
• 搜索知识库内容

笔记¶

• 搜索笔记
• 浏览笔记
• 创建笔记
• 编辑笔记

意图触发范围¶

Skill 要求 Agent 在用户提到知识库、资料库、笔记、备忘录、记事，或表达上传文件、添加网页、搜索知识库、搜索/浏览/创建/编辑笔记时使用本 Skill。即使用户未直说「知识库」或「笔记」，只要意图属于文件进知识库、网页收藏、知识搜索、个人文档存取（例如「帮我记一下」「搜一下知识库里有没有 XX」），也应触发。

安装与启用¶

SkillHub 提供两种常见安装路径：用 skillhub CLI 装到当前 Agent 的 skills 目录，或把安装提示词交给 AI 按官方安装文档执行。

1、安装 SkillHub CLI（若尚未安装）¶

先检查是否已有 CLI：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅需要 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安装本 Skill¶

安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。

skillhub install @user_aca80b9b/sk-3a9384a808454868983f9f9adea41c96 --dir <skills 目录>

各环境常用 skills 目录（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/
• Claude Code：~/.claude/skills/

也可将下面提示词发给已接入 Skill 安装的 AI，让其按文档完成安装：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_aca80b9b/sk-3a9384a808454868983f9f9adea41c96`。

经过上面的步骤，重启或刷新 Agent 的 Skill 加载后，对话中符合触发条件的请求应路由到本 Skill。

典型用法¶

官方页面未附带独立命令行演示；可复现的用法即自然语言意图 + Skill 内定义的 IMA OpenAPI 流程。示例表述（与 Skill 简介一致，用于验证是否触发本 Skill）：

1. 「把这份 PDF 上传到知识库。」
2. 「把这个网页链接加到资料库。」
3. 「搜一下知识库里有没有关于 XX 的说明。」
4. 「帮我记一下：明天十点开会。」
5. 「打开最近的备忘录，改一下最后一段。」

Agent 加载 SKILL.md 后，应按技能说明选择笔记或知识库相关操作，而不是用通用网页搜索替代知识库检索。

适用场景与注意¶

适合谁：已在使用或计划对接 IMA OpenAPI、希望在一个 Skill 里统一「笔记 + 知识库」对话能力的开发者与个人用户；SkillHub 分类为 knowledge-management，与资料整理、检索、备忘场景一致。

平台数据（SkillHub 抓取，2026-10-21）：评分 100000，下载 1053 次；安装计数在抓取时为 0，以页面实时数据为准。

注意：

• 本稿未包含 SKILL.md 全文，具体 API 路径、鉴权字段、错误处理以安装包内文档为准。
• requires_api_key=false 仅表示 SkillHub 元数据标签；若 IMA 服务要求令牌或 OAuth，需在运行环境中单独配置。
• 社区来源（community）技能，升级与兼容性请通过 skillhub 或 SkillHub 页面核对版本 1.0.0。

结尾¶

「1」把 IMA 侧的笔记与知识库能力绑在同一套 Agent Skill 触发规则里，减少「该用哪个技能」的判断成本。需要安装或查看说明时，可使用 SkillHub 页面：

https://www.skillhub.cn/skills/user_aca80b9b/sk-3a9384a808454868983f9f9adea41c96

技能 API 入口（资料中的官方地址）：

https://api.skillhub.cn/user_aca80b9b/sk-3a9384a808454868983f9f9adea41c96