Elastic Agent Skills

Elastic Agent Skills — realizzate da chi ha creato Elastic — portano l'esperienza diretta della piattaforma direttamente al tuo agente AI di codifica. Questa è la libreria ufficiale delle Skills per agenti, compatibile con IDE agentici come Cursor, GitHub Copilot, Windsurf, Gemini CLI e altri. Le Skills seguono lo standard aperto Agent Skills.

[!NOTE] Anteprima tecnica

Queste skills sono in fase di rilascio iniziale e in sviluppo attivo. Ci si aspettano cambiamenti man mano che le skills vengono codificate con valutazioni solide e che il panorama dei modelli si evolve. Controlla spesso per aggiornamenti.

Informazioni

Questo repository contiene skills curate, ovvero pacchetti di istruzioni, contesto e strumenti che insegnano a qualsiasi agente AI come lavorare correttamente con Elasticsearch, Kibana, Elastic Observability e Elastic Security. Inseriscile nel runtime dell'agente che già usi e il tuo assistente smetterà di usare pattern obsoleti e inizierà a fare le cose nel modo giusto.

Cosa sono le skills?

Le skills sono pacchetti autonomi che forniscono agli agenti AI le conoscenze e gli strumenti per completare attività specifiche in modo ripetibile. Ogni skill risiede nella propria cartella con un file SKILL.md contenente metadati e istruzioni che l'agente segue.

Per maggiori informazioni sullo standard Agent Skills, consulta agentskills.io.

Ambito

Le skills in questo repository si concentrano su:

• Interazione con le API di Elasticsearch (ricerca, indicizzazione, gestione del cluster)
• Creazione e gestione di contenuti Kibana come avvisi, connettori e altro
• Pattern per Elastic Observability, Elastic Security e Agent Builder

Skills disponibili

Considerazioni sulla sicurezza

Gli agenti AI di codifica operano con credenziali reali, accesso reale alla shell e spesso con tutti i permessi dell'utente che li esegue. Quando questi agenti vengono puntati su flussi di lavoro di sicurezza, la posta in gioco è più alta. Questo merita una conversazione franca sul rischio prima di iniziare.

• Conduci la tua modellazione delle minacce. Valuta a quali dati l'agente può accedere, quali azioni può intraprendere e cosa succede se si comporta in modo inaspettato. Le linee guida congiunte della CISA sulla distribuzione sicura di sistemi AI sono un buon punto di partenza.
• Sii consapevole di quali dati fluiscono attraverso l'agente. I dati di sicurezza possono contenere PII, credenziali incorporate nelle righe di comando e altri dati regolamentati. Quando un agente interroga avvisi o eventi di processo, quel contenuto entra nel contesto del modello e potrebbe essere inviato a un'API di terze parti. Coinvolgi tempestivamente i tuoi team di infosec e conformità.
• Questi agenti elaborano input controllati da attaccanti. Gli avvisi, i campi degli eventi e i contenuti dei file contengono regolarmente stringhe create da attaccanti. L'iniezione di prompt non è teorica qui; è una proprietà intrinseca dell'ambiente operativo. Ricerche come Brainworm dimostrano che i file di contesto dell'agente da soli possono fungere da meccanismo di persistenza per il promptware.
• Limita strettamente i privilegi. Assegna alle chiavi API i privilegi minimi richiesti. I privilegi di risposta ampi sono particolarmente pericolosi. L'accesso in sola lettura è un buon default fino a quando non hai convalidato il comportamento.
• Limita l'accesso agli strumenti dell'agente e la raggiungibilità di rete. La maggior parte degli agenti AI di codifica viene fornita con impostazioni predefinite ampie: esecuzione della shell, scrittura sul filesystem, accesso a Internet. Ridurre la superficie degli strumenti disponibili limita ciò che un agente compromesso o fuorviato può fare.
• Inizia in ambienti non di produzione. Usa un progetto di prova Serverless, un cluster di sviluppo o uno spazio Kibana isolato per valutare le skills prima di collegarle a qualsiasi cosa che trasporti dati di sicurezza reali.

Queste skills sono open source proprio per permetterti di verificare cosa fanno. Ti incoraggiamo a leggerle prima di eseguirle.

Per iniziare

Puoi installare le skills Elastic usando il sistema di plugin nativo di Claude Code, la CLI skills con npx, o clonando questo repository ed eseguendo lo script di installazione incluso. Il metodo npx richiede Node.js con npx disponibile nel tuo ambiente.

[!TIP] Non installare ogni skill. Ogni skill installata aggiunge contesto di routing che il tuo agente valuta ad ogni richiesta. Installa le skill di autenticazione cloud ed elasticsearch — la maggior parte delle altre skill dipende da esse — poi aggiungi solo le skill pertinenti al tuo flusso di lavoro. Mantenere il set installato focalizzato evita il gonfiamento del contesto e aiuta l'agente a instradare correttamente verso la skill giusta.

Plugin Claude Code (Consigliato per utenti Claude Code)

