Elastic Agent Skills

Elastic Agent Skills — criadas pelas pessoas que construíram a Elastic — entregam expertise nativa da plataforma diretamente ao seu agente de codificação com IA. Esta é a biblioteca oficial de Agent Skills, compatível com IDEs agênticas como Cursor, GitHub Copilot, Windsurf, Gemini CLI e outras. As skills seguem o padrão aberto Agent Skills.

[!NOTE] Technical Preview

Estas skills estão em versão inicial e em desenvolvimento ativo. Espere mudanças à medida que as skills são codificadas com avaliações robustas e conforme o cenário de modelos evolui. Volte com frequência para ver atualizações.

Sobre

Este repositório contém skills selecionadas, que são pacotes de instruções, contexto e ferramentas que ensinam qualquer agente de IA a trabalhar corretamente com Elasticsearch, Kibana, Elastic Observability e Elastic Security. Coloque-as no runtime de agente que você já usa, e seu assistente deixa de usar padrões desatualizados e começa a acertar.

O que são skills?

Skills são pacotes autocontidos que dão aos agentes de IA o conhecimento e as ferramentas para concluir tarefas específicas de forma repetível. Cada skill fica em sua própria pasta com um arquivo SKILL.md contendo metadados e instruções que o agente segue.

Para mais contexto sobre o padrão Agent Skills, veja agentskills.io.

Escopo

As skills neste repositório focam em:

• Interagir com APIs do Elasticsearch (busca, indexação, gerenciamento de cluster)
• Construir e gerenciar conteúdo do Kibana, como alertas, conectores e mais
• Padrões para Elastic Observability, Elastic Security e Agent Builder

Skills disponíveis

Considerações de segurança

Agentes de codificação com IA operam com credenciais reais, acesso real ao shell e, muitas vezes, com todas as permissões do usuário que os executa. Quando esses agentes são direcionados a fluxos de trabalho de segurança, os riscos são maiores. Isso justifica uma conversa franca sobre risco antes de você começar.

• Faça sua própria modelagem de ameaças. Avalie quais dados o agente pode acessar, quais ações pode executar e o que acontece se ele se comportar de forma inesperada. A orientação conjunta da CISA sobre implantação segura de sistemas de IA é um bom ponto de partida.
• Esteja ciente de quais dados fluem pelo agente. Dados de segurança podem conter PII, credenciais embutidas em linhas de comando e outros dados regulados. Quando um agente consulta alertas ou eventos de processo, esse conteúdo entra no contexto do modelo e pode ser enviado a uma API de terceiros. Envolva suas equipes de infosec e compliance desde o início.
• Esses agentes processam entrada controlada por atacantes. Alertas, campos de eventos e conteúdos de arquivos contêm regularmente strings criadas por atacantes. Prompt injection não é teórico aqui; é uma propriedade inerente do ambiente operacional. Pesquisas como Brainworm demonstram que apenas arquivos de contexto de agente podem servir como mecanismo de persistência para promptware.
• Restrinja privilégios de forma rigorosa. Dê às chaves de API o mínimo de privilégios necessários. Privilégios amplos de resposta são particularmente perigosos. Acesso somente leitura é um bom padrão até você validar o comportamento.
• Restrinja o acesso a ferramentas e o alcance de rede do agente. A maioria dos agentes de codificação com IA vem com padrões amplos: execução de shell, escrita no sistema de arquivos, acesso à internet. Reduzir a superfície de ferramentas disponível limita o que um agente comprometido ou mal direcionado pode fazer.
• Comece em ambientes que não sejam de produção. Use um projeto de teste Serverless, cluster de dev ou espaço Kibana isolado para avaliar as skills antes de conectá-las a qualquer coisa que carregue dados de segurança em produção.

Estas skills são open source justamente para que você possa auditar o que elas fazem. Encorajamos você a lê-las antes de executá-las.

Primeiros passos

Você pode instalar as skills da Elastic usando o sistema nativo de plugins do Claude Code, a CLI skills com npx, ou clonando este repositório e executando o script instalador incluído. O método npx requer Node.js com npx disponível em seu ambiente.

[!TIP] Não instale todas as skills. Cada skill instalada adiciona contexto de roteamento que seu agente avalia em cada requisição. Instale as skills de autenticação cloud e elasticsearch — a maioria das outras skills depende delas — e então adicione apenas as skills relevantes ao seu fluxo de trabalho. Manter o conjunto instalado focado evita inchaço de contexto e ajuda o agente a rotear para a skill certa de forma confiável.

Plugin do Claude Code (Recomendado para usuários do Claude Code)

