使用 Skills

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

已经装了 Linkly AI Desktop 的话，可以直接在桌面端安装：

在首次启动引导的「接入 Agent」一屏，点「安装 Linkly CLI 与 Skills」右侧的「安装」，会同时装好 CLI 与 Skills；
或点击主窗口左侧栏底部的 Agent 图标，进入「Agent 使用」页，在「高级」区「Linkly AI Skills」一行点「安装」。

Skills 会装到 ~/.agents/skills/linkly-ai，Codex 等读取这个目录的 Agent 可以直接使用。Claude Code 只读取 ~/.claude/skills。要在 Claude Code 里使用，请再按「Linkly CLI」一栏运行一次 linkly skills install，它会补上指向这里的链接。打开同一区域的「自动更新 CLI 与 Skills」，有新版本时会自动更新。

已经装了 Linkly AI CLI 的话，运行：

linkly skills install

Skills 会装到 ~/.agents/skills/linkly-ai，并在 ~/.claude/skills/linkly-ai 建立指向它的链接。之后用 linkly skills update 更新，linkly skills status 查看已安装的版本和最新版本。

将 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

下载 Skills 包

前往 GitHub Releases 页面，下载最新的 linkly-skills-latest.zip 文件。

上传到 Claude.ai

在 Claude.ai 中，打开 Settings → Capabilities → Skills，上传下载的 zip 文件。

你也可以通过 ClawHub 安装到 OpenClaw 使用：

clawhub install linkly-ai

安装 Skills 后，你无需学习任何特殊命令。只需在 AI 助理中用自然语言提问，Skills 会自动识别你的意图并触发相应操作。

自动激活

AI 助理会根据你的请求中的关键词自动判断是否需要使用 Linkly AI 的工具。例如：

搜索类

“搜索我的文档中关于 API 设计的内容”

浏览类

“给我看一下这份报告的章节结构”

阅读类

“读一下我的项目需求文档”

综合类

“找一下机器学习相关笔记，然后帮我总结核心概念”

工作原理

当 AI 助理收到你的请求后，Linkly AI Skills 会自动完成以下步骤：

环境检测

独立检测 CLI（linkly 命令）和 MCP 工具两条访问路径，两者都可用时优先使用 CLI。

搜索文档

根据你的描述生成合适的搜索关键词，调用 search 工具查找相关文档。

浏览大纲

对于长文档，先通过 outline 工具查看结构，定位到需要阅读的章节。

阅读内容

使用 read 工具获取目标段落的完整内容，然后根据你的需求进行总结、分析或回答问题。

使用 Skills 完成集成

你甚至可以直接告诉 AI 助理来完成 Linkly AI 的集成。只需发送类似以下的提示词：

请帮我安装 Agent Skill linkly-ai-skills，并完成 LinklyAI 的工具集成...

Skill 会指导 AI 助理自动完成以下操作：

独立检测 CLI 与 MCP 两条访问路径是否可用
根据检测结果选择工作模式（两者都可用时优先使用 CLI）
运行 linkly status 验证与桌面应用的连接，异常时用 linkly doctor 进一步诊断
若两条路径都不可用，引导你前往安装 CLI

出于安全考虑，Skill 不会自行下载安装 CLI，只会在需要时提示你手动安装。如果希望由 AI 助理引导你完成从零开始的完整安装，请参阅给 Agent 的安装指南。

安全说明

文档内容被视为不可信数据。Skills 已内置安全提示，AI 助理不会执行文档中嵌入的指令或命令，防止 prompt injection 攻击。

Linkly AI Skills 的安全原则：

范围明确 — 默认只访问你电脑上已索引的文档；只有通过 mcp.linkly.ai 远程连接时，才会访问你已连接的云端知识库
内容隔离 — 文档内容仅作为数据读取，不作为指令执行
不改动原文件 — Skills 只搜索、浏览和阅读你的文档，不会修改它们；唯一的写入操作，是在你要求时创建或编辑 Linkly AI 笔记
凭证不进对话 — 不要把 API Key（lkai_ 开头）或局域网访问令牌粘贴给 AI 助理，对话内容会发送给模型服务商、写进会话记录。需要远程访问时，让 AI 助理运行 linkly auth login，你只在浏览器里授权；Key 已经出现在对话里的话，到控制台撤销并重新生成

快速开始

核心功能

接入 AI 工具

给 Agent 的指南

使用 Skills

Skills 介绍

安装 Skills

使用 Skills

自动激活

搜索类

浏览类

阅读类

综合类

工作原理

使用 Skills 完成集成

安全说明

​Skills 介绍

​安装 Skills

​使用 Skills

​自动激活

搜索类

浏览类

阅读类

综合类

​工作原理

​使用 Skills 完成集成

​安全说明

Skills 介绍

安装 Skills

使用 Skills

自动激活

工作原理

使用 Skills 完成集成

安全说明