Elastic Agent Skills

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

[!NOTE] Vista previa técnica

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

Acerca de

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

¿Qué son las skills?

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

Para más contexto sobre el estándar Agent Skills, consulta agentskills.io.

Alcance

Las skills en este repositorio se centran en:

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

Skills disponibles

Consideraciones de seguridad

Los agentes de codificación con IA operan con credenciales reales, acceso real a shell y, a menudo, con todos los permisos del usuario que los ejecuta. Cuando esos agentes se orientan a flujos de trabajo de seguridad, lo que está en juego es mayor. Eso justifica una conversación franca sobre riesgos antes de empezar.

• Realiza tu propio modelado de amenazas. Evalúa a qué datos puede acceder el agente, qué acciones puede tomar y qué sucede si se comporta de forma 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 comandos y otros datos regulados. Cuando un agente consulta alertas o eventos de procesos, ese contenido entra en el contexto del modelo y puede enviarse a una API de terceros. Involucra a tus equipos de infosec y cumplimiento desde el principio.
• Estos agentes procesan entrada controlada 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. Da a las claves API los privilegios mínimos requeridos. Los privilegios de respuesta amplios son particularmente peligrosos. El acceso de solo lectura es un buen valor predeterminado hasta que valides el comportamiento.
• Restringe el acceso a herramientas del agente y el alcance de red. La mayoría de los agentes de codificación con IA 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 mal dirigido puede hacer.
• Empieza 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 skills antes de conectarlas a cualquier cosa que lleve datos de seguridad en vivo.

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

Primeros pasos

Puedes instalar las skills 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 skills. Cada skill instalada añade contexto de enrutamiento que tu agente evalúa en cada solicitud. Instala las skills de autenticación de cloud y elasticsearch — la mayoría de las demás skills dependen de ellas — y luego añade solo las skills relevantes para tu flujo de trabajo. Mantener el conjunto instalado enfocado evita la inflación de contexto y ayuda al agente a enrutar a la skill correcta de forma fiable.

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

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

Una vez añadido, instala los plugins individualmente 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 de inmediato al ejecutar /reload-plugins. Este es un problema conocido de Claude Code: reinicia tu sesión de Claude Code para que se carguen los plugins recién instalados.

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

Esto abre un menú para explorar los 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ñadido, instala los plugins individualmente 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 explora los plugins 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.

Instala 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 (consulta [agentes compatibles](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)):```sh
npx skills add elastic/agent-skills -a cursor -a claude-code

Lista las habilidades disponibles sin instalarlas:```sh npx skills add elastic/agent-skills --list

Instala 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              | Descripción                           |
| ----------------- | ------------------------------------- |
| `-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         |

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

Agentes compatibles

Actualización de skills

El proceso de actualización depende de cómo se instalaron los skills.

Plugin de Claude Code

Actualiza 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, activa la actualización automática usando /plugins dentro de Claude Code.

Cuando la actualización automática está activada, Claude Code busca nuevas versiones de plugins al iniciar 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

Comprueba si alguna de las habilidades instaladas ha cambiado en el repositorio upstream:```sh npx skills check

Descarga las últimas versiones de todas las habilidades instaladas:```sh
npx skills update

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

Consejo: 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 los skills 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 en 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 agentes 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.

Aviso legal

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.