Skills 介绍 Agent Skills 是遵循 agentskills.io 开放标准的技能包。Linkly AI Skills 教会你的 AI 助理如何连接和使用 Linkly AI 的工具，从而让 AI 能够搜索、浏览和阅读你的本地文档。
为什么需要 Skills？ 安装 Linkly AI Desktop 后，你已经拥有了强大的文档索引和检索能力。但 AI 助理（如 Claude Code、Codex）并不知道如何使用这些工具。Skills 就像一份”使用说明书”，让 AI 助理自动掌握正确的使用方法，包括：
如何检测和连接 Linkly AI
何时搜索、何时浏览大纲、何时阅读全文
如何处理长文档的分页阅读
如何安全地对待文档内容
安装 Skills
使用 skills.sh 一键安装到所有支持的 AI 助理： npx skills add LinklyAI/linkly-ai-skills
或安装到指定的 AI 助理： # Claude Code npx skills add LinklyAI/linkly-ai-skills -a claude-code # Codex CLI npx skills add LinklyAI/linkly-ai-skills -a codex
将 Skills 克隆到 Claude Code 的 skills 目录： # 个人级别（所有项目可用） git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.claude/skills/linkly-ai # 项目级别（仅当前项目可用） git clone https://github.com/LinklyAI/linkly-ai-skills.git .claude/skills/linkly-ai
将 Skills 克隆到 Codex CLI 的 skills 目录： git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.agents/skills/linkly-ai
上传到 Claude.ai
在 Claude.ai 中，打开 Settings → Capabilities → Skills，上传下载的 zip 文件。
你也可以通过 ClawHub 安装到 OpenLaw 使用：
clawhub install linkly-ai
使用 Skills 安装 Skills 后，你无需学习任何特殊命令 。只需在 AI 助理中用自然语言提问，Skills 会自动识别你的意图并触发相应操作。
自动激活 AI 助理会根据你的请求中的关键词自动判断是否需要使用 Linkly AI 的工具。例如：
综合类 “找一下机器学习相关笔记，然后帮我总结核心概念”
工作原理 当 AI 助理收到你的请求后，Linkly AI Skills 会自动完成以下步骤：
环境检测
自动检测可用的访问方式：优先使用 CLI（linkly 命令），如果 CLI 不可用则尝试
MCP 工具。
搜索文档
根据你的描述生成合适的搜索关键词，调用 search 工具查找相关文档。
浏览大纲
对于长文档，先通过 outline 工具查看结构，定位到需要阅读的章节。
阅读内容
使用 read
工具获取目标段落的完整内容，然后根据你的需求进行总结、分析或回答问题。
使用 Skills 完成集成 你甚至可以直接告诉 AI 助理来完成 Linkly AI 的集成。只需发送类似以下的提示词：
请帮我安装 Agent Skill linkly-ai-skills， 并完成 LinklyAI 的工具集成...
Skill 会指导 AI 助理自动完成以下操作：
检查 CLI 是否已安装，未安装则自动安装
运行 linkly status 验证与桌面应用的连接
确认一切就绪后，开始为你服务
安全说明 文档内容被视为不可信数据 。Skills 已内置安全提示，AI
助理不会执行文档中嵌入的指令或命令，防止 prompt injection 攻击。
某些安全检测会因为这个 Skills 中存在下载 CLI 的步骤而被误报为恶意行为，请放心使用。我们正在与各大 AI 助理平台合作，优化安全检测规则，减少误报。
Linkly AI Skills 的安全原则：
数据不离开本地 — 所有搜索和阅读操作都在你的电脑上完成内容隔离 — 文档内容仅作为数据读取，不作为指令执行只读操作 — Skills 只提供搜索、浏览和阅读能力，不会修改你的文件 
