
Competenze Elastic Ufficiali
<p align="center"> <img alt="Elastic logo" src="https://assets.kitploit.com/production/public/readmes/12587/8e357b6e4cbecb13a462cd8da398525dbe599bb7210c6426f2f1103702561816.png" width="200"> </p> <p align="center"> <a href="https://github.com/elastic/agent-skills/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/badge/license-Apache%202.0-blue"></a> </p> # Elastic Agent Skills Elastic Agent Skills — creati da chi ha costruito Elastic — forniscono competenze native sulla piattaforma direttamente al tuo agente di coding 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](https://agentskills.io/). > [!NOTE] > **Anteprima tecnica** > > Queste skill sono in fase di rilascio iniziale e in sviluppo attivo. Aspettati cambiamenti man mano che le skill vengono codificate con valutazioni > solide e man mano che il panorama dei modelli si evolve. Torna spesso a controllare gli aggiornamenti. ## Informazioni Questo repository contiene skill curate, ovvero 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 nel modo giusto. ## 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 risiede in una 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](http://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 <!-- BEGIN-SKILL-TABLE --> ## Skill disponibili <details> <summary>Cloud (2)</summary> | Skill | Descrizione | Versione | Autore | | ----- | ----------- | ------- | ------ | | [cloud-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/cloud/onboarding/SKILL.md) | Esegui l'onboarding di un'organizzazione Elastic Cloud: configura il contesto Cloud e la chiave API della CLI `elastic`, stabilisci una regione predefinita, quindi invita utenti, assegna ruoli predefiniti o personalizzati per i progetti Serverless e crea o revoca chiavi API Cloud. Usala quando configuri l'autenticazione Cloud o quando concedi, modifichi o verifichi l'accesso degli utenti a un'organizzazione e ai suoi progetti. | 0.3.0 | elastic | | [cloud-provisioning](https://github.com/elastic/agent-skills/blob/main/skills/cloud/provisioning/SKILL.md) | Esegui il provisioning e la gestione dell'infrastruttura Elastic Cloud: crea, connettiti, aggiorna ed elimina progetti Serverless (Elasticsearch, Observability, Security); gestisci i filtri di traffico (sicurezza di rete IP e AWS PrivateLink); e gestisci il ciclo di vita dei deployment Elastic Cloud Hosted. Usala quando crei o esegui operazioni di day-2 su progetti serverless o deployment hosted, o quando ne limiti l'accesso di rete. | 0.3.0 | elastic | </details> <details> <summary>Elasticsearch (10)</summary> | Skill | Descrizione | Versione | Autore | | ----- | ----------- | ------- | ------ | | [elasticsearch-anomaly-detection](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-anomaly-detection/SKILL.md) | Crea e gestisci job di rilevamento anomalie ML di Elastic tramite l'API. Da usare quando si configurano job su un indice o un data stream, si configurano job e datafeed, oppure li si apre, avvia o arresta. | 1.1.0 | elastic | | [elasticsearch-anomaly-detection-explainer](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-anomaly-detection-explainer/SKILL.md) | Spiega i punteggi di rilevamento anomalie ML di Elasticsearch, il comportamento del modello e l'interpretazione dei risultati. Da usare quando l'utente chiede perché un punteggio è alto o basso, come apprende il modello, cosa significano i numeri o come risolvere punteggi di anomalia inattesi. | 0.3.0 | elastic | | [elasticsearch-cluster-health](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-cluster-health/SKILL.md) | Diagnostica un cluster Elasticsearch non verde ed evidenzia la singola causa più probabile con la relativa soluzione. Da usare quando un operatore segnala uno stato giallo o rosso, shard non assegnati, errori di allocazione, oppure desidera un triage in sola lettura prima di un'indagine più approfondita. Insegna l'impatto replica-vs-primary, la classificazione degli allocation decider e la consapevolezza della perdita di dati. | 0.1.0 | elastic | | [elasticsearch-esql](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-esql/SKILL.md) | Esegui query ES\|QL (Elasticsearch Query Language), da usare quando l'utente vuole interrogare i dati di Elasticsearch, analizzare i log, aggregare metriche, esplorare i dati o creare grafici e dashboard dai risultati ES\|QL. | 0.10.0 | elastic | | [elasticsearch-index-design](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-index-design/SKILL.md) | Progetta e rivedi i mapping degli indici Elasticsearch per pattern di accesso dichiarati: tipi di campo corretti, multi-campi text+keyword, ottimizzazione di doc_values, prevenzione del mapping explosion e impostazioni esplicite degli shard. Da usare quando si crea un nuovo indice, si rivede un mapping per le prestazioni di archiviazione o query, si correggono tipi di campo errati, oppure quando l'utente chiede quale tipo usare per ricerca, filtro, ordinamento o aggregazione su un campo. | 0.1.0 | elastic | | [elasticsearch-ingest](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-ingest/SKILL.md) | Carica file CSV, JSON e NDJSON negli indici Elasticsearch usando la bulk API e mapping espliciti quando i tipi di campo sono importanti. Da usare quando si importano in batch file locali, si convertono righe CSV o array JSON nel formato bulk NDJSON, si conferma la connettività del cluster con elastic es info prima dell'ingest, oppure si verificano i conteggi dei documenti e i mapping dopo l'ingest — non per pipeline Logstash, Beats, script personalizzati o reindex da indice a indice. | 0.1.3 | elastic | | [elasticsearch-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-onboarding/SKILL.md) | Aiuta gli sviluppatori nuovi a Elasticsearch a passare da zero a un'esperienza di ricerca funzionante. Guidali nella comprensione delle loro intenzioni, nella mappatura dei loro dati e nella creazione di un'esperienza di ricerca con le best practice integrate. Usalo quando l'utente mostra l'intenzione di costruire funzionalità legate alla ricerca, chiede informazioni sui concetti di Elasticsearch per il proprio caso d'uso, oppure esprime la necessità di aiuto per iniziare con Elasticsearch. | 0.3.0 | elastic | | [elasticsearch-query-optimization](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-query-optimization/SKILL.md) | Diagnostica le ricerche lente con Elasticsearch Query DSL e proponi correzioni misurate. Da usare quando una ricerca è lenta, l'output del profiling mostra una clausola costosa, i filtri a corrispondenza esatta si trovano nel contesto di scoring, oppure i wildcard iniziali dominano la latenza. Basa ogni raccomandazione sul profiling della ricerca — sposta le clausole non di scoring nel contesto filter, elimina i wildcard iniziali ed esegui nuovamente il profiling per confermare il miglioramento. | 0.1.0 | elastic | | [elasticsearch-reindex](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-reindex/SKILL.md) | Guida il reindex di Elasticsearch per le prestazioni: locale e remoto, slicing, throttling, task API. Da usare quando si copiano o migrano indici, si modificano mapping o si trasforma durante il reindex. | 0.2.0 | elastic | | [elasticsearch-search-relevance](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-search-relevance/SKILL.md) | Migliora la rilevanza della ricerca in Elasticsearch per indici di contenuti e cataloghi: fissa o promuovi i risultati con le query rules (tipo di regola, criteri e collegamento regola-query corretti) e ottimizza il ranking organico con multi_match, field boosts e analisi basata sul mapping dell'indice. Usalo quando i risultati di ricerca hanno un ranking scadente, un documento specifico deve apparire per primo per una query, o l'utente chiede di ottimizzare la corrispondenza full-text — non per analisi ES\|QL, ingest dell'indice o stato del cluster. | 0.1.0 | elastic | </details> <details> <summary>Kibana (7)</summary> | Skill | Descrizione | Versione | Autore | | ----- | ----------- | -------- | ------ | | [kibana-agent-builder](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-agent-builder/SKILL.md) | Crea e gestisci agenti e strumenti personalizzati di Kibana Agent Builder. Da usare quando viene richiesto di creare, aggiornare, eliminare, testare o ispezionare agenti o strumenti in Agent Builder, oppure quando l'utente vuole capire quali agenti o strumenti esistono già. | 0.3.0 | elastic | | [kibana-alerting-rules](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-alerting-rules/SKILL.md) | Crea e gestisci le regole di alerting di Kibana. Da usare quando si creano, aggiornano o gestiscono i cicli di vita delle regole (abilitazione, disabilitazione, silenziamento, snooze), quando si scelgono i tipi di regola e i parametri per le soglie delle metriche, oppure per la ricerca/elencazione in sola lettura con filtri per tag. | 0.3.0 | elastic | | [kibana-anomaly-detection](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-anomaly-detection/SKILL.md) | Rilevamento delle anomalie ML di Elastic — indagine/RCA, spiegazione del punteggio, risoluzione dei problemi del ciclo di vita dei job e operazioni sui job. Da usare quando si risponde a domande come "cosa si è rotto?"/"quale entità?"/RCA, "perché il punteggio è alto/basso?"/rinormalizzazione, "il datafeed si è fermato"/"limite di memoria"/hard_limit, oppure quando si configurano job di rilevamento anomalie ML. Legge i risultati da `.ml-anomalies-*` e lo stato dei job dalle API REST ML. | 0.3.0 | elastic | | [kibana-cases](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-cases/SKILL.md) | Gestisci casi di indagine e incidenti in Elastic Security, Observability e Stack Management — crea, cerca, aggiorna e arricchisci i casi con commenti, alert, eventi e osservabili (IOC). Da usare quando si tracciano incidenti, si correlano alert a un caso, si aggiungono note di indagine, si aggiorna lo stato o la gravità, oppure si gestisce l'output del triage. | 0.2.0 | elastic | | [kibana-context-engine](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-context-engine/SKILL.md) | Interroga gli AI Indices di Elastic Context Engine e i Knowledge Indicators (KI) che memorizzano. Da usare quando viene richiesto di cercare, esplorare, contare o rispondere a domande da un indice di conoscenza AI Index / KI / Context Engine, e quando si scrive l'ES\|QL che lo interroga. | 0.2.1 | elastic | | [kibana-dashboards](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-dashboards/SKILL.md) | Crea e gestisci dashboard Kibana e visualizzazioni Lens. Da usare quando è necessario definire dashboard e visualizzazioni in modo dichiarativo, sottoporle a controllo di versione, automatizzarne il deployment oppure migliorare layout, sezioni, controlli o design dei grafici. | 0.4.0 | elastic | | [kibana-workflows](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-workflows/SKILL.md) | Crea, convalida, testa, esegui e ispeziona le definizioni YAML dei workflow Elastic. Da usare quando l'utente vuole trasformare il linguaggio naturale in un workflow Kibana, correggere il YAML di un workflow, comprendere trigger o step, oppure eseguire un rapido ciclo di test su un Kibana reale. | 0.5.0 | elastic | </details> <details> <summary>Observability (6)</summary> | Skill | Descrizione | Versione | Autore | | ----- | ----------- | ------- | ------ | | [observability-csp-investigation](https://github.com/elastic/agent-skills/blob/main/skills/observability/csp-investigation/SKILL.md) | Analizza i problemi dei servizi dei cloud provider (CSP) — oggi AWS (il ragionamento si applica a qualsiasi servizio AWS; schema e firme di errore sono più approfonditi per RDS, Lambda, SQS, ALB, EC2), e in futuro GCP e Azure — utilizzando le metriche cloud con schema OTel in Elastic. Da usare quando si diagnosticano problemi delle risorse cloud, sia attivati da avvisi sia ad hoc: pressione sulle connessioni/CPU/memoria del database, tassi di errore e throttling delle funzioni, backlog delle code e lag dei consumer, 5xx del load-balancer, saturazione delle istanze. Correla la risorsa in esame con la propria baseline, classifica la modalità di errore ed esclude condizioni co-occorrenti ma non correlate. | 0.2.0 | elastic | | [observability-k8s-investigation](https://github.com/elastic/agent-skills/blob/main/skills/observability/k8s-investigation/SKILL.md) | Analizza i problemi dei workload, dei nodi e del control-plane di Kubernetes utilizzando la telemetria OTel (EDOT). Da usare quando si diagnosticano errori dei pod (CrashLoopBackOff, OOMKilled, Error), pressione sui nodi, esaurimento delle risorse, errori di pull delle immagini, rifiuti in fase di admission, anomalie di autoscaling o quando si correla lo stato di K8s con i segnali applicativi. Solo percorso di ingest OTel — la forma legacy dell'integrazione ECS Kubernetes è fuori ambito. | 0.5.1 | elastic | | [observability-llm-obs](https://github.com/elastic/agent-skills/blob/main/skills/observability/llm-obs/SKILL.md) | Risponde a domande sul comportamento di LLM e applicazioni agentiche a partire da dati già acquisiti in Elastic: latenza e tasso di errore, utilizzo di token e costi, qualità delle risposte ed eventi dei guardrail, e orchestrazione della catena di chiamate agentiche. Da usare quando l'utente chiede di monitoraggio LLM, osservabilità GenAI, spesa in token o costi AI, latenza del modello, errori di prompt o guardrail, o di come è stata eseguita la catena di tool-call di un agente. | 0.3.1 | elastic | | [observability-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/observability/onboarding/SKILL.md) | Integra un'applicazione in Elastic Observability con la Elastic Distribution of OpenTelemetry (EDOT): instrada in base al linguaggio e al runtime, rileva e sostituisce un agente Elastic APM classico, applica la configurazione OTLP richiesta e poi verifica con ES\|QL che tracce, metriche e log arrivino effettivamente con il nome del servizio atteso. Da usare quando si aggiunge osservabilità a un servizio, si migra dall'agente Elastic APM classico o si esegue il debug del motivo per cui un servizio strumentato non compare in Elastic. | 0.3.0 | elastic | | [observability-service-reliability](https://github.com/elastic/agent-skills/blob/main/skills/observability/service-reliability/SKILL.md) | Progetta e gestisce gli obiettivi di affidabilità dei servizi in Elastic Observability: scegli un tipo di SLI e un obiettivo difendibile, seleziona una finestra temporale e un metodo di budgeting, crea e mantieni gli SLO tramite l'API Kibana, collega regole di avviso basate sul burn-rate e decidi quando un SLO è lo strumento sbagliato e sono invece corretti una regola di soglia, un job di anomalia o un monitor synthetics. Da usare quando si definiscono o si rivedono SLO ed error budget, si ottimizza l'alerting basato sul burn-rate, si riduce il rumore degli avvisi o si configura il monitoraggio della disponibilità per un endpoint rivolto all'utente. | 0.4.1 | elastic | | [observability-sre-triage](https://github.com/elastic/agent-skills/blob/main/skills/observability/sre-triage/SKILL.md) | Esegue il triage end-to-end di un servizio degradato o sospetto: legge lo stato degli SLO e il burn rate, controlla le regole di avviso attive e le anomalie ML, misura throughput, latenza e tasso di errore, valuta la salute delle dipendenze e la saturazione dell'infrastruttura, e filtra i log fino agli errori che lo spiegano. Da usare quando qualcuno chiede se un servizio è sano, perché è lento o genera errori, cosa contengono i suoi log, o quale attributo distingue le richieste che falliscono. Da usare anche quando qualcuno chiede la query alla base di uno di questi segnali — throughput, percentili di latenza, tasso di errore, salute delle dipendenze o volume dei log — su tracce, metriche o log APM/OTel. | 0.5.2 | elastic | </details> <details> <summary>Security (6)</summary> | Skill | Descrizione | Versione | Autore | | ----- | ----------- | ------- | ------ | | [security-alert-analysis](https://github.com/elastic/agent-skills/blob/main/skills/security/alert-analysis/SKILL.md) | Analizza uno specifico avviso di rilevamento di Elastic Security: raccogli il contesto, valuta il rischio dell'entità, classifica la minaccia, documenta i risultati e, facoltativamente, prendine atto. Utilizzalo durante il triage di un singolo avviso noto, per condurre un'indagine SOC o per il follow-up dopo che la skill security-alert-triage ha identificato un gruppo da analizzare. | 0.1.0 | elastic | | [security-alert-triage](https://github.com/elastic/agent-skills/blob/main/skills/security/alert-triage/SKILL.md) | Assegna priorità e classifica la coda degli avvisi di Elastic Security in base al rischio ponderato — punteggio di rischio di base, incremento per tattica MITRE, rischio dell'entità e criticità dell'asset — quindi raggruppa gli avvisi in gruppi di entità. Utilizzalo quando un analista chiede su cosa concentrarsi, quali avvisi sono più urgenti o desidera un punto di partenza classificato sull'intera coda prima di iniziare un'indagine più approfondita. | 0.2.0 | elastic | | [security-case-management](https://github.com/elastic/agent-skills/blob/main/skills/security/case-management/SKILL.md) | Crea, cerca, aggiorna e gestisci i casi SOC tramite l'API Kibana Cases. Utilizzalo per tracciare incidenti, collegare avvisi ai casi, aggiungere note di indagine o gestire l'output del triage. | 0.1.0 | elastic | | [security-detection-rule-management](https://github.com/elastic/agent-skills/blob/main/skills/security/detection-rule-management/SKILL.md) | Crea, ottimizza e gestisci le regole di rilevamento di Elastic Security (SIEM ed Endpoint). Utilizzalo per falsi positivi, eccezioni, nuova copertura, regole rumorose o gestione delle regole tramite l'API Kibana. | 0.1.0 | elastic | | [security-generate-security-sample-data](https://github.com/elastic/agent-skills/blob/main/skills/security/generate-security-sample-data/SKILL.md) | Genera eventi di sicurezza di esempio, scenari di attacco e avvisi sintetici per Elastic Security. Utilizzalo per demo, popolare dashboard, testare regole di rilevamento o configurare un POC. | 0.1.0 | elastic | | [security-ml-integrations](https://github.com/elastic/agent-skills/blob/main/skills/security/ml-integrations/SKILL.md) | Installa e gestisci i pacchetti di integrazione ML di Elastic Security (beaconing, ded, dga, lmd, pad, problemchild). Gestisce l'intero ciclo di vita: controlli preliminari, installazione del pacchetto Fleet, template dei componenti, pipeline di ingest, transform, data view, job di rilevamento anomalie ML e regole di rilevamento. Utilizzalo quando un utente chiede di installare, configurare, verificare lo stato o risolvere problemi di un pacchetto di integrazione ML di sicurezza. | 0.1.0 | elastic | </details> <!-- END-SKILL-TABLE --> ## Considerazioni sulla sicurezza Gli agenti di coding AI operano con credenziali reali, accesso reale alla shell e spesso con tutti i permessi dell'utente che li esegue. Quando questi agenti vengono indirizzati verso flussi di lavoro di sicurezza, la posta in gioco è più alta. Ciò giustifica una conversazione franca sul rischio prima di iniziare. - **Esegui il tuo threat modeling.** Valuta a quali dati l'agente può accedere, quali azioni può intraprendere e cosa succede se si comporta in modo inatteso. [La guida congiunta della CISA sul deployment sicuro dei sistemi di IA](https://www.cisa.gov/news-events/alerts/2024/04/15/joint-guidance-deploying-ai-systems-securely) è un buon punto di partenza. - **Sii consapevole di quali dati transitano 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 presto i tuoi team di infosec e compliance. - **Questi agenti elaborano input controllati dagli attaccanti.** Avvisi, campi degli eventi e contenuti dei file contengono regolarmente stringhe create dagli attaccanti. Il prompt injection qui non è teorico; è una proprietà intrinseca dell'ambiente operativo. Ricerche come [Brainworm](https://www.originhq.com/blog/brainworm) dimostrano che i soli file di contesto dell'agente possono fungere da meccanismo di persistenza per il promptware. - **Limita rigorosamente i privilegi.** Assegna alle chiavi API il minimo privilegio necessario. Privilegi di risposta ampi sono particolarmente pericolosi. L'accesso in sola lettura è un buon valore predefinito finché non hai validato il comportamento. - **Limita l'accesso agli strumenti dell'agente e la portata di rete.** La maggior parte degli agenti di coding IA viene fornita con impostazioni predefinite ampie: esecuzione della shell, scrittura sul file system, accesso a Internet. Ridurre la superficie degli strumenti disponibili limita ciò che un agente compromesso o indirizzato male 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 contenga dati di sicurezza live. Queste skill sono open source proprio perché tu possa verificare ciò che fanno. Ti invitiamo a leggerle prima di eseguirle. ## Per iniziare Puoi installare le skill Elastic usando il sistema nativo di plugin di Claude Code, la CLI `skills` con `npx`, oppure 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 tutte le 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 pertinenti al tuo flusso di lavoro. Mantenere l'insieme installato mirato evita il gonfiaggio del contesto e aiuta l'agente a instradarsi in modo affidabile verso la skill giusta. ### Plugin Claude Code (consigliato per gli utenti di Claude Code) Claude Code dispone di un sistema nativo di plugin che gestisce direttamente le skill. Inizia aggiungendo questo repository come sorgente marketplace: ```sh claude plugin marketplace add https://github.com/elastic/agent-skills ``` Una volta aggiunti, installa i singoli plugin per nome: ```sh claude plugin install elastic-elasticsearch@elastic-agent-skills claude plugin install elastic-kibana@elastic-agent-skills claude plugin install elastic-observability@elastic-agent-skills claude plugin install elastic-security@elastic-agent-skills claude plugin install elastic-cloud@elastic-agent-skills ``` > [!NOTE] > Dopo l'installazione, le skill potrebbero non apparire immediatamente quando si esegue `/reload-plugins`. Si tratta di un problema noto di Claude Code — riavvia la sessione di Claude Code per caricare i plugin appena installati. Oppure usa il browser interattivo dei plugin all'interno di qualsiasi sessione di Claude Code: ``` /plugins ``` 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 dispone di un sistema di plugin nativo. Aggiungi questo repository come sorgente 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 Copilot: ``` /plugin list ``` ### npx (Consigliato) Il modo più rapido per installare le skill è con la CLI [`skills`](https://github.com/vercel-labs/skills). Non è necessario clonare questo repository — basta eseguire: ```sh npx skills add elastic/agent-skills ``` Avvia un prompt interattivo per selezionare le skill e gli [agenti di destinazione](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents). La CLI copia ogni cartella delle skill nella posizione corretta affinché l'agente possa individuarla. Installa una skill specifica per nome: ```sh npx skills add elastic/agent-skills --skill elasticsearch-esql ``` Oppure usa la forma abbreviata `@` per specificare direttamente la skill come `repo@skill` (equivalente a `--skill`): ```sh npx skills add elastic/agent-skills@elasticsearch-esql ``` Installa per 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 skill disponibili senza installare: ```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 ``` | Flag | Descrizione | | ----------------- | ------------------------------------------------- | | `-a, --agent` | Agenti specifici da selezionare (vedi [Supported agents](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)) | | `-s, --skill` | Installa skill specifiche per nome | | `-g, --global` | Installa nella home dell'utente invece che nella directory del progetto | | `-y, --yes` | Salta le richieste di conferma | | `--all` | Installa tutte le skill per tutti gli agenti senza richieste di conferma | | `--list` | Elenca le skill disponibili senza installarle | ### Clone locale Se preferisci lavorare da un checkout locale, o il tuo ambiente non dispone di Node.js / npx, clona il repository e utilizza l'installer bash incluso: ```sh git clone https://github.com/elastic/agent-skills.git cd agent-skills ./scripts/install-skills.sh add -a <agent> ``` Lo script richiede bash 3.2+ e le utilità Unix standard (`awk`, `find`, `cp`, `rm`, `mkdir`). | Flag | Descrizione | | ----------------- | ------------------------------------- | | `-a, --agent` | Agente di destinazione (ripetibile) | | `-s, --skill` | Installa skill specifiche per nome | | `-f, --force` | Sovrascrive le skill già installate | | `-y, --yes` | Salta i prompt di conferma | Elenca tutte le skill disponibili: ```sh ./scripts/install-skills.sh list ``` ### Agenti supportati | Agente | Directory di installazione | | --------------- | -------------------------- | | claude-code | `.claude/skills` | | cursor | `.agents/skills` | | codex | `.agents/skills` | | opencode | `.agents/skills` | | pi | `.pi/agent/skills` | | windsurf | `.windsurf/skills` | | roo | `.roo/skills` | | cline | `.agents/skills` | | github-copilot | `.agents/skills` | | gemini-cli | `.agents/skills` | ## Aggiornamento delle skill La procedura di aggiornamento dipende da come sono state installate le skill. ### 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 verifica la presenza di nuove versioni dei plugin all'avvio e le 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 le competenze installate sono state modificate upstream: ```sh npx skills check ``` Estrai le versioni più recenti di tutte le skill installate: ```sh npx skills update ``` La CLI tiene traccia del repository di origine di ogni skill e di un hash del contenuto in un file di lock. `check` confronta gli hash locali con GitHub; `update` riscarica tutto ciò che è cambiato. > **Suggerimento:** L'installazione predefinita tramite npx utilizza symlink, quindi ogni agent punta a un'unica copia canonica. Aggiornando una volta si aggiornano tutti gli agent contemporaneamente. ### Clone locale Riesegui l'installer con `--force` per sovrascrivere le skill esistenti: ```sh git pull ./scripts/install-skills.sh add -a <agent> --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](https://agentskills.io/specification). ## Problemi Hai trovato un problema o hai un suggerimento? [Apri una issue](https://github.com/elastic/agent-skills/issues/new) e la esamineremo. ## Disclaimer Queste skill sono fornite così come sono. Testa sempre accuratamente le skill nel tuo ambiente prima di affidarti ad esse per attività critiche.