メインコンテンツへスキップ

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
ClawHub から OpenLaw にインストールすることもできます:
clawhub install linkly-ai

Skills の使い方

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

自動アクティベーション

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

検索系

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

閲覧系

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

読み取り系

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

総合系

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

動作原理

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

環境検出

利用可能なアクセス方法を自動検出:CLI(linkly コマンド)を優先使用し、CLI が利用できない場合は MCP ツールを試行します。
2

ドキュメント検索

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

アウトライン閲覧

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

コンテンツ読み取り

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

Skills を使って統合を完了

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

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

Skill は AI アシスタントを以下の操作に自動的にガイドします:
  1. CLI がインストール済みか確認し、未インストールの場合は自動インストール
  2. linkly status を実行してデスクトップアプリとの接続を検証
  3. すべて準備が整ったことを確認した後、サービスを開始

セキュリティについて

ドキュメントの内容は信頼できないデータとして扱われます。Skills にはセキュリティプロンプトが組み込まれており、AI アシスタントがドキュメントに埋め込まれた指示やコマンドを実行することはなく、prompt injection 攻撃を防止します。
一部のセキュリティ検出では、この Skills に CLI ダウンロードのステップが含まれているため、悪意のある動作として誤検知される場合があります。安心してご利用ください。各 AI アシスタントプラットフォームと協力して、セキュリティ検出ルールを最適化し、誤検知を減らすよう取り組んでいます。
Linkly AI Skills のセキュリティ原則:
  • データがローカルから外に出ない — すべての検索と読み取り操作はお使いのコンピュータ上で完了します
  • コンテンツの分離 — ドキュメントの内容はデータとしてのみ読み取られ、命令として実行されることはありません
  • 読み取り専用操作 — Skills は検索、閲覧、読み取り機能のみを提供し、ファイルを変更することはありません