Elastic Agent Skills

Elastic Agent Skills — creadas por las personas que crearon Elastic — aportan la experiencia nativa de la plataforma directamente a tu agente de IA para codificación. Esta es la biblioteca oficial de habilidades para agentes, compatible con IDEs agentes como Cursor, GitHub Copilot, Windsurf, Gemini CLI y más. Las habilidades siguen el estándar abierto Agent Skills.

[!NOTE] Vista previa técnica

Estas habilidades están en una versión temprana y en desarrollo activo. Se esperan cambios a medida que las habilidades se estandarizan con evaluaciones robustas y a medida que evoluciona el panorama de modelos. Vuelve con frecuencia para ver las actualizaciones.

Acerca de

Este repositorio contiene habilidades seleccionadas que son paquetes de instrucciones, contexto y herramientas que enseñan a cualquier agente de IA cómo trabajar correctamente con Elasticsearch, Kibana, Elastic Observability y Elastic Security. Incorpóralas en el runtime de agente que ya usas, y tu asistente dejará de usar patrones obsoletos y empezará a hacerlo bien.

¿Qué son las habilidades?

Las habilidades son paquetes autocontenidos que proporcionan a los agentes de IA el conocimiento y las herramientas para completar tareas específicas de manera repetible. Cada habilidad reside en su propia carpeta con un archivo SKILL.md que contiene metadatos e instrucciones que el agente sigue.

Para más información sobre el estándar Agent Skills, consulta agentskills.io.

Alcance

Las habilidades en este repositorio se centran en:

• Interactuar con las APIs de Elasticsearch (búsqueda, indexación, gestión de clúster)
• Crear y gestionar contenido de Kibana como alertas, conectores y más
• Patrones para Elastic Observability, Elastic Security y Agent Builder

Habilidades disponibles

Consideraciones de seguridad

Los agentes de IA para codificación operan con credenciales reales, acceso real al shell y, a menudo, con todos los permisos del usuario que los ejecuta. Cuando esos agentes se dirigen a flujos de trabajo de seguridad, las apuestas son más altas. Eso justifica una conversación franca sobre el riesgo antes de empezar.

• Realiza tu propio modelado de amenazas. Evalúa a qué datos puede acceder el agente, qué acciones puede realizar y qué sucede si se comporta de manera inesperada. La guía conjunta de CISA sobre el despliegue seguro de sistemas de IA es un buen punto de partida.
• Sé consciente de qué datos fluyen a través del agente. Los datos de seguridad pueden contener PII, credenciales incrustadas en líneas de comando y otros datos regulados. Cuando un agente consulta alertas o eventos de procesos, ese contenido entra en el contexto del modelo y puede ser enviado a una API de terceros. Involucra a tus equipos de seguridad de la información y cumplimiento desde el principio.
• Estos agentes procesan entradas controladas por atacantes. Las alertas, los campos de eventos y los contenidos de archivos contienen regularmente cadenas creadas por atacantes. La inyección de prompts no es teórica aquí; es una propiedad inherente del entorno operativo. Investigaciones como Brainworm demuestran que los archivos de contexto del agente por sí solos pueden servir como mecanismo de persistencia para promptware.
• Limita los privilegios estrictamente. Otorga a las claves API los privilegios mínimos necesarios. Los privilegios de respuesta amplios son particularmente peligrosos. El acceso de solo lectura es un buen valor predeterminado hasta que hayas validado el comportamiento.
• Restringe el acceso a herramientas del agente y el alcance de red. La mayoría de los agentes de IA para codificación vienen con valores predeterminados amplios: ejecución de shell, escritura en el sistema de archivos, acceso a Internet. Reducir la superficie de herramientas disponibles limita lo que un agente comprometido o desviado puede hacer.
• Comienza en entornos que no sean de producción. Usa un proyecto de prueba Serverless, un clúster de desarrollo o un espacio aislado de Kibana para evaluar las habilidades antes de conectarlas a cualquier cosa que transporte datos de seguridad en vivo.

Estas habilidades son de código abierto precisamente para que puedas auditar lo que hacen. Te animamos a leerlas antes de ejecutarlas.

Primeros pasos

Puedes instalar habilidades de Elastic usando el sistema de plugins nativo de Claude Code, la CLI skills con npx, o clonando este repositorio y ejecutando el script de instalación incluido. El método npx requiere Node.js con npx disponible en tu entorno.

[!TIP] No instales todas las habilidades. Cada habilidad instalada añade contexto de enrutamiento que tu agente evalúa en cada solicitud. Instala las habilidades de autenticación de cloud y elasticsearch — la mayoría de las otras habilidades dependen de ellas — luego añade solo las habilidades relevantes para tu flujo de trabajo. Mantener el conjunto instalado enfocado evita la hinchazón de contexto y ayuda al agente a enrutar a la habilidad correcta de manera confiable.

Plugin de Claude Code (Recomendado para usuarios de Claude Code)

