Elastic Agent Skills

Elastic Agent Skills — Elasticを開発したチームによる — は、AIコーディングエージェントにネイティブなプラットフォームの専門知識を直接提供します。これは公式のAgent Skillsライブラリであり、Cursor、GitHub Copilot、Windsurf、Gemini CLIなどのエージェンティックIDEと互換性があります。スキルはAgent Skillsのオープンスタンダードに準拠しています。

[!NOTE] テクニカルプレビュー

これらのスキルは初期リリースであり、活発に開発中です。堅牢な評価とモデルの進化に伴いスキルがコード化されるため、変更が予想されます。頻繁に更新を確認してください。

About

このリポジトリには、あらゆるAIエージェントにElasticsearch、Kibana、Elastic Observability、Elastic Securityの正しい使い方を教える、インストラクション、コンテキスト、ツールのパッケージである厳選されたスキルが含まれています。それらを既存のエージェントランタイムにドロップするだけで、アシスタントは時代遅れのパターンを使うのをやめ、正しく動作するようになります。

What are skills?

スキルは、AIエージェントに特定のタスクを繰り返し可能な方法で完了するための知識とツールを提供する自己完結型のパッケージです。各スキルは独自のフォルダ内にあり、エージェントが従うメタデータと指示を含むSKILL.mdファイルがあります。Agent Skills標準の詳細については、agentskills.ioを参照してください。

Scope

このリポジトリのスキルは以下に焦点を当てています:

• Elasticsearch APIとの対話（検索、インデキシング、クラスタ管理）
• Kibanaコンテンツの構築と管理（アラート、コネクタなど）
• Elastic Observability、Elastic Security、Agent Builderのパターン

利用可能なスキル

セキュリティに関する考慮事項

AIコーディングエージェントは、実際の認証情報、実際のシェルアクセス、そして多くの場合、実行ユーザーの全権限で動作します。それらのエージェントがセキュリティワークフローを対象とする場合、リスクは高まります。始める前にリスクについて率直に話し合う価値があります。

• 独自の脅威モデリングを実施してください。 エージェントがアクセスできるデータ、実行可能なアクション、予期しない動作が発生した場合の影響を評価してください。CISAの「AIシステムを安全に展開するための共同ガイダンス」が良い出発点です。
• エージェントを通過するデータに注意してください。 セキュリティデータには、PII、コマンドラインに埋め込まれた認証情報、その他の規制対象データが含まれる可能性があります。エージェントがアラートやプロセスイベントをクエリすると、そのコンテンツはモデルのコンテキストに入り、サードパーティのAPIに送信される可能性があります。情報セキュリティおよびコンプライアンスチームを早期に巻き込んでください。
• これらのエージェントは攻撃者制御の入力を処理します。 アラート、イベントフィールド、ファイルコンテンツには、攻撃者によって作成された文字列が定期的に含まれます。プロンプトインジェクションは理論上のものではなく、ここでは動作環境の固有の特性です。Brainwormのような研究は、エージェントコンテキストファイルだけでプロンプトウェアの永続メカニズムとして機能することを示しています。
• 権限を厳密にスコープしてください。 APIキーには必要最小限の権限のみを付与してください。広範な応答権限は特に危険です。動作を検証するまでは読み取り専用アクセスが良いデフォルトです。
• エージェントツールアクセスとネットワーク到達性を制限してください。 ほとんどのAIコーディングエージェントは広範なデフォルト（シェル実行、ファイルシステム書き込み、インターネットアクセス）を備えています。利用可能なツール面を減らすことで、侵害されたり誤った方向に誘導されたエージェントができることを制限します。
• 非本番環境から始めてください。 ライブセキュリティデータを扱うものに接続する前に、サーバーレストライアルプロジェクト、開発クラスター、または分離されたKibanaスペースを使用してスキルを評価してください。

これらのスキルは、まさに何を行うかを監査できるようにオープンソースになっています。実行する前に読むことをお勧めします。

はじめに

Elasticスキルは、Claude Codeのネイティブプラグインシステム、npxを使用したskills CLI、またはこのリポジトリをクローンしてバンドルされたインストーラスクリプトを実行することでインストールできます。npxメソッドでは、環境でnpxが利用可能なNode.jsが必要です。

[!TIP] すべてのスキルをインストールしないでください。 インストールされた各スキルは、エージェントがすべてのリクエストで評価するルーティングコンテキストを追加します。まずクラウドおよびelasticsearch認証スキル（ほとんどの他のスキルはこれらに依存）をインストールし、次にワークフローに関連するスキルのみを追加してください。インストールセットを絞ることでコンテキストの肥大化を避け、エージェントが適切なスキルに確実にルーティングできるようになります。

Claude Codeプラグイン（Claude Codeユーザーにおすすめ）

Claude Codeにはスキルを直接管理するネイティブプラグインシステムがあります。まずはこのリポジトリをマーケットプレイスソースとして追加します:```sh claude plugin marketplace add https://github.com/elastic/agent-skills

追加後、個々のプラグインを名前でインストールします：```sh
claude plugin install elasticsearch@elastic-agent-skills
claude plugin install kibana@elastic-agent-skills
claude plugin install observability@elastic-agent-skills
claude plugin install security@elastic-agent-skills
claude plugin install cloud@elastic-agent-skills

