Elastic Agent Skills

Elastic Agent Skills – entwickelt von den Machern von Elastic – liefern native Plattformexpertise direkt an Ihren KI-Codierungsagenten. Dies ist die offizielle Agent Skill-Bibliothek, kompatibel mit agentischen IDEs wie Cursor, GitHub Copilot, Windsurf, Gemini CLI und mehr. Skills folgen dem offenen Standard Agent Skills.

[!NOTE] Technische Vorschau

Diese Skills befinden sich in einer frühen Veröffentlichungsphase und werden aktiv weiterentwickelt. Es sind Änderungen zu erwarten, da Skills mit robusten Evaluierungen kodifiziert werden und sich die Modelllandschaft weiterentwickelt. Bitte schauen Sie regelmäßig nach Aktualisierungen.

Über dieses Repository

Dieses Repository enthält kuratierte Skills – Pakete aus Anweisungen, Kontext und Werkzeugen – die jedem KI-Agenten beibringen, wie er korrekt mit Elasticsearch, Kibana, Elastic Observability und Elastic Security arbeitet. Fügen Sie sie in die von Ihnen bereits verwendete Agentenlaufzeit ein, und Ihr Assistent hört auf, veraltete Muster zu verwenden, und macht es richtig.

Was sind Skills?

Skills sind eigenständige Pakete, die KI-Agenten das Wissen und die Werkzeuge geben, um bestimmte Aufgaben auf wiederholbare Weise zu erledigen. Jeder Skill lebt in einem eigenen Ordner mit einer SKILL.md-Datei, die Metadaten und Anweisungen enthält, die der Agent befolgt.

Weitere Hintergrundinformationen zum Agent Skills-Standard finden Sie unter agentskills.io.

Umfang

Die Skills in diesem Repository konzentrieren sich auf:

• Interaktion mit Elasticsearch-APIs (Suche, Indizierung, Clusterverwaltung)
• Erstellung und Verwaltung von Kibana-Inhalten wie Alarme, Konnektoren und mehr
• Muster für Elastic Observability, Elastic Security und Agent Builder

Verfügbare Skills

Sicherheitsüberlegungen

KI-Codierungsagenten arbeiten mit echten Anmeldeinformationen, echtem Shell-Zugriff und oft mit den vollständigen Berechtigungen des Benutzers, der sie ausführt. Wenn diese Agenten auf Sicherheits-Workflows ausgerichtet sind, sind die Risiken höher. Das rechtfertigt ein offenes Gespräch über Risiken, bevor Sie beginnen.

• Führen Sie Ihr eigenes Bedrohungsmodell durch. Bewerten Sie, auf welche Daten der Agent zugreifen kann, welche Aktionen er ausführen kann und was passiert, wenn er sich unerwartet verhält. Die gemeinsame Anleitung der CISA zur sicheren Bereitstellung von KI-Systemen ist ein guter Ausgangspunkt.
• Achten Sie darauf, welche Daten durch den Agenten fließen. Sicherheitsdaten können PII, in Befehlszeilen eingebettete Anmeldeinformationen und andere regulierte Daten enthalten. Wenn ein Agent Alarme oder Prozessereignisse abfragt, gelangen diese Inhalte in den Kontext des Modells und können an eine Drittanbieter-API gesendet werden. Beziehen Sie Ihre Informationssicherheits- und Compliance-Teams frühzeitig ein.
• Diese Agenten verarbeiten von Angreifern kontrollierte Eingaben. Alarme, Ereignisfelder und Dateiinhalte enthalten regelmäßig Zeichenfolgen, die von Angreifern erstellt wurden. Prompt Injection ist hier keine Theorie; es ist eine inhärente Eigenschaft der Betriebsumgebung. Forschung wie Brainworm zeigt, dass allein Agent-Kontextdateien als Persistenzmechanismus für Promptware dienen können.
• Berechtigungen eng fassen. Geben Sie API-Schlüsseln die minimal erforderlichen Berechtigungen. Weite Antwortberechtigungen sind besonders gefährlich. Schreibgeschützter Zugriff ist eine gute Voreinstellung, bis Sie das Verhalten validiert haben.
• Beschränken Sie den Zugriff auf Agent-Tools und Netzwerkreichweite. Die meisten KI-Codierungsagenten werden mit breiten Standardeinstellungen ausgeliefert: Shell-Ausführung, Dateisystem-Schreibzugriff, Internetzugriff. Die Reduzierung der verfügbaren Werkzeugoberfläche begrenzt, was ein kompromittierter oder fehlgeleiteter Agent tun kann.
• Beginnen Sie in Nicht-Produktionsumgebungen. Verwenden Sie ein Serverless-Testprojekt, einen Dev-Cluster oder einen isolierten Kibana-Space, um Skills zu evaluieren, bevor Sie sie mit etwas verbinden, das Live-Sicherheitsdaten enthält.