Claude Code tiene un sistema de plugins nativo que gestiona las habilidades directamente. Comienza añadiendo este repositorio como fuente de marketplace:```sh claude plugin marketplace add https://github.com/elastic/agent-skills

Una vez añadidos, instala plugins individuales por nombre:```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] Después de la instalación, es posible que las habilidades no aparezcan inmediatamente al ejecutar /reload-plugins. Este es un problema conocido de Claude Code: reinicia tu sesión de Claude Code para que las habilidades recién instaladas aparezcan.

O usa el navegador interactivo de plugins dentro de cualquier sesión de Claude Code:``` /plugins

Esto abre un menú para explorar plugins disponibles de todos los marketplaces configurados, seleccionar qué instalar y gestionar lo que ya está instalado.

### GitHub Copilot CLI

GitHub Copilot CLI tiene un sistema de plugins nativo. Añade este repositorio como fuente de marketplace:```sh
copilot plugin marketplace add elastic/agent-skills

Una vez añadidos, instale complementos individuales por nombre:```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

O navegue por los complementos disponibles de forma interactiva dentro de una sesión de Copilot:```
/plugin list

npx (Recomendado)

La forma más rápida de instalar skills es con la CLI skills. No es necesario clonar este repositorio — solo ejecuta:```sh npx skills add elastic/agent-skills

Esto lanza un prompt interactivo para seleccionar habilidades y [agentes objetivo](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents). La CLI copia cada carpeta de habilidad en la ubicación correcta para que el agente la descubra.

Instalar una habilidad específica por nombre:```sh
npx skills add elastic/agent-skills --skill elasticsearch-esql

O usa la abreviatura @ para especificar la habilidad directamente como repo@skill (equivalente a --skill):```sh npx skills add elastic/agent-skills@elasticsearch-esql

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

Listar habilidades disponibles sin instalar:```sh npx skills add elastic/agent-skills --list

Instalar todas las habilidades en todos los agentes (no interactivo):```sh
npx skills add elastic/agent-skills --all

Clon local

Si prefieres trabajar desde una copia local, o tu entorno no tiene Node.js / npx, clona el repositorio y usa el instalador bash incluido:```sh git clone https://github.com/elastic/agent-skills.git cd agent-skills ./scripts/install-skills.sh add -a

El script requiere bash 3.2+ y utilidades Unix estándar (`awk`, `find`, `cp`, `rm`, `mkdir`).

| Flag              | Description                           |
| ----------------- | ------------------------------------- |
| `-a, --agent`     | Agente objetivo (repetible)           |
| `-s, --skill`     | Instalar habilidades específicas por nombre |
| `-f, --force`     | Sobrescribir habilidades ya instaladas |
| `-y, --yes`       | Omitir avisos de confirmación         |

Listar todas las habilidades disponibles:```sh
./scripts/install-skills.sh list

Agentes compatibles

Actualizando habilidades

El proceso de actualización depende de cómo se instalaron las habilidades.

Plugin de Claude Code

Actualizar todos los plugins instalados a sus últimas versiones:```sh claude plugin update

Actualizar un plugin específico:```sh
claude plugin update elastic-elasticsearch

Para mantener los plugins actualizados automáticamente, habilita la actualización automática usando /plugins dentro de Claude Code.

Cuando la actualización automática está activada, Claude Code verifica nuevas versiones de plugins al inicio y las actualiza en segundo plano.

GitHub Copilot CLI

Actualiza todos los plugins instalados a sus últimas versiones:```sh copilot plugin update

Actualizar un plugin específico:```sh
copilot plugin update elasticsearch

npx

Comprobar si algún skill instalado ha cambiado en el upstream:```sh npx skills check

Obtén las últimas versiones de todas las habilidades instaladas:```sh
npx skills update

El CLI rastrea el repositorio fuente de cada habilidad y un hash de contenido en un archivo de bloqueo. check compara tus hashes locales con los de GitHub; update vuelve a descargar cualquier cosa que se haya desviado.

Tip: La instalación predeterminada de npx usa enlaces simbólicos, por lo que cada agente apunta a una única copia canónica. Actualizar una vez refresca todos los agentes al mismo tiempo.

Clon local

Vuelve a ejecutar el instalador con --force para sobrescribir las habilidades existentes:```sh git pull ./scripts/install-skills.sh add -a --force

Sin `--force` el script omite las habilidades que ya están instaladas.

## Formato de habilidad

Cada carpeta de habilidad contiene un `SKILL.md` con frontmatter YAML e instrucciones 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]

El campo description es el único mecanismo de activación — los runtimes de agente lo leen para decidir cuándo cargar una habilidad. Para la especificación completa del formato, consulta agentskills.io/specification.

Problemas

¿Encontraste un problema o tienes una sugerencia? Abre un issue y lo revisaremos.

Descargo de responsabilidad

Estas habilidades se proporcionan tal cual. Siempre prueba las habilidades a fondo en tu propio entorno antes de confiar en ellas para tareas críticas.