> ## 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/ja/use-skills](https://linkly.ai/docs/ja/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 は検索、閲覧、読み取り機能のみを提供し、ファイルを変更することはありません