Diese Skills sind genau deshalb Open Source, damit Sie prüfen können, was sie tun. Wir ermutigen Sie, sie zu lesen, bevor Sie sie ausführen.

Erste Schritte

Sie können Elastic Skills mit dem nativen Plugin-System von Claude Code, der skills-CLI mit npx oder durch Klonen dieses Repositories und Ausführen des gebündelten Installationsskripts installieren. Die npx-Methode erfordert Node.js mit npx, das in Ihrer Umgebung verfügbar ist.

[!TIP] Installieren Sie nicht jeden Skill. Jeder installierte Skill fügt Routing-Kontext hinzu, den Ihr Agent bei jeder Anfrage auswertet. Installieren Sie die Authentifizierungs-Skills cloud und elasticsearch – die meisten anderen Skills hängen von ihnen ab – und fügen Sie dann nur die Skills hinzu, die für Ihren Workflow relevant sind. Wenn Sie den installierten Satz fokussiert halten, vermeiden Sie Kontextaufblähung und helfen dem Agenten, zuverlässig zum richtigen Skill zu routen.

Claude Code-Plugin (empfohlen für Claude Code-Benutzer)

Claude Code verfügt über ein natives Plugin-System, das Skills direkt verwaltet. Beginnen Sie, indem Sie dieses Repository als Marktplatzquelle hinzufügen:```sh claude plugin marketplace add https://github.com/elastic/agent-skills

Sobald hinzugefügt, installiere einzelne Plugins nach Namen:```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] Nach der Installation erscheinen Fähigkeiten möglicherweise nicht sofort beim Ausführen von /reload-plugins. Dies ist ein bekanntes Claude Code-Problem — starten Sie Ihre Claude Code-Sitzung neu, um neu installierte Plugins zu übernehmen.

Oder verwenden Sie den interaktiven Plugin-Browser in einer beliebigen Claude Code-Sitzung:``` /plugins

Dadurch öffnet sich ein Menü, um verfügbare Plugins aus allen konfigurierten Marktplätzen zu durchsuchen, auszuwählen, was installiert werden soll, und zu verwalten, was bereits installiert ist.

### GitHub Copilot CLI

GitHub Copilot CLI verfügt über ein natives Plugin-System. Fügen Sie dieses Repository als Marktplatz-Quelle hinzu:```sh
copilot plugin marketplace add elastic/agent-skills

Sobald hinzugefügt, installieren Sie einzelne Plugins namentlich:```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

Oder durchsuchen Sie verfügbare Plugins interaktiv in einer Copilot-Sitzung:```
/plugin list

npx (Empfohlen)

Der schnellste Weg, Skills zu installieren, ist mit dem skills CLI. Kein Grund, dieses Repository zu klonen — führen Sie einfach aus:```sh npx skills add elastic/agent-skills

Dies startet eine interaktive Eingabeaufforderung, um Fähigkeiten und [Zielagenten](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents) auszuwählen. Die CLI kopiert jeden Skill-Ordner an den richtigen Ort, damit der Agent sie finden kann.

Installieren Sie einen bestimmten Skill mit Namen:```sh
npx skills add elastic/agent-skills --skill elasticsearch-esql

