Elastic Agent Skills

As Elastic Agent Skills — construídas por quem construiu o Elastic — entregam experiência nativa da plataforma diretamente ao seu agente de IA para codificação. Esta é a biblioteca oficial de Agent Skills, compatível com IDEs agênticos como Cursor, GitHub Copilot, Windsurf, Gemini CLI e outros. 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 regularmente 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 completar 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 informações sobre o padrão Agent Skills, consulte agentskills.io.

Escopo

As skills neste repositório focam em:

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

Skills Disponíveis

Considerações de segurança

Agentes de IA para codificação operam com credenciais reais, acesso real ao shell e, frequentemente, 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 exige uma conversa franca sobre riscos antes de começar.

• Faça sua própria modelagem de ameaças. Avalie quais dados o agente pode acessar, quais ações ele pode tomar e o que acontece se ele se comportar inesperadamente. O guia conjunto da CISA sobre implantação segura de sistemas de IA é um bom ponto de partida.
• Esteja ciente de quais dados passam pelo agente. Dados de segurança podem conter PII, credenciais embutidas 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 para uma API de terceiros. Envolva suas equipes de segurança da informação e conformidade 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. Injeção de prompt não é teórica aqui; é uma propriedade inerente do ambiente operacional. Pesquisas como Brainworm demonstram que arquivos de contexto de agente sozinhos podem servir como mecanismo de persistência para promptware.
• Escopo de privilégios estrito. 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 IA para codificação vem com padrões amplos: execução de shell, gravação 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 não produtivos. Use um projeto Serverless de teste, cluster de desenvolvimento ou espaço isolado do Kibana para avaliar as skills antes de conectá-las a qualquer coisa que contenha dados de segurança ao vivo.

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

Primeiros passos

Você pode instalar as Elastic Skills usando o sistema de plugins nativo do Claude Code, o 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 então adicione apenas as skills relevantes para seu fluxo de trabalho. Manter o conjunto instalado focado evita inchaço de contexto e ajuda o agente a rotear para a skill correta de forma confiável.

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

O Claude Code possui um sistema de plugins nativo que gerencia as 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 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 habilidades 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 de plugins interativo 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

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 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 maneira mais rápida de instalar skills é com a CLI skills. Não há necessidade de clonar este repositório — basta executar:

npx @vercel/skills@latest
``````sh
npx skills add elastic/agent-skills

Isso inicia um prompt interativo para selecionar habilidades e agentes alvo. A CLI copia cada pasta de habilidade para o local correto para o agente descobrir.

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

Ou use a abreviação `@` 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 (veja agentes suportados):```sh npx skills add elastic/agent-skills -a cursor -a claude-code

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

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

| `-a, --agent`     | Agentes alvo específicos (veja [Agentes suportados](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)) |
| `-s, --skill`     | Instalar habilidades específicas pelo nome        |
| `-g, --global`    | Instalar no diretório home do usuário em vez do diretório do projeto |
| `-y, --yes`       | Pular prompts de confirmação                       |
| `--all`           | Instalar todas as habilidades em todos os agentes sem prompts |
| `--list`          | Listar habilidades disponíveis sem instalar        |

### Clone local

Se 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 empacotado:```sh
git clone https://github.com/elastic/agent-skills.git
cd agent-skills
./scripts/install-skills.sh add -a <agent>

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

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

### Agentes suportados

| Agente          | Diretório de instalação   |
| --------------- | ------------------------- |
| 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`          |

## Atualizando habilidades

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

### Plugin Claude Code

Atualizar 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` no Claude Code.

Quando a atualização automática está ativa, 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 algum skill instalado mudou upstream:```sh
npx skills check

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

A CLI rastreia o repositório de origem de cada skill e um hash de conteúdo em um arquivo de bloqueio. `check` compara seus hashes locais com o GitHub; `update` baixa novamente qualquer coisa que tenha se desviado.

> **Dica:** A instalação padrão do npx usa links simbólicos, portanto, 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 as skills existentes:```sh
git pull
./scripts/install-skills.sh add -a <agent> --force

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

Formato da skill

Toda pasta de skill contém um SKILL.md com frontmatter YAML e instruções 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 gatilho — os runtimes dos agentes o leem para decidir quando carregar uma skill. Para a especificação completa do formato, veja [agentskills.io/specification](https://agentskills.io/specification).

## Issues

Encontrou um problema ou tem uma sugestão? [Abra uma issue](https://github.com/elastic/agent-skills/issues/new) e a analisaremos.

## Disclaimer

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.