Competencias Oficiales de Elastic
Descubre las herramientas más usadas por nuestra comunidad.
Sin datos de popularidad aún.
<p align="center"> <img alt="Elastic logo" src="https://assets.kitploit.com/production/public/readmes/12587/8e357b6e4cbecb13a462cd8da398525dbe599bb7210c6426f2f1103702561816.png" width="200"> </p> <p align="center"> <a href="https://github.com/elastic/agent-skills/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/badge/license-Apache%202.0-blue"></a> </p> # Elastic Agent Skills Elastic Agent Skills — creado por las personas que construyeron Elastic — ofrece experiencia nativa en la plataforma directamente a tu agente de programación con IA. Esta es la biblioteca oficial de Agent Skills, compatible con IDE agénticos como Cursor, GitHub Copilot, Windsurf, Gemini CLI y más. Las skills siguen el estándar abierto [Agent Skills](https://agentskills.io/). > [!NOTE] > **Technical Preview** > > Estas skills están en versión preliminar y en desarrollo activo. Se esperan cambios a medida que las skills se codifican con evaluaciones > robustas y a medida que evoluciona el panorama de modelos. Vuelve a consultar con frecuencia para ver las actualizaciones. ## Acerca de Este repositorio contiene skills 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. Inclúyelas en el entorno de ejecución del agente que ya uses, y tu asistente dejará de usar patrones obsoletos y empezará a hacerlo bien. ## ¿Qué son las skills? Las skills son paquetes autocontenidos que proporcionan a los agentes de IA el conocimiento y las herramientas para completar tareas específicas de forma repetible. Cada skill 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](http://agentskills.io/). ## Alcance Las skills de este repositorio se centran en: - Interactuar con las API 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 <!-- BEGIN-SKILL-TABLE --> ## Skills disponibles <details> <summary>Cloud (2)</summary> | Skill | Descripción | Versión | Autor | | ----- | ----------- | ------- | ------ | | [cloud-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/cloud/onboarding/SKILL.md) | Incorporar una organización de Elastic Cloud: configurar el contexto Cloud y la clave API de la CLI `elastic`, establecer una región predeterminada y luego invitar a usuarios, asignar roles predefinidos o personalizados de proyectos Serverless, y crear o revocar claves API de Cloud. Úsalo al configurar la autenticación de Cloud o al conceder, modificar o auditar el acceso de usuarios a una organización y sus proyectos. | 0.3.0 | elastic | | [cloud-provisioning](https://github.com/elastic/agent-skills/blob/main/skills/cloud/provisioning/SKILL.md) | Aprovisionar y operar la infraestructura de Elastic Cloud: crear, conectarse, actualizar y eliminar proyectos Serverless (Elasticsearch, Observability, Security); gestionar filtros de tráfico (seguridad de red IP y AWS PrivateLink); y gestionar el ciclo de vida de los despliegues de Elastic Cloud Hosted. Úsalo al crear o realizar operaciones de día 2 en proyectos serverless o despliegues alojados, o al restringir su acceso de red. | 0.3.0 | elastic | </details> <details> <summary>Elasticsearch (10)</summary> | Skill | Descripción | Versión | Autor | | ----- | ----------- | ------- | ------ | | [elasticsearch-anomaly-detection](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-anomaly-detection/SKILL.md) | Crear y gestionar trabajos de detección de anomalías de Elastic ML mediante la API. Úsalo al configurar trabajos en un índice o flujo de datos, al configurar trabajos y datafeeds, o al abrirlos, iniciarlos o detenerlos. | 1.1.0 | elastic | | [elasticsearch-anomaly-detection-explainer](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-anomaly-detection-explainer/SKILL.md) | Explicar las puntuaciones de detección de anomalías de Elasticsearch ML, el comportamiento del modelo y la interpretación de los resultados. Úsalo cuando el usuario pregunte por qué una puntuación es alta o baja, cómo aprende el modelo, qué significan los números o cómo solucionar puntuaciones de anomalía inesperadas. | 0.3.0 | elastic | | [elasticsearch-cluster-health](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-cluster-health/SKILL.md) | Diagnosticar un clúster de Elasticsearch que no está en verde y exponer la causa más probable con su remediación. Úsalo cuando un operador informe de un estado amarillo o rojo, shards no asignados, fallos de asignación, o quiera un triaje de solo lectura antes de una investigación más profunda. Enseña el impacto de réplica frente a primario, la clasificación de decisores de asignación y la concienciación sobre pérdida de datos. | 0.1.0 | elastic | | [elasticsearch-esql](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-esql/SKILL.md) | Ejecutar consultas ES\|QL (Elasticsearch Query Language); úsalo cuando el usuario quiera consultar datos de Elasticsearch, analizar logs, agregar métricas, explorar datos o crear gráficos y dashboards a partir de resultados de ES\|QL. | 0.10.0 | elastic | | [elasticsearch-index-design](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-index-design/SKILL.md) | Diseñar y revisar mappings de índices de Elasticsearch para patrones de acceso declarados: tipos de campo correctos, multi-campos text+keyword, ajuste de doc_values, evitación de la explosión de mappings y configuración explícita de shards. Úsalo al crear un nuevo índice, al revisar un mapping para el rendimiento de almacenamiento o consultas, al corregir tipos de campo incorrectos, o cuando el usuario pregunte qué tipo usar para búsqueda, filtrado, ordenación o agregación sobre un campo. | 0.1.0 | elastic | | [elasticsearch-ingest](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-ingest/SKILL.md) | Cargar archivos CSV, JSON y NDJSON en índices de Elasticsearch usando la API bulk y mappings explícitos cuando los tipos de campo importan. Úsalo al importar por lotes archivos locales, al convertir filas CSV o arrays JSON al formato bulk NDJSON, al confirmar la conectividad del clúster con elastic es info antes de la ingesta, o al verificar recuentos de documentos y mappings después de la ingesta — no para pipelines de Logstash, Beats, scripts personalizados ni reindex de índice a índice. | 0.1.3 | elastic | | [elasticsearch-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-onboarding/SKILL.md) | Ayudar a los desarrolladores nuevos en Elasticsearch a pasar de cero a una experiencia de búsqueda funcional. Guiarlos a través de la comprensión de su intención, el mapeo de sus datos y la construcción de una experiencia de búsqueda con las mejores prácticas incorporadas. Úsalo cuando el usuario muestre intención de construir funcionalidad relacionada con la búsqueda, pregunte sobre conceptos relacionados con Elasticsearch para su caso de uso, o exprese la necesidad de ayuda para empezar con Elasticsearch. | 0.3.0 | elastic | | [elasticsearch-query-optimization](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-query-optimization/SKILL.md) | Diagnosticar búsquedas lentas de Elasticsearch Query DSL y proponer correcciones medidas. Úsalo cuando una búsqueda sea lenta, la salida de profile muestre una cláusula costosa, los filtros de coincidencia exacta estén en contexto de puntuación, o los comodines iniciales dominen la latencia. Basa cada recomendación en el profiling de búsqueda — mueve las cláusulas que no puntúan al contexto de filtro, elimina los comodines iniciales y vuelve a hacer profiling para confirmar la mejora. | 0.1.0 | elastic | | [elasticsearch-reindex](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-reindex/SKILL.md) | Guiar el reindex de Elasticsearch para el rendimiento: local y remoto, slicing, throttling, task API. Úsalo al copiar o migrar índices, cambiar mappings o transformar durante el reindex. | 0.2.0 | elastic | | [elasticsearch-search-relevance](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-search-relevance/SKILL.md) | Mejora la relevancia de búsqueda de Elasticsearch para índices de contenido y catálogo: fija o promociona resultados con reglas de consulta (tipo de regla, criterios y conexión de regla-consulta correctos) y ajusta el ranking orgánico con multi_match, boosts de campos y análisis basado en el mapeo del índice. Úsalo cuando los resultados de búsqueda tengan un ranking deficiente, un documento específico deba aparecer primero para una consulta, o el usuario solicite ajustar la coincidencia de texto completo — no para analítica ES\|QL, ingesta de índices ni salud del clúster. | 0.1.0 | elastic | </details> <details> <summary>Kibana (7)</summary> | Habilidad | Descripción | Versión | Autor | | ----- | ----------- | ------- | ------ | | [kibana-agent-builder](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-agent-builder/SKILL.md) | Crea y gestiona agentes y herramientas personalizadas de Kibana Agent Builder. Úsalo cuando se solicite crear, actualizar, eliminar, probar o inspeccionar agentes o herramientas en Agent Builder, o cuando el usuario quiera entender qué agentes o herramientas ya existen. | 0.3.0 | elastic | | [kibana-alerting-rules](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-alerting-rules/SKILL.md) | Crea y gestiona reglas de alertas de Kibana. Úsalo al crear, actualizar o gestionar el ciclo de vida de las reglas (habilitar, deshabilitar, silenciar, posponer), al elegir tipos y parámetros de reglas de umbral de métricas, o para búsqueda/listado de solo lectura con filtros de etiquetas. | 0.3.0 | elastic | | [kibana-anomaly-detection](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-anomaly-detection/SKILL.md) | Detección de anomalías de ML de Elastic — investigación/RCA, explicación de puntuaciones, resolución de problemas del ciclo de vida de los jobs y operaciones de jobs. Úsalo al responder "¿qué se rompió?"/"¿qué entidad?"/RCA, "¿por qué la puntuación es alta/baja?"/renormalización, "el datafeed se detuvo"/"límite de memoria"/hard_limit, o al configurar jobs de detección de anomalías de ML. Lee resultados de `.ml-anomalies-*` y el estado de los jobs desde las API REST de ML. | 0.3.0 | elastic | | [kibana-cases](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-cases/SKILL.md) | Gestiona casos de investigación e incidentes en Elastic Security, Observability y Stack Management — crea, busca, actualiza y enriquece casos con comentarios, alertas, eventos y observables (IOC). Úsalo al rastrear incidentes, correlacionar alertas con un caso, añadir notas de investigación, actualizar el estado o la severidad, o gestionar la salida del triaje. | 0.2.0 | elastic | | [kibana-context-engine](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-context-engine/SKILL.md) | Consulta los AI Indices de Elastic Context Engine y los Knowledge Indicators (KI) que almacenan. Úsalo cuando se solicite buscar, explorar, contar o responder preguntas a partir de un índice de conocimiento de AI Index / KI / Context Engine, y al escribir el ES\|QL que consulta uno. | 0.2.1 | elastic | | [kibana-dashboards](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-dashboards/SKILL.md) | Crea y gestiona Dashboards de Kibana y visualizaciones de Lens. Úsalo cuando necesites definir dashboards y visualizaciones de forma declarativa, controlar sus versiones, automatizar su despliegue o mejorar el diseño, las secciones, los controles o el diseño de los gráficos. | 0.4.0 | elastic | | [kibana-workflows](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-workflows/SKILL.md) | Crea, valida, prueba, ejecuta e inspecciona definiciones YAML de Elastic Workflow. Úsalo cuando el usuario quiera convertir lenguaje natural en un workflow de Kibana, corregir YAML de workflows, entender triggers o pasos, o ejecutar un bucle de prueba rápido contra un Kibana real. | 0.5.0 | elastic | </details> <details> <summary>Observability (6)</summary> | Skill | Descripción | Versión | Autor | | ----- | ----------- | ------- | ------ | | [observability-csp-investigation](https://github.com/elastic/agent-skills/blob/main/skills/observability/csp-investigation/SKILL.md) | Investiga problemas de servicios de proveedores de nube (CSP) — AWS actualmente (el razonamiento aplica a cualquier servicio de AWS; el esquema y las firmas de fallo son más profundos para RDS, Lambda, SQS, ALB, EC2), y en el futuro GCP y Azure — usando métricas de nube con esquema OTel en Elastic. Úsalo al diagnosticar problemas de recursos en la nube, ya sean activados por alertas o ad hoc: presión de conexiones/CPU/memoria en bases de datos, tasas de error y limitación de funciones, acumulación de colas y retraso de consumidores, 5xx en balanceadores de carga, saturación de instancias. Correlaciona el recurso bajo investigación con su propia línea base, clasifica el modo de fallo y descarta condiciones concurrentes pero no relacionadas. | 0.2.0 | elastic | | [observability-k8s-investigation](https://github.com/elastic/agent-skills/blob/main/skills/observability/k8s-investigation/SKILL.md) | Investiga problemas de cargas de trabajo, nodos y plano de control de Kubernetes usando telemetría OTel (EDOT). Úsalo al diagnosticar fallos de pods (CrashLoopBackOff, OOMKilled, Error), presión de nodos, agotamiento de recursos, fallos de extracción de imágenes, rechazos de admisión, anomalías de autoescalado o al correlacionar el estado de K8s con señales de aplicaciones. Solo ruta de ingesta OTel — la forma de la integración heredada de Kubernetes de ECS queda fuera del alcance. | 0.5.1 | elastic | | [observability-llm-obs](https://github.com/elastic/agent-skills/blob/main/skills/observability/llm-obs/SKILL.md) | Responde preguntas sobre el comportamiento de LLM y aplicaciones agénticas a partir de datos ya ingeridos en Elastic: latencia y tasa de error, utilización de tokens y costos, calidad de respuesta y eventos de guardarraíles, y orquestación de cadenas de llamadas agénticas. Úsalo cuando el usuario pregunte sobre monitoreo de LLM, observabilidad de GenAI, gasto de tokens o costo de IA, latencia de modelos, fallos de prompts o guardarraíles, o cómo se ejecutó la cadena de llamadas a herramientas de un agente. | 0.3.1 | elastic | | [observability-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/observability/onboarding/SKILL.md) | Incorpora una aplicación a Elastic Observability con la Elastic Distribution of OpenTelemetry (EDOT): enruta según lenguaje y runtime, detecta y reemplaza un agente clásico de Elastic APM, aplica la configuración OTLP requerida y luego verifica con ES\|QL que las trazas, métricas y logs realmente lleguen bajo el nombre de servicio esperado. Úsalo al añadir observabilidad a un servicio, al migrar desde el agente clásico de Elastic APM o al depurar por qué un servicio instrumentado no aparece en Elastic. | 0.3.0 | elastic | | [observability-service-reliability](https://github.com/elastic/agent-skills/blob/main/skills/observability/service-reliability/SKILL.md) | Diseña y opera objetivos de confiabilidad de servicios en Elastic Observability: elige un tipo de SLI y un objetivo defendible, selecciona una ventana temporal y un método de presupuestación, crea y mantén SLOs mediante la API de Kibana, adjunta reglas de alerta de tasa de consumo y decide cuándo un SLO es el instrumento equivocado y una regla de umbral, un trabajo de anomalías o un monitor de synthetics es lo correcto. Úsalo al definir o revisar SLOs y presupuestos de error, ajustar alertas de tasa de consumo, reducir el ruido de alertas o configurar monitoreo de disponibilidad para un endpoint orientado al usuario. | 0.4.1 | elastic | | [observability-sre-triage](https://github.com/elastic/agent-skills/blob/main/skills/observability/sre-triage/SKILL.md) | Realiza el triaje de un servicio degradado o sospechoso de extremo a extremo: lee el estado del SLO y la tasa de consumo, revisa las reglas de alerta activas y las anomalías de ML, mide el rendimiento, la latencia y la tasa de error, evalúa la salud de las dependencias y la saturación de la infraestructura, y filtra los logs hasta los fallos que lo explican. Úsalo cuando alguien pregunte si un servicio está saludable, por qué está lento o generando errores, qué hay en sus logs o qué atributo distingue las solicitudes que están fallando. Úsalo también cuando alguien pida la consulta detrás de cualquiera de esas señales — rendimiento, percentiles de latencia, tasa de error, salud de dependencias o volumen de logs — sobre trazas, métricas o logs de APM/OTel. | 0.5.2 | elastic | </details> <details> <summary>Seguridad (6)</summary> | Habilidad | Descripción | Versión | Autor | | ----- | ----------- | ------- | ------ | | [security-alert-analysis](https://github.com/elastic/agent-skills/blob/main/skills/security/alert-analysis/SKILL.md) | Investiga una alerta de detección específica de Elastic Security: recopila contexto, evalúa el riesgo de la entidad, clasifica la amenaza, documenta los hallazgos y, opcionalmente, la reconoce. Úsalo al triar una única alerta conocida, realizar una investigación de SOC o hacer seguimiento después de que la habilidad security-alert-triage identifique un grupo que investigar. | 0.1.0 | elastic | | [security-alert-triage](https://github.com/elastic/agent-skills/blob/main/skills/security/alert-triage/SKILL.md) | Prioriza y clasifica la cola de alertas de Elastic Security por riesgo ponderado — puntuación de riesgo base, impulso de táctica MITRE, riesgo de entidad y criticidad del activo — y luego agrupa las alertas en grupos de entidades. Úsalo cuando un analista pregunte en qué centrarse, qué alertas son más urgentes o quiera un punto de partida clasificado en toda la cola antes de comenzar una investigación más profunda. | 0.2.0 | elastic | | [security-case-management](https://github.com/elastic/agent-skills/blob/main/skills/security/case-management/SKILL.md) | Crea, busca, actualiza y gestiona casos de SOC mediante la API de Kibana Cases. Úsalo al rastrear incidentes, vincular alertas a casos, añadir notas de investigación o gestionar la salida del triaje. | 0.1.0 | elastic | | [security-detection-rule-management](https://github.com/elastic/agent-skills/blob/main/skills/security/detection-rule-management/SKILL.md) | Crea, ajusta y gestiona reglas de detección de Elastic Security (SIEM y Endpoint). Úsalo para falsos positivos, excepciones, nueva cobertura, reglas ruidosas o gestión de reglas mediante la API de Kibana. | 0.1.0 | elastic | | [security-generate-security-sample-data](https://github.com/elastic/agent-skills/blob/main/skills/security/generate-security-sample-data/SKILL.md) | Genera eventos de seguridad de muestra, escenarios de ataque y alertas sintéticas para Elastic Security. Úsalo al hacer demostraciones, poblar paneles, probar reglas de detección o configurar una POC. | 0.1.0 | elastic | | [security-ml-integrations](https://github.com/elastic/agent-skills/blob/main/skills/security/ml-integrations/SKILL.md) | Instala y gestiona paquetes de integración de ML de seguridad de Elastic (beaconing, ded, dga, lmd, pad, problemchild). Gestiona el ciclo de vida completo: comprobaciones previas, instalación del paquete de Fleet, plantillas de componentes, pipelines de ingesta, transformaciones, vistas de datos, trabajos de detección de anomalías de ML y reglas de detección. Úsalo cuando un usuario solicite instalar, configurar, comprobar el estado o solucionar problemas de un paquete de integración de ML de seguridad. | 0.1.0 | elastic | </details> <!-- END-SKILL-TABLE --> ## Consideraciones de seguridad Los agentes de codificación de IA operan con credenciales reales, acceso real al 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 el riesgo antes de empezar. - **Realice su propio modelado de amenazas.** Evalúe a qué datos puede acceder el agente, qué acciones puede realizar y qué sucede si se comporta de forma inesperada. [La guía conjunta de CISA sobre la implementación segura de sistemas de IA](https://www.cisa.gov/news-events/alerts/2024/04/15/joint-guidance-deploying-ai-systems-securely) es un buen punto de partida. - **Sea 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. Involucre a sus 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 el contenido de archivos contienen con frecuencia cadenas elaboradas por atacantes. La inyección de prompts no es teórica aquí; es una propiedad inherente del entorno operativo. Investigaciones como [Brainworm](https://www.originhq.com/blog/brainworm) demuestran que los archivos de contexto del agente por sí solos pueden servir como mecanismo de persistencia para promptware. - **Limite los privilegios de forma estricta.** Otorgue a las claves de API los privilegios mínimos necesarios. Los privilegios amplios de respuesta son especialmente peligrosos. El acceso de solo lectura es un buen valor predeterminado hasta que haya validado el comportamiento. - **Restrinja el acceso a las herramientas del agente y el alcance de red.** La mayoría de los agentes de codificación con IA se distribuyen 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 puede hacer un agente comprometido o mal dirigido. - **Comience en entornos que no sean de producción.** Utilice un proyecto de prueba de Serverless, un clúster de desarrollo o un espacio de Kibana aislado para evaluar las habilidades antes de conectarlas a cualquier cosa que contenga datos de seguridad en vivo. Estas habilidades son de código abierto precisamente para que pueda auditar lo que hacen. Le animamos a leerlas antes de ejecutarlas. ## Primeros pasos Puede instalar las habilidades de Elastic mediante el sistema nativo de plugins 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 su entorno. > [!TIP] > **No instale todas las habilidades.** Cada habilidad instalada añade contexto de enrutamiento que su agente evalúa en cada solicitud. Instale las habilidades de autenticación **cloud** y **elasticsearch** — la mayoría de las demás habilidades dependen de ellas — y luego añada solo las habilidades relevantes para su flujo de trabajo. Mantener el conjunto instalado enfocado evita la sobrecarga de contexto y ayuda al agente a enrutar a la habilidad correcta de forma fiable. ### Complemento de Claude Code (recomendado para usuarios de Claude Code) Claude Code tiene un sistema nativo de plugins que gestiona las habilidades directamente. Comience añadiendo este repositorio como fuente de marketplace: ```sh claude plugin marketplace add https://github.com/elastic/agent-skills ``` Una vez añadidos, instala los plugins individuales por nombre: ```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] > 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 cargar los plugins recién instalados. O utiliza el navegador de plugins interactivo 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ñadidos, instala los plugins 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 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`](https://github.com/vercel-labs/skills). No es necesario clonar este repositorio — solo ejecuta: ```sh npx skills add elastic/agent-skills ``` Esto inicia un prompt interactivo para seleccionar skills y [agentes de destino](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents). La CLI copia cada carpeta de skill en la ubicación correcta para que el agente la descubra. Instala un skill específico 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 ``` Instalar todas las habilidades en todos los agentes (no interactivo): ```sh npx skills add elastic/agent-skills --all ``` | Flag | Descripción | | ----------------- | ------------------------------------------------- | | `-a, --agent` | Dirigirse a agentes específicos (ver [Supported agents](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)) | | `-s, --skill` | Instalar habilidades específicas por nombre | | `-g, --global` | Instalar en el directorio home del usuario en lugar del directorio del proyecto | | `-y, --yes` | Omitir las solicitudes de confirmación | | `--all` | Instalar todas las habilidades en todos los agentes sin solicitudes | | `--list` | Listar las habilidades disponibles sin instalarlas | ### Clonación 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 <agent> ``` El script requiere bash 3.2+ y utilidades Unix estándar (`awk`, `find`, `cp`, `rm`, `mkdir`). | Flag | Descripción | | ----------------- | ------------------------------------- | | `-a, --agent` | Agente de destino (repetible) | | `-s, --skill` | Instalar habilidades específicas por nombre | | `-f, --force` | Sobrescribir habilidades ya instaladas | | `-y, --yes` | Omitir las solicitudes de confirmación | Listar todas las habilidades disponibles: ```sh ./scripts/install-skills.sh list ``` ### Agentes compatibles | Agente | Directorio de instalación | | --------------- | ------------------------- | | 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` | ## Actualización de skills El proceso de actualización depende de cómo se instalaron las 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, habilita 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 iniciarse 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 origen: ```sh npx skills check ``` Extrae las últimas versiones de todas las habilidades instaladas: ```sh npx skills update ``` La CLI rastrea el repositorio de origen de cada skill y un hash de contenido en un archivo de bloqueo. `check` compara tus hashes locales con GitHub; `update` vuelve a descargar todo lo que haya cambiado. > **Consejo:** La instalación predeterminada mediante npx utiliza 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 skills existentes: ```sh git pull ./scripts/install-skills.sh add -a <agent> --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 entornos de ejecución de agentes lo leen para decidir cuándo cargar una skill. Para consultar la especificación completa del formato, véase [agentskills.io/specification](https://agentskills.io/specification). ## Problemas ¿Ha encontrado un problema o tiene alguna sugerencia? [Abra un issue](https://github.com/elastic/agent-skills/issues/new) y lo revisaremos. ## Aviso legal Estas skills se proporcionan tal cual. Pruebe siempre las skills a fondo en su propio entorno antes de depender de ellas para tareas críticas.