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

Leitura adicional

• Sobre as habilidades do agente
• Sobre ganchos para GitHub Copilot
• Sobre agentes personalizados