Elastic Agent Skills

Elastic Agent Skills — creati dalle persone che hanno creato Elastic — portano l'esperienza nativa della piattaforma direttamente al tuo agente di codifica AI. Questa è la libreria ufficiale di Agent Skills, compatibile con IDE agentici come Cursor, GitHub Copilot, Windsurf, Gemini CLI e altri. Le skill seguono lo standard aperto Agent Skills.

[!NOTE] Anteprima tecnica

Queste skill sono in rilascio anticipato e in fase di sviluppo attivo. Ci si aspettano modifiche man mano che le skill vengono codificate con valutazioni robuste e con l'evoluzione del panorama dei modelli. Controlla spesso per aggiornamenti.

Informazioni

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

Cosa sono le skill?

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

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

Ambito

Le skill 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

Skill disponibili

Considerazioni sulla sicurezza

Gli agenti di codifica AI 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.

• Esegui 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. La guida congiunta di CISA sulla distribuzione sicura dei sistemi AI è un buon punto di partenza.
• Sii consapevole di quali dati passano 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 può essere inviato a un'API di terze parti. Coinvolgi i tuoi team di sicurezza informatica e conformità fin dall'inizio.
• Questi agenti elaborano input controllati dagli attaccanti. Avvisi, campi di evento e contenuti di file contengono regolarmente stringhe create dagli attaccanti. L'iniezione di prompt non è teorica qui; è una proprietà intrinseca dell'ambiente operativo. Ricerche come Brainworm dimostrano che i soli file di contesto dell'agente possono servire come meccanismo di persistenza per il promptware.
• Limita strettamente i privilegi. Dai alle chiavi API i privilegi minimi richiesti. I privilegi di risposta ampi sono particolarmente pericolosi. L'accesso in sola lettura è una buona impostazione predefinita finché non hai validato il comportamento.
• Limita l'accesso agli strumenti dell'agente e la portata di rete. La maggior parte degli agenti di codifica AI viene fornita con impostazioni predefinite ampie: esecuzione della shell, scritture sul file system, 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 skill prima di collegarle a qualsiasi cosa che trasporti dati di sicurezza live.

Queste skill sono open source proprio perché tu possa controllare cosa fanno. Ti incoraggiamo a leggerle prima di eseguirle.

Per iniziare

Puoi installare le skill Elastic utilizzando 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 a ogni richiesta. Installa le skill di autenticazione cloud ed elasticsearch — la maggior parte delle altre skill dipende da esse — poi aggiungi solo le skill rilevanti per il tuo flusso di lavoro. Mantenere l'insieme installato focalizzato evita il gonfiore del contesto e aiuta l'agente a instradare in modo affidabile verso la skill giusta.

Plugin Claude Code (consigliato per gli utenti Claude Code)

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

Una volta aggiunto, installa i singoli plugin per nome:```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 comparire immediatamente quando si esegue /reload-plugins. Questo è un problema noto di Claude Code: riavvia la sessione di Claude Code per rilevare i plugin appena installati.

Oppure usa il browser interattivo dei plugin all'interno di 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 sorgente del marketplace:```sh
copilot plugin marketplace add elastic/agent-skills

Una volta aggiunto, 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 Copilot:```
/plugin list

npx (Consigliato)

Il modo più rapido per installare le skills è con la CLI skills. Non è necessario clonare questo repository: basta eseguire:```sh npx skills add elastic/agent-skills

Questo 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 di skill nella posizione corretta affinché l'agente possa rilevarla.

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

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

Installazione 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

Elenco delle skill disponibili senza installarle:```sh npx skills add elastic/agent-skills --list

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

Clone locale

Se preferisci lavorare da una copia locale, o il tuo ambiente non dispone di 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 utilità Unix standard (`awk`, `find`, `cp`, `rm`, `mkdir`).

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

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

Agenti supportati

Aggiornamento delle skills

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

Plugin Claude Code

Aggiorna tutti i plugin installati alle loro versioni più recenti:```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 controlla le nuove versioni dei plugin all'avvio e li aggiorna in background.

GitHub Copilot CLI

Aggiorna tutti i plugin installati alle loro versioni più recenti:```sh copilot plugin update

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

npx

Verifica se una qualsiasi delle competenze installate è cambiata a monte:```sh npx skills check

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

Il CLI tiene traccia del repository sorgente di ogni skill e di un hash del contenuto in un file di lock. check confronta gli hash locali con quelli su GitHub; update riscarica qualsiasi cosa sia cambiata.

Suggerimento: L'installazione predefinita tramite npx utilizza symlink, quindi ogni agente punta a un'unica copia canonica. Un singolo aggiornamento aggiorna tutti gli agenti contemporaneamente.

Clone locale

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

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

## Formato delle skill

Ogni cartella di skill contiene un file `SKILL.md` con frontmatter YAML e istruzioni in 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 agenti lo leggono per decidere quando caricare una skill. Per la specifica completa del formato, consulta agentskills.io/specification.

Problemi

Hai trovato un problema o hai un suggerimento? Apri una segnalazione e la esamineremo.

Disclaimer

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