O Claude Code tem um sistema nativo de plugins que gerencia skills diretamente. Comece adicionando este repositório como uma fonte de marketplace:```sh claude plugin marketplace add https://github.com/elastic/agent-skills

Uma vez adicionado, instale plugins individuais por 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] Após a instalação, as skills podem não aparecer imediatamente ao executar /reload-plugins. Este é um problema conhecido do Claude Code — reinicie a sua sessão do Claude Code para carregar os plugins recém-instalados.

Ou use o navegador interativo de plugins dentro de qualquer sessão do Claude Code:``` /plugins

Isso abre um menu para navegar pelos plugins disponíveis de todos os marketplaces configurados, selecionar o que instalar e gerenciar o que já está instalado.

### GitHub Copilot CLI

O GitHub Copilot CLI possui um sistema de plugins nativo. Adicione este repositório como uma fonte de marketplace:```sh
copilot plugin marketplace add elastic/agent-skills

Uma vez adicionado, instale plugins individuais por 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

Ou navegue pelos plugins disponíveis interativamente dentro de uma sessão do Copilot:```
/plugin list

npx (Recomendado)

A forma mais rápida de instalar skills é com a CLI skills. Não é necessário clonar este repositório — basta executar:```sh npx skills add elastic/agent-skills

Isso inicia um prompt interativo para selecionar skills e [agentes de destino](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents). A CLI copia cada pasta de skill para o local correto para que o agente a descubra.

Instale uma skill específica pelo nome:```sh
npx skills add elastic/agent-skills --skill elasticsearch-esql

Ou use o atalho @ para especificar a skill diretamente como repo@skill (equivalente a --skill):```sh npx skills add elastic/agent-skills@elasticsearch-esql

Instalar em agentes específicos (consulte [agentes suportados](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)):```sh
npx skills add elastic/agent-skills -a cursor -a claude-code

Liste as skills disponíveis sem instalar:```sh npx skills add elastic/agent-skills --list

Instale todas as skills em todos os agentes (não interativo):```sh
npx skills add elastic/agent-skills --all

Clone local

Se você preferir trabalhar a partir de um checkout local, ou seu ambiente não tiver Node.js / npx, clone o repositório e use o instalador bash incluído:```sh git clone https://github.com/elastic/agent-skills.git cd agent-skills ./scripts/install-skills.sh add -a

O script requer bash 3.2+ e utilitários Unix padrão (`awk`, `find`, `cp`, `rm`, `mkdir`).

| Flag              | Descrição                             |
| ----------------- | ------------------------------------- |
| `-a, --agent`     | Agente de destino (repetível)         |
| `-s, --skill`     | Instalar skills específicas por nome  |
| `-f, --force`     | Sobrescrever skills já instaladas     |
| `-y, --yes`       | Ignorar prompts de confirmação        |

Listar todas as skills disponíveis:```sh
./scripts/install-skills.sh list

Agentes suportados

Atualizando skills

O processo de atualização depende de como as skills foram instaladas.

Plugin do Claude Code

Atualize todos os plugins instalados para suas versões mais recentes:```sh claude plugin update

Atualizar um plugin específico:```sh
claude plugin update elastic-elasticsearch

Para manter os plugins atualizados automaticamente, ative a atualização automática usando /plugins dentro do Claude Code.

Quando a atualização automática está ativada, o Claude Code verifica novas versões de plugins na inicialização e atualiza em segundo plano.

GitHub Copilot CLI

Atualize todos os plugins instalados para as suas versões mais recentes:```sh copilot plugin update

Atualizar um plugin específico:```sh
copilot plugin update elasticsearch

npx

Verifique se alguma skill instalada foi alterada upstream:```sh npx skills check

Baixe as versões mais recentes de todas as skills instaladas:```sh
npx skills update

A CLI rastreia o repositório de origem de cada skill e um hash de conteúdo num arquivo de lock. O check compara os hashes locais com o GitHub; o update baixa novamente tudo o que tenha divergido.

Dica: A instalação padrão via npx usa symlinks, pelo que cada agente aponta para uma única cópia canónica. Atualizar uma vez atualiza todos os agentes ao mesmo tempo.

Clone local

Execute novamente o instalador com --force para substituir as skills existentes:```sh git pull ./scripts/install-skills.sh add -a --force

Sem `--force`, o script ignora skills que já estão instaladas.

## Formato de skill

Cada pasta de skill contém um `SKILL.md` com frontmatter YAML e instruções em 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]

O campo description é o único mecanismo de acionamento — os runtimes de agentes o leem para decidir quando carregar uma skill. Para a especificação completa do formato, consulte agentskills.io/specification.

Issues

Encontrou um problema ou tem uma sugestão? Abra uma issue e nós a revisaremos.

Disclaimer

Estas skills são fornecidas no estado em que se encontram. Sempre teste as skills minuciosamente em seu próprio ambiente antes de depender delas para tarefas críticas.