[!NOTE] インストール後、/reload-plugins を実行してもスキルがすぐに表示されない場合があります。これは既知のClaude Codeの問題です — 新しくインストールしたプラグインを認識させるには、Claude Codeセッションを再起動してください。

または、任意のClaude Codeセッション内でインタラクティブプラグインブラウザを使用してください：``` /plugins

これにより、設定済みのすべてのマーケットプレイスから利用可能なプラグインを参照し、インストールするものを選択し、既にインストールされているものを管理するメニューが開きます。

### GitHub Copilot CLI

GitHub Copilot CLI にはネイティブのプラグインシステムがあります。このリポジトリをマーケットプレイスソースとして追加してください：```sh
copilot plugin marketplace add elastic/agent-skills

追加後、プラグインを名前で個別にインストールします:```sh copilot plugin install elasticsearch@elastic-agent-skills copilot plugin install kibana@elastic-agent-skills copilot plugin install observability@elastic-agent-skills copilot plugin install security@elastic-agent-skills copilot plugin install cloud@elastic-agent-skills

または、Copilotセッション内で利用可能なプラグインを対話的に閲覧できます：```
/plugin list

npx (Recommended)

スキルをインストールする最も速い方法は、skills CLIを使用することです。このリポジトリをクローンする必要はありません — 以下のコマンドを実行するだけです:```sh npx skills add elastic/agent-skills

これにより、スキルと[ターゲットエージェント](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)を選択する対話型プロンプトが起動します。CLIは各スキルフォルダをエージェントが発見できる正しい場所にコピーします。

特定のスキルを名前でインストールする:```sh
npx skills add elastic/agent-skills --skill elasticsearch-esql

または、@ の省略形を使ってスキルを repo@skill と直接指定することもできます（--skill と同等）:```sh npx skills add elastic/agent-skills@elasticsearch-esql

特定のエージェントにインストール（[対応エージェント](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)を参照）：```sh
npx skills add elastic/agent-skills -a cursor -a claude-code

インストールせずに利用可能なスキルを一覧表示：```sh npx skills add elastic/agent-skills --list

すべてのエージェントにすべてのスキルをインストールします（非対話型）:```sh
npx skills add elastic/agent-skills --all

ローカルクローン

ローカルチェックアウトから作業する場合、または環境にNode.js / npxがない場合は、リポジトリをクローンして、バンドルされたbashインストーラを使用してください。```sh git clone https://github.com/elastic/agent-skills.git cd agent-skills ./scripts/install-skills.sh add -a

このスクリプトは bash 3.2+ および標準の Unix ユーティリティ（`awk`、`find`、`cp`、`rm`、`mkdir`）を必要とします。

| Flag              | Description                           |
| ----------------- | ------------------------------------- |
| `-a, --agent`     | 対象エージェント（繰り返し指定可能）             |
| `-s, --skill`     | 特定のスキルを名前でインストール       |
| `-f, --force`     | 既存のインストール済みスキルを上書き    |
| `-y, --yes`       | 確認プロンプトをスキップ             |

利用可能な全スキルを表示：```sh
./scripts/install-skills.sh list

対応エージェント

スキルの更新

更新プロセスはスキルのインストール方法によって異なります。

Claude Code プラグイン

インストールされているすべてのプラグインを最新バージョンに更新します:```sh claude plugin update

特定のプラグインを更新する:```sh
claude plugin update elastic-elasticsearch

プラグインを自動的に最新の状態に保つには、Claude Code内で/pluginsを使用して自動更新を有効にします。

自動更新が有効な場合、Claude Codeは起動時に新しいプラグインバージョンを確認し、バックグラウンドで更新します。

GitHub Copilot CLI

インストールされているすべてのプラグインを最新バージョンに更新します：```sh copilot plugin update

特定のプラグインを更新する:```sh
copilot plugin update elasticsearch

npx

インストール済みのスキルが上流で変更されていないか確認します：```sh npx skills check

インストールされている全スキルの最新バージョンをプルします:```sh
npx skills update

CLIは各スキルのソースリポジトリとコンテンツハッシュをロックファイルに記録します。checkはローカルのハッシュをGitHubと比較し、updateは変更があったものを再ダウンロードします。

ヒント: デフォルトのnpxインストールではシンボリックリンクが使用されるため、すべてのエージェントは単一の正規コピーを指します。一度更新すると、すべてのエージェントが同時に更新されます。

ローカルクローン

--force を指定してインストーラを再実行すると、既存のスキルを上書きします。```sh git pull ./scripts/install-skills.sh add -a --force

`--force` なしの場合、スクリプトは既にインストールされているスキルをスキップします。

## スキルフォーマット

各スキルフォルダには、YAMLフロントマターとマークダウン指示を含む `SKILL.md` が含まれています:```yaml
---
name: elasticsearch-my-skill
description: >
  What the skill does AND when an agent should activate it.
metadata:
  version: 0.1.0
  visibility: public
---

# My Skill

[Instructions that the agent follows when this skill is active]

The description field is the sole trigger mechanism — agent runtimes read it to decide when to load a skill. For the full format specification, see agentskills.io/specification.

Issues

Found a problem or have a suggestion? Open an issue and we will review it.

Disclaimer

These skills are provided as-is. Always test skills thoroughly in your own environment before relying on them for critical tasks.