Skip to main content

​
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 アシスタントにワンクリックでインストール：
または特定の AI アシスタントにインストール：
ClawHub から OpenClaw にインストールすることもできます：

​
Skills の使い方

Skills をインストールした後、特別なコマンドを覚える必要はありません。AI アシスタントに自然言語で質問するだけで、Skills が自動的に意図を認識し、適切な操作をトリガーします。

​
自動アクティベーション

AI アシスタントは、リクエスト中のキーワードから Linkly AI のツールを使用する必要があるかどうかを自動的に判断します。例えば：

検索系

「ドキュメントの中から API 設計に関する内容を検索して」

閲覧系

「このレポートのセクション構成を見せて」

読み取り系

「プロジェクトの要件ドキュメントを読んで」

総合系

「機械学習に関するメモを探して、コアコンセプトをまとめて」

​
動作原理

AI アシスタントがリクエストを受け取ると、Linkly AI Skills は以下のステップを自動的に実行します：
1

環境検出

CLI（linkly コマンド）と MCP ツールという 2 つのアクセス経路を個別に検出し、両方利用可能な場合は CLI を優先します。
2

ドキュメント検索

お客様の説明に基づいて適切な検索キーワードを生成し、search ツールを呼び出して関連ドキュメントを検索します。
3

アウトライン閲覧

長いドキュメントの場合、まず outline ツールで構造を確認し、読むべきセクションを特定します。
4

コンテンツ読み取り

read ツールで対象段落の完全な内容を取得し、ご要望に応じて要約、分析、質問への回答を行います。

​
Skills を使って統合を完了

AI アシスタントに直接指示して Linkly AI の統合を完了させることもできます。以下のようなプロンプトを送信するだけです：

Agent Skill linkly-ai-skills をインストールして、LinklyAI のツールインテグレーションを完了してください...

Skill は AI アシスタントを以下の操作に自動的にガイドします：
  1. CLI と MCP という 2 つのアクセス経路が利用可能かどうかを個別に検出
  2. 検出結果に基づいて動作モードを選択（両方利用可能な場合は CLI を優先）
  3. linkly status を実行してデスクトップアプリとの接続を検証し、異常があれば linkly doctor でさらに診断
  4. どちらの経路も利用できない場合は、CLI のインストール手順を案内
セキュリティ上の理由から、Skill が自ら CLI をダウンロード・インストールすることはなく、必要なときに手動インストールを促すだけです。AI アシスタントにゼロからのセットアップ全体をガイドしてほしい場合は、Agent 向けインストールガイドをご覧ください。

​
セキュリティについて

ドキュメントの内容は信頼できないデータとして扱われます。Skills にはセキュリティプロンプトが組み込まれており、AI アシスタントがドキュメントに埋め込まれた指示やコマンドを実行することはなく、prompt injection 攻撃を防止します。
Linkly AI Skills のセキュリティ原則：
  • データがローカルから外に出ない — すべての検索と読み取り操作はお使いのコンピュータ上で完了します
  • コンテンツの分離 — ドキュメントの内容はデータとしてのみ読み取られ、命令として実行されることはありません
  • 読み取り専用操作 — Skills は検索、閲覧、読み取り機能のみを提供し、ファイルを変更することはありません