# Complementos para GitHub Copilot

Los complementos son paquetes instalables que amplían Copilot con agentes reutilizables, habilidades, ganchos e integraciones.

Los complementos le permiten instalar personalizaciones relacionadas juntas en lugar de configurar cada una por separado. Por ejemplo, un complemento de prueba podría combinar una aptitud para ejecutar pruebas, un agente de revisión y un servidor MCP para un servicio de informes de pruebas.

## Dónde puede usar complementos

Puede usar complementos en:

* El GitHub Copilot app.
* GitHub Copilot CLI.
* Copilot cloud agent.
* Visual Studio Code. Para ver los componentes y la instalación admitidos, consulte [Complementos del agente en VS Code](https://code.visualstudio.com/docs/agent-customization/agent-plugins).

Un complemento puede contener componentes que solo funcionan en una surface determinada. Compruebe que el complemento admite la superficie que usa. Por ejemplo, la configuración del servidor LSP descrita en esta categoría es para Copilot CLI.

En los ejemplos de directorios y rutas de acceso de componente siguientes se describen los formatos de complemento para Copilot CLI. Otras superficies pueden admitir diferentes componentes.

## Qué complementos contienen

Un complemento puede contener algunos o todos los componentes siguientes. Las ubicaciones de estos componentes dependen del formato del complemento:

* **Agentes personalizados** : asistentes especializados de IA (`*.agent.md` archivos en `agents/`)
* **Skills** — instrucciones, scripts y recursos específicos de tareas (subdirectorios de skills en `skills/`, que contienen un archivo `SKILL.md`)
* **Hooks** — controladores de eventos que interceptan el comportamiento del agente (un archivo `hooks.json` en el directorio raíz del plugin o en `hooks/`)
* **Extensiones** : código que agrega funcionalidades como herramientas y comandos slash en superficies compatibles
* **Configuraciones del servidor MCP** — integraciones del Protocolo de Contexto de Modelo
* **Configuraciones del servidor LSP** — integraciones del Language Server Protocol (un `lsp.json` archivo en la raíz del complemento, o en `.github/`)

## Formatos de complementos

Copilot admite dos formatos de complemento:

* **Agent Plugins 1.0** es un formato portátil para compartir aptitudes y configuraciones de servidor MCP en clientes compatibles. Para usar este formato, establezca `$schema` en `plugin.json``https://agent-plugins.org/schemas/1.0.0/plugin.schema.json`. Las aptitudes se detectan desde `skills/`y la configuración del servidor MCP se detecta desde `mcp.json` en la raíz del complemento. Estas ubicaciones no se pueden configurar en el manifiesto. Elija Agent Plugins 1.0 cuando quiera hacer portátiles las habilidades y los servidores MCP.
* **Los complementos heredados Copilot** no declaran los complementos `$schema`del agente . Usan los campos de manifiesto existentes y el comportamiento de detección de componentes, incluidas las rutas de componentes configurables y la configuración de MCP en `.mcp.json`, `.github/mcp.json` o en el campo de manifiesto `mcpServers`. Elija el formato heredado cuando necesite rutas de componentes configurables o esté manteniendo un plugin Copilot-específico existente.

Para un nuevo complemento, use Agent Plugins 1.0, a menos que necesite rutas de componentes configurables. Use el formato heredado principalmente para complementos heredados existentes.

Se admiten ambos formatos. Agregar `$schema` cambia la forma en que Copilot interpreta el manifiesto y detecta componentes. Los complementos sin `$schema` seguirán cargándose como complementos heredados.

## Cómo se estructuran los complementos

Un complemento es un directorio con una estructura específica y un `plugin.json` archivo de manifiesto. Agent Plugins 1.0 requiere el manifiesto en la raíz del complemento. Los complementos heredados admiten ubicaciones de manifiesto adicionales. El manifiesto proporciona al complemento un nombre y metadatos. Según el formato, también puede apuntar a componentes. Junto con el manifiesto, el directorio puede contener agentes, aptitudes, enlaces, configuraciones de servidor MCP y configuraciones de servidor LSP.

### Estructura de complementos de agente 1.0

Los complementos de agente 1.0 almacenan aptitudes y servidores MCP en ubicaciones estándar para que los clientes compatibles puedan detectarlos. Otros componentes, incluidos agentes, enlaces, comandos y servidores LSP, son específicos del cliente.
Copilot lee estos componentes desde el `com.github.copilot` directorio . Otros clientes omiten este directorio, por lo que el mismo complemento puede combinar aptitudes compartidas y servidores MCP con Copilotcomponentes específicos.

Un directorio de Complementos de agente 1.0 puede tener este aspecto:

```text
my-plugin/
├── plugin.json               # Required manifest
├── skills/                   # Skills (optional)
│   └── deploy/
│       └── SKILL.md
├── mcp.json                  # MCP server config (optional)
└── com.github.copilot/       # Copilot components (optional)
    ├── agents/
    │   └── helper.agent.md
    ├── commands/
    ├── rules/
    ├── hooks/
    │   └── hooks.json
    └── lsp.json
```

El manifiesto debe incluir Agent Plugins 1.0 `$schema`. Para conocer los campos de manifiesto de nivel superior admitidos, los requisitos de nombre y las ubicaciones de los [componentes, consulte Campos de manifiesto de complementos del agente 1.0](/es/copilot/reference/copilot-cli-reference/cli-plugin-reference#agent-plugins-10-manifest-fields).

### Estructura heredada del complemento

Un directorio de complementos heredado Copilot puede tener este aspecto:

```text
my-plugin/
├── plugin.json           # Required manifest
├── agents/               # Custom agents (optional)
│   └── helper.agent.md
├── skills/               # Skills (optional)
│   └── deploy/
│       └── SKILL.md
├── hooks.json            # Hook configuration (optional)
├── .mcp.json             # MCP server config (optional)
└── lsp.json              # LSP server config (optional)
```

Para obtener el conjunto completo de campos que puede incluir en el manifiesto, consulte [Referencia del plugin CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-plugin-reference). Para obtener instrucciones paso a paso sobre cómo crear un complemento, consulte [Creación de un complemento para GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating).

## ¿Por qué usar complementos?

Los complementos proporcionan las siguientes ventajas:

* Reutilización entre proyectos
* Estandarización de la configuración de Copilot del equipo
* Comparta conocimientos sobre dominios (por ejemplo, proporcionando las aptitudes de un experto de Rails o un experto de Kubernetes)
* Encapsular configuraciones complejas del servidor MCP

## ¿Dónde puedo obtener complementos?

Puede instalar complementos desde:

* Un marketplace
* Un repositorio
* Ruta de acceso local

Un marketplace es una ubicación en la que los desarrolladores pueden publicar, detectar, instalar y administrar complementos. Es un poco como una tienda de aplicaciones, pero para complementos.

Entre los ejemplos de marketplace se incluyen:

* [copilot-plugins](https://github.com/github/copilot-plugins) (agregado por defecto)
* [awesome-copilot](https://github.com/github/awesome-copilot) (agregado de forma predeterminada)
* [claude-code-plugins](https://github.com/anthropics/claude-code)
* [claudeforge-marketplace](https://github.com/claudeforge/marketplace)

La forma de instalar un complemento depende del cliente que use:

* En Copilot CLI, puede instalar complementos mediante el comando `copilot plugin install` o el comando con barra `/plugin install`, o agregando el complemento al campo `enabledPlugins` de un archivo de nivel `~/.copilot/settings.json` de usuario o un archivo de nivel `.github/copilot/settings.json` de repositorio. Consulte [Búsqueda e instalación de complementos para GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing).
* En Copilot cloud agent, los complementos se instalan agregándolos al campo `enabledPlugins` del archivo `.github/copilot/settings.json` del repositorio. Para instalar complementos desde un marketplace que no está registrado de manera predeterminada, también puede añadir el marketplace al campo `extraKnownMarketplaces` en el mismo archivo.
* GitHub Copilot appEn , haga clic en **Personalizar** y, a continuación, haga clic en **Complementos** para examinar marketplaces e instalar complementos.
* En Visual Studio Code, use los comandos de Marketplace del complemento descritos en la VS Code documentación vinculada anteriormente.

Los administradores de empresa pueden definir estándares de complementos que se aplican a los usuarios en el plan de Copilot la empresa, incluida la especificación de complementos y marketplaces adicionales que se instalan automáticamente. Consulte [Acerca de los estándares de complementos administrados por la empresa](/es/copilot/concepts/enterprise/plugin-standards).

## Funcionamiento de los marketplaces de complementos

Una tienda de complementos es un catálogo de complementos donde puede explorar e instalar complementos. Un marketplace se puede hospedar en un repositorio en GitHub.com, en cualquier otro servicio de hospedaje de Git en línea o en el sistema de archivos local o compartido.

Un marketplace se define mediante un `marketplace.json` archivo, que proporciona metadatos sobre Marketplace y enumera los complementos que pone a disposición. Cada entrada de la matriz de `plugins` Marketplace describe un complemento, incluido su nombre, descripción, versión y la ruta de acceso al directorio del complemento.

Dado que los complementos de un marketplace tienen versiones, los marketplaces facilitan la detección, instalación y actualización de complementos y compartirlos en un equipo. Para obtener instrucciones paso a paso sobre cómo crear un marketplace, consulte [Creating and sharing a plugin marketplace on GitHub](/es/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace).

## Plugins en comparación con la configuración manual

Cualquier funcionalidad que pueda agregar con un complemento, también puede agregar mediante la Copilot configuración manual, por ejemplo, agregando perfiles de agente personalizados o servidores MCP. Sin embargo, los complementos proporcionan varias ventajas sobre la configuración manual:

| Feature              | Configuración manual en un repositorio | Plugin                                            |
| -------------------- | -------------------------------------- | ------------------------------------------------- |
| Ámbito               | Repositorio único                      | Cualquier proyecto                                |
| Sharing              | Copiar y pegar manualmente             | Comando de instalación o `enabledPlugins` entrada |
| Control de versiones | Historial de Git                       | Versiones de Marketplace                          |
| Discovery            | Búsqueda de repositorios               | Exploración de Marketplace                        |

## Lectura adicional

* [Extensiones para GitHub Copilot](/es/copilot/concepts/customizations/extensions)
* [Aptitudes del agente](/es/copilot/concepts/agents/about-agent-skills)
* [Hooks para GitHub Copilot](/es/copilot/concepts/agents/hooks)
* [Agentes personalizados](/es/copilot/concepts/customizations/custom-agents)