Sobre GitHub Copilot plug-ins

Os plug-ins fornecem uma maneira de distribuir a funcionalidade personalizada Copilot . Você pode usar um plug-in para adicionar um conjunto pré-configurado de recursos a Copilot, incluindo CLI do Copilot e agente de nuvem Copilot.

O que é um plug-in?

Um pacote distribuível que estende a funcionalidade de Copilot.
Um pacote de componentes em uma única unidade instalável.

O que os plug-ins contêm

Um plug-in pode conter alguns ou todos os seguintes componentes:

Agentes personalizados – assistentes de IA especializados (*.agent.md arquivos em agents/)
Habilidades – funcionalidades discretas que podem ser chamadas (subdiretórios de habilidades skills/, contendo um SKILL.md arquivo)
Ganchos – manipuladores de eventos que interceptam o comportamento do agente (um hooks.json arquivo no diretório raiz do plug-in ou em hooks/)
Configurações do servidor MCP — integrações do Protocolo de Contexto de Modelo (um .mcp.json arquivo na raiz do plug-in ou um mcp.json arquivo em .github/)
Configurações do servidor LSP – integrações do Protocolo do Servidor de Idiomas (um lsp.json arquivo na raiz do plug-in ou em .github/)

Como os plug-ins são estruturados

Um plug-in é um diretório com uma estrutura específica. No mínimo, ele contém um plugin.json arquivo de manifesto na raiz do diretório. O manifesto fornece um nome ao plug-in e aponta para os componentes fornecidos pelo plug-in. Junto com o manifesto, o diretório pode conter qualquer combinação de agentes, habilidades, ganchos, configurações de servidor MCP e configurações de servidor LSP.

Um diretório de plug-in típico tem esta aparência:

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 obter o conjunto completo de campos que você pode incluir no manifesto, consulte referência de plugin da CLI GitHub Copilot. Para obter orientações passo a passo sobre como criar um plug-in, consulte Criando um plug-in para CLI do GitHub Copilot.

Por que usar plug-ins?

Os plug-ins oferecem os seguintes benefícios:

Reutilização entre projetos
Padronização da configuração da equipe Copilot
Compartilhar conhecimentos de domínio (por exemplo, fornecendo as habilidades de um especialista em Rails ou um especialista em Kubernetes)
Encapsular configurações complexas do servidor MCP

Onde posso obter plug-ins?

Você pode instalar plug-ins de:

Um mercado online
Um repositório
Um caminho local

Um marketplace é um local onde os desenvolvedores podem publicar, descobrir, instalar e gerenciar plug-ins. É um pouco como uma loja de aplicativos, mas para plug-ins.

Exemplos de marketplaces incluem:

copilot-plugins (adicionados por padrão)
awesome-copilot (adicionado por padrão)
claude-code-plugins
claudeforge-marketplace

Como você instala um plug-in depende de qual cliente você está usando:

Em CLI do Copilot, você pode instalar plug-ins de forma imperativa usando o comando copilot plugin install ou o comando de barra /plugin install, ou de forma declarativa adicionando o plug-in ao campo enabledPlugins de um arquivo ~/.copilot/settings.json no nível do usuário ou de um arquivo .github/copilot/settings.json no nível do repositório. Consulte Localizando e instalando plug-ins para CLI do GitHub Copilot.
No agente de nuvem Copilot, você instala plugins declarativamente ao adicioná-los ao campo enabledPlugins do arquivo .github/copilot/settings.json do repositório. Para instalar plug-ins de um marketplace que não está registrado por padrão, você também pode adicionar o marketplace ao extraKnownMarketplaces campo no mesmo arquivo.

Os administradores corporativos podem definir padrões de plug-in que se aplicam aos usuários no plano da Copilot empresa, incluindo a especificação de marketplaces e plug-ins adicionais que são instalados automaticamente. Consulte Sobre os padrões de plug-in gerenciados pela empresa.

Como funcionam os marketplaces de plug-in

Um marketplace de plug-ins é um registro de plug-ins dos quais você pode navegar e instalar. Um marketplace pode ser hospedado em um repositório no GitHub.com, em qualquer outro serviço online de hospedagem Git ou no seu sistema de arquivos local ou compartilhado.

Um marketplace é definido por um marketplace.json arquivo, que fornece metadados sobre o marketplace e lista os plug-ins que ele disponibiliza. Cada entrada na matriz do plugins marketplace descreve um plug-in, incluindo seu nome, descrição, versão e o caminho para o diretório do plug-in.

Como os plug-ins em um marketplace são versionados, os marketplaces facilitam descobrir, instalar e atualizar plug-ins, além de compartilhá-los com uma equipe. Para obter orientações passo a passo sobre como criar um marketplace, consulte Criando um marketplace de plugin para CLI do GitHub Copilot.

Plug-ins comparados com a configuração manual

Qualquer funcionalidade que você possa adicionar com um plug-in, você também pode adicionar configurando Copilot manualmente, por exemplo, adicionando perfis de agente personalizados ou servidores MCP. No entanto, os plug-ins fornecem várias vantagens em relação à configuração manual:

Característica	Configuração manual em um repositório	Plug-in
Scope	Repositório único	Qualquer projeto
Sharing	Copiar/colar manualmente	Comando de instalação ou entrada `enabledPlugins`
Versioning	Histórico do Git	Versões do Marketplace
Discovery	Pesquisando repositórios	Navegação no Marketplace

Quem pode usar esse recurso?

Neste artigo