Claude Code ha un sistema di plugin nativo che gestisce le skills direttamente. Inizia aggiungendo questo repository come sorgente del marketplace:```sh claude plugin marketplace add https://github.com/elastic/agent-skills

Once added, install individual plugins by name:```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] Dopo l'installazione, le skill potrebbero non apparire immediatamente quando si esegue /reload-plugins. Questo è un problema noto di Claude Code — riavvia la sessione di Claude Code per caricare i nuovi plugin installati.

Oppure usa il browser interattivo dei plugin in qualsiasi sessione di Claude Code:``` /plugins

Questo apre un menu per sfogliare i plugin disponibili da tutti i marketplace configurati, selezionare cosa installare e gestire ciò che è già installato.

### GitHub Copilot CLI

GitHub Copilot CLI ha un sistema di plugin nativo. Aggiungi questo repository come fonte di marketplace:```sh
copilot plugin marketplace add elastic/agent-skills

Una volta aggiunti, installa i singoli plugin per nome:```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

Oppure sfoglia i plugin disponibili in modo interattivo all'interno di una sessione di Copilot:```
/plugin list

npx (Consigliato)

Il modo più veloce per installare le skill è con la CLI skills. Non c'è bisogno di clonare questo repository — basta eseguire:```sh npx skills add elastic/agent-skills

Ciò avvia un prompt interattivo per selezionare le skill e gli [agenti target](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents). La CLI copia ogni cartella delle skill nella posizione corretta per essere scoperta dall'agente.

Installa una skill specifica per nome:```sh
npx skills add elastic/agent-skills --skill elasticsearch-esql

Oppure usa l'abbreviazione @ per specificare direttamente la skill come repo@skill (equivalente a --skill):```sh npx skills add elastic/agent-skills@elasticsearch-esql

Installa su agenti specifici (vedi [agenti supportati](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)):```sh
npx skills add elastic/agent-skills -a cursor -a claude-code

Elenca le competenze disponibili senza installare:```sh npx skills add elastic/agent-skills --list

Installa tutte le skill a tutti gli agenti (non interattivo):```sh
npx skills add elastic/agent-skills --all

Clone locale

Se preferisci lavorare da un checkout locale, o se il tuo ambiente non ha Node.js / npx, clona il repository e usa l'installer bash incluso:```sh git clone https://github.com/elastic/agent-skills.git cd agent-skills ./scripts/install-skills.sh add -a

Lo script richiede bash 3.2+ e le utilità Unix standard (`awk`, `find`, `cp`, `rm`, `mkdir`).

| Flag              | Descrizione                           |
| ----------------- | ------------------------------------- |
| `-a, --agent`     | Agente target (ripetibile)            |
| `-s, --skill`     | Installa abilità specifiche per nome  |
| `-f, --force`     | Sovrascrivi abilità già installate    |
| `-y, --yes`       | Salta le richieste di conferma        |

Elenca tutte le abilità disponibili:```sh
./scripts/install-skills.sh list

Agenti supportati

Aggiornamento delle skill

Il processo di aggiornamento dipende da come le skill sono state installate.

Plugin Claude Code

Aggiorna tutti i plugin installati alle loro ultime versioni:```sh claude plugin update

Aggiorna un plugin specifico:```sh
claude plugin update elastic-elasticsearch

Per mantenere i plugin aggiornati automaticamente, abilita l'aggiornamento automatico usando /plugins all'interno di Claude Code.

Quando l'aggiornamento automatico è attivo, Claude Code verifica la presenza di nuove versioni dei plugin all'avvio e li aggiorna in background.

GitHub Copilot CLI

Aggiorna tutti i plugin installati alle loro ultime versioni:```sh copilot plugin update

Aggiorna un plugin specifico:```sh
copilot plugin update elasticsearch

npx

Verifica se le competenze installate sono cambiate nella sorgente upstream:```sh npx skills check

Estrai le ultime versioni di tutte le skill installate:```sh
npx skills update

Il CLI traccia il repository sorgente di ogni competenza e un hash del contenuto in un file lock. check confronta i tuoi hash locali con GitHub; update scarica di nuovo tutto ciò che è cambiato.

Suggerimento: L'installazione predefinita con npx utilizza collegamenti simbolici, quindi ogni agente punta a una singola copia canonica. L'aggiornamento una volta sola aggiorna tutti gli agenti contemporaneamente.

Clonazione locale

Esegui di nuovo l'installer con --force per sovrascrivere le competenze esistenti:```sh git pull ./scripts/install-skills.sh add -a --force

Senza `--force` lo script salta le skill già installate.

## Formato skill

Ogni cartella di skill contiene un file `SKILL.md` con frontmatter YAML e istruzioni markdown:```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]

Il campo description è l'unico meccanismo di attivazione — i runtime degli agent lo leggono per decidere quando caricare una skill. Per la specifica completa del formato, vedi agentskills.io/specification.

Problemi

Hai trovato un problema o hai un suggerimento? Apri un issue e lo esamineremo.

Avvertenza

Queste skill sono fornite così come sono. Testa sempre le skill accuratamente nel tuo ambiente prima di farvi affidamento per attività critiche.