Información sobre GitHub Copilot complementos

Los complementos proporcionan una manera de distribuir la funcionalidad personalizada Copilot . Puede usar un complemento para agregar un conjunto preconfigurado de funcionalidades a Copilot, incluidos Copilot CLI, Copilot cloud agenty .GitHub Copilot app

¿Qué es un complemento?

Un paquete distribuible que extiende la funcionalidad de Copilot.
Una agrupación de componentes en una sola unidad instalable.

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/)
Aptitudes : funcionalidades discretas que se pueden llamar (subdirectorios de aptitudes en skills/, que contienen un SKILL.md archivo)
Hooks — controladores de eventos que interceptan el comportamiento del agente (un archivo hooks.json en el directorio raíz del plugin o en hooks/)
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 $schemadel 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:

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.

Estructura heredada del complemento

Un directorio de complementos heredado Copilot puede tener este aspecto:

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. Para obtener instrucciones paso a paso sobre cómo crear un complemento, consulte Creación de un complemento para GitHub Copilot CLI.

¿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 (agregado por defecto)
awesome-copilot (agregado de forma predeterminada)
claude-code-plugins
claudeforge-marketplace

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

En Copilot CLI, puedes instalar complementos de forma imperativa con el comando copilot plugin install o con el comando con barra /plugin install, o de forma declarativa, añadiendo el complemento al campo enabledPlugins de un archivo ~/.copilot/settings.json a nivel de usuario o de un archivo .github/copilot/settings.json a nivel de repositorio. Consulte Búsqueda e instalación de complementos para GitHub Copilot CLI.
En Copilot cloud agent, los complementos se instalan mediante declaración agregándolos al enabledPlugins campo del archivo del .github/copilot/settings.json 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.
En el GitHub Copilot app, haz clic en Personalizar y, a continuación, en Complementos para explorar los mercados e instalar complementos.

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.

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 Creación de un marketplace de complementos para GitHub Copilot CLI.

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
Versioning	Historial de Git	Versiones de Marketplace
Discovery	Búsqueda de repositorios	Exploración de Marketplace

¿Quién puede utilizar esta característica?

En este artículo