Elastic Agent Skills

Elastic Agent Skills — criadas pelas pessoas que criaram a Elastic — entregam experiência nativa de plataforma diretamente ao seu agente de codificação de 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] Pré-visualização técnica

Estas skills estão em lançamento inicial e em desenvolvimento ativo. Espere mudanças à medida que as skills são codificadas com avaliações robustas e à medida que o cenário de modelos evolui. Volte com frequência para 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 para de usar padrões desatualizados e começa a acertar.

O que são skills?

Skills são pacotes autônomos que dão aos agentes de IA o conhecimento e as ferramentas para concluir tarefas específicas de forma repetível. Cada skill vive 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 de 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 apontados para fluxos de trabalho de segurança, os riscos são maiores. Isso justifica uma conversa franca sobre riscos antes de começar.

• Faça sua própria modelagem de ameaças. Avalie a quais dados o agente pode acessar, quais ações ele pode tomar 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 incorporadas em linhas de comando e outros dados regulamentados. 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 segurança da informação e conformidade cedo.
• Esses agentes processam entrada controlada por atacantes. Alertas, campos de eventos e conteúdos de arquivos frequentemente contêm strings criadas por atacantes. Injeção de prompt não é teórica aqui; é uma propriedade inerente do ambiente operacional. Pesquisas como Brainworm demonstram que arquivos de contexto de agentes sozinhos podem servir como mecanismo de persistência para promptware.
• Escopem privilégios de forma restrita. Dê às chaves de API os privilégios mínimos necessários. Privilégios amplos de resposta são particularmente perigosos. Acesso somente leitura é um bom padrão até que você valide o comportamento.
• Restrinja o acesso a ferramentas do agente e o alcance de rede. A maioria dos agentes de codificação de IA vem com padrões amplos: execução de shell, escrita no sistema de arquivos, acesso à internet. Reduzir a superfície de ferramentas disponíveis 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 desenvolvimento ou espaço Kibana isolado para avaliar skills antes de conectá-las a qualquer coisa que carregue dados de segurança ao vivo.

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

Começando

Você pode instalar as skills da Elastic usando o sistema de plugins nativo do Claude Code, a CLI skills com npx ou clonando este repositório e executando o script de instalação 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 solicitação. Instale as skills de autenticação cloud e elasticsearch — a maioria das outras skills depende delas — e depois 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 de plugins nativo que gerencia skills diretamente. Comece adicionando este repositório como fonte de marketplace:```sh claude plugin marketplace add https://github.com/elastic/agent-skills

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

Isto 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 fonte de marketplace:```sh
copilot plugin marketplace add elastic/agent-skills

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

Isto 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 utilize o atalho @ para especificar a skill diretamente como repo@skill (equivalente a --skill):```sh npx skills add elastic/agent-skills@elasticsearch-esql

Instale 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 habilidades disponíveis sem instalar:```sh npx skills add elastic/agent-skills --list

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

Clone local

Se você prefere trabalhar a partir de um checkout local, ou seu ambiente não possui 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 habilidades específicas por nome |
| `-f, --force`     | Sobrescrever habilidades já instaladas |
| `-y, --yes`       | Pular prompts de confirmação         |

Listar todas as habilidades 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 as atualiza em segundo plano.

GitHub Copilot CLI

Atualize todos os plugins instalados para 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

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

O CLI rastreia o repositório de origem de cada skill e um hash de conteúdo num ficheiro de bloqueio. O check compara os seus hashes locais com o GitHub; o update volta a descarregar qualquer coisa que tenha divergido.

Dica: A instalação predefinida via npx utiliza 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 sobrescrever 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.

Problemas

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

Aviso legal

Estas skills são fornecidas como estão. Sempre teste as skills minuciosamente no seu próprio ambiente antes de confiar nelas para tarefas críticas.