> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用 Skills

> 安装我们精心打磨的 Skills，让你的 AI 助理更好地利用 Linkly AI 从你本地文档中获取上下文，极大提升效率。

## Skills 介绍

Agent Skills 是遵循 [agentskills.io](https://agentskills.io) 开放标准的技能包。Linkly AI Skills 教会你的 AI 助理如何连接和使用 Linkly AI 的工具，从而让 AI 能够搜索、浏览和阅读你的本地文档。

**为什么需要 Skills？**

安装 Linkly AI Desktop 后，你已经拥有了强大的文档索引和检索能力。但 AI 助理（如 Claude Code、Codex）并不知道如何使用这些工具。Skills 就像一份"使用说明书"，让 AI 助理自动掌握正确的使用方法，包括：

* 如何检测和连接 Linkly AI
* 何时搜索、何时浏览大纲、何时阅读全文
* 如何处理长文档的分页阅读
* 如何安全地对待文档内容

## 安装 Skills

<Tabs>
  <Tab title="skills.sh（推荐）" icon="bolt">
    使用 [skills.sh](https://skills.sh) 一键安装到所有支持的 AI 助理：

    ```bash theme={null}
    npx skills add LinklyAI/linkly-ai-skills
    ```

    或安装到指定的 AI 助理：

    ```bash theme={null}
    # Claude Code
    npx skills add LinklyAI/linkly-ai-skills -a claude-code

    # Codex CLI
    npx skills add LinklyAI/linkly-ai-skills -a codex
    ```
  </Tab>

  <Tab title="Claude Code" icon="terminal">
    将 Skills 克隆到 Claude Code 的 skills 目录：

    ```bash theme={null}
    # 个人级别（所有项目可用）
    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
    ```
  </Tab>

  <Tab title="Codex CLI" icon="code">
    将 Skills 克隆到 Codex CLI 的 skills 目录：

    ```bash theme={null}
    git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.agents/skills/linkly-ai
    ```
  </Tab>

  <Tab title="Claude.ai 网页版" icon="globe">
    <Steps>
      <Step title="下载 Skills 包">
        前往 [GitHub Releases](https://github.com/LinklyAI/linkly-ai-skills/releases) 页面，下载最新的 `linkly-ai.zip` 文件。
      </Step>

      <Step title="上传到 Claude.ai">
        在 Claude.ai 中，打开 Settings → Capabilities → Skills，上传下载的 zip 文件。
      </Step>
    </Steps>
  </Tab>
</Tabs>

你也可以通过 [ClawHub](https://openclaw.org) 安装到 OpenClaw 使用：

```bash theme={null}
clawhub install linkly-ai
```

## 使用 Skills

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

### 自动激活

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

<CardGroup cols={1}>
  <Card title="搜索类" icon="magnifying-glass" iconType="duotone" horizontal>
    "搜索我的文档中关于 API 设计的内容"
  </Card>

  <Card title="浏览类" icon="list-tree" iconType="duotone" horizontal>
    "给我看一下这份报告的章节结构"
  </Card>

  <Card title="阅读类" icon="book-open" iconType="duotone" horizontal>
    "读一下我的项目需求文档"
  </Card>

  <Card title="综合类" icon="wand-magic-sparkles" iconType="duotone" horizontal>
    "找一下机器学习相关笔记，然后帮我总结核心概念"
  </Card>
</CardGroup>

### 工作原理

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

<Steps>
  <Step title="环境检测">
    自动检测可用的访问方式：优先使用 CLI（`linkly` 命令），如果 CLI 不可用则尝试
    MCP 工具。
  </Step>

  <Step title="搜索文档">
    根据你的描述生成合适的搜索关键词，调用 `search` 工具查找相关文档。
  </Step>

  <Step title="浏览大纲">
    对于长文档，先通过 `outline` 工具查看结构，定位到需要阅读的章节。
  </Step>

  <Step title="阅读内容">
    使用 `read`
    工具获取目标段落的完整内容，然后根据你的需求进行总结、分析或回答问题。
  </Step>
</Steps>

## 使用 Skills 完成集成

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

<Prompt description="请帮我安装 Agent Skill linkly-ai-skills， 并完成 LinklyAI 的工具集成...">
  请帮我安装 Agent Skill linkly-ai-skills， 并完成 LinklyAI
  的工具集成，参考：[https://linkly.ai/docs/zh/use-skills](https://linkly.ai/docs/zh/use-skills)
</Prompt>

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

1. 检查 CLI 是否已安装，未安装则自动安装
2. 运行 `linkly status` 验证与桌面应用的连接
3. 确认一切就绪后，开始为你服务

## 安全说明

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

<Warning>
  某些安全检测会因为这个 Skills 中存在下载 CLI
  的步骤而被误报为恶意行为，请放心使用。我们正在与各大 AI
  助理平台合作，优化安全检测规则，减少误报。
</Warning>

Linkly AI Skills 的安全原则：

* **数据不离开本地** — 所有搜索和阅读操作都在你的电脑上完成
* **内容隔离** — 文档内容仅作为数据读取，不作为指令执行
* **只读操作** — Skills 只提供搜索、浏览和阅读能力，不会修改你的文件