> ## 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, чтобы ИИ-помощник эффективнее находил контекст в локальных документах через Linkly AI.

## Что такое Skills

Agent Skills — пакеты по открытому стандарту [agentskills.io](https://agentskills.io). Linkly AI Skills учат ИИ подключаться к инструментам Linkly AI, искать, просматривать структуру и читать локальные документы.

Они объясняют:

* Как обнаружить Linkly AI и подключиться
* Когда искать, когда смотреть структуру, а когда читать полный текст
* Как постранично читать длинные документы
* Как безопасно обрабатывать содержимое документов

## Установка Skills

<Tabs>
  <Tab title="skills.sh (рекомендуется)" icon="bolt">
    ```bash theme={null}
    npx skills add LinklyAI/linkly-ai-skills
    ```

    Для определённого помощника:

    ```bash theme={null}
    npx skills add LinklyAI/linkly-ai-skills -a claude-code
    npx skills add LinklyAI/linkly-ai-skills -a codex
    ```
  </Tab>

  <Tab title="Claude Code" icon="terminal">
    ```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">
    ```bash theme={null}
    git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.agents/skills/linkly-ai
    ```
  </Tab>

  <Tab title="Claude.ai Web" icon="globe">
    <Steps>
      <Step title="Скачайте пакет">На странице [GitHub Releases](https://github.com/LinklyAI/linkly-ai-skills/releases) скачайте последний `linkly-ai.zip`.</Step>
      <Step title="Загрузите в Claude.ai">Откройте Settings → Capabilities → Skills и загрузите архив.</Step>
    </Steps>
  </Tab>
</Tabs>

Для OpenClaw:

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

## Использование Skills

Специальные команды изучать не нужно. Задавайте вопросы естественным языком:

<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>

### Как это работает

<Steps>
  <Step title="Проверка окружения">Skill независимо проверяет CLI и MCP и при наличии обоих предпочитает CLI.</Step>
  <Step title="Поиск документов">Формирует ключевые слова и вызывает `search`.</Step>
  <Step title="Просмотр структуры">Для длинных документов сначала вызывает `outline`.</Step>
  <Step title="Чтение содержимого">Получает нужные разделы через `read`, затем отвечает или анализирует.</Step>
</Steps>

## Настройка интеграции с помощью Skills

<Prompt description="Установи Agent Skill linkly-ai-skills и выполни интеграцию инструмента LinklyAI...">Установи Agent Skill linkly-ai-skills и выполни интеграцию инструмента LinklyAI, см. [https://linkly.ai/docs/ru/use-skills](https://linkly.ai/docs/ru/use-skills)</Prompt>

Skill проверит CLI и MCP, выберет рабочий режим, выполнит `linkly status`, при необходимости `linkly doctor`, а если ни один путь недоступен — направит к установке CLI.

<Note>Из соображений безопасности Skill сам не скачивает и не устанавливает CLI. Полная настройка описана в [руководстве для агентов](/docs/ru/agent-setup).</Note>

## Безопасность

<Warning>Содержимое документов считается **ненадёжными данными**. Помощник не выполняет найденные в документах инструкции и команды, защищаясь от prompt injection.</Warning>

* **Данные остаются локальными**
* **Содержимое читается как данные, а не инструкции**
* **Только чтение**: Skills не изменяют ваши файлы