Oder verwenden Sie die @-Kurzform, um die Fähigkeit direkt als repo@skill anzugeben (entspricht --skill):```sh npx skills add elastic/agent-skills@elasticsearch-esql

Installieren auf bestimmte Agenten (siehe [supported agents](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)):```sh
npx skills add elastic/agent-skills -a cursor -a claude-code

Verfügbare Fähigkeiten ohne Installation auflisten:```sh npx skills add elastic/agent-skills --list

Alle Skills auf allen Agenten installieren (nicht interaktiv):```sh
npx skills add elastic/agent-skills --all

Lokales Klonen

Wenn Sie lieber mit einem lokalen Checkout arbeiten oder Ihre Umgebung kein Node.js / npx hat, klonen Sie das Repository und verwenden Sie den gebündelten Bash-Installer:```sh git clone https://github.com/elastic/agent-skills.git cd agent-skills ./scripts/install-skills.sh add -a

Das Skript benötigt bash 3.2+ und standardmäßige Unix-Dienstprogramme (`awk`, `find`, `cp`, `rm`, `mkdir`).

| Flagge            | Beschreibung                              |
| ----------------- | ----------------------------------------- |
| `-a, --agent`     | Ziel-Agent (wiederholbar)                 |
| `-s, --skill`     | Bestimmte Fähigkeiten nach Namen installieren |
| `-f, --force`     | Bereits installierte Fähigkeiten überschreiben |
| `-y, --yes`       | Bestätigungsaufforderungen überspringen   |

Alle verfügbaren Fähigkeiten auflisten:```sh
./scripts/install-skills.sh list

Unterstützte Agenten

Aktualisieren von Skills

Der Aktualisierungsprozess hängt davon ab, wie die Skills installiert wurden.

Claude Code Plugin

Aktualisieren Sie alle installierten Plugins auf die neuesten Versionen:```sh claude plugin update

Ein bestimmtes Plugin aktualisieren:```sh
claude plugin update elastic-elasticsearch

Um Plugins automatisch auf dem neuesten Stand zu halten, aktivieren Sie die automatische Aktualisierung mit /plugins in Claude Code.

Wenn die automatische Aktualisierung aktiviert ist, überprüft Claude Code beim Start auf neue Plugin-Versionen und aktualisiert sie im Hintergrund.

GitHub Copilot CLI

Aktualisieren Sie alle installierten Plugins auf die neuesten Versionen:```sh copilot plugin update

Aktualisieren eines bestimmten Plugins:```sh
copilot plugin update elasticsearch

npx

Überprüfen, ob sich installierte Skills upstream geändert haben.```sh npx skills check

Holen Sie die neuesten Versionen aller installierten Skills:```sh
npx skills update

Die CLI verfolgt das Quell-Repository und einen Content-Hash jedes Skills in einer Lock-Datei. check vergleicht Ihre lokalen Hashes mit denen auf GitHub; update lädt alles neu herunter, was abgewichen ist.

Tipp: Die standardmäßige npx-Installation verwendet Symlinks, sodass jeder Agent auf eine einzige kanonische Kopie verweist. Einmaliges Aktualisieren aktualisiert alle Agenten gleichzeitig.

Lokaler Klon

Führen Sie den Installer mit --force erneut aus, um vorhandene Skills zu überschreiben:```sh git pull ./scripts/install-skills.sh add -a --force

Ohne `--force` überspringt das Skript bereits installierte Skills.

## Skill-Format

Jeder Skill-Ordner enthält eine `SKILL.md` mit YAML-Frontmatter und Markdown-Anweisungen:```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]

Das description-Feld ist der alleinige Auslösemechanismus – Agent-Runtimes lesen es, um zu entscheiden, wann eine Fähigkeit geladen werden soll. Die vollständige Formatspezifikation finden Sie unter agentskills.io/specification.

Probleme

Haben Sie ein Problem gefunden oder einen Vorschlag? Eröffnen Sie ein Issue und wir werden es prüfen.

Haftungsausschluss

Diese Fähigkeiten werden wie besehen bereitgestellt. Testen Sie Fähigkeiten stets gründlich in Ihrer eigenen Umgebung, bevor Sie sich für kritische Aufgaben darauf verlassen.