> ## Documentation Index
> Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> Crie pacotes reutilizáveis para agentes externos e Automations

Skills são pacotes reutilizáveis de instruções e arquivos de apoio opcionais. Elas permitem que sua equipe defina uma única vez uma forma repetível de concluir uma tarefa e depois a aplique de maneira consistente em todo o Flowglad.

Cada Skill tem um nome, um slug de comando de barra, uma descrição e instruções escritas em Markdown. Arquivos de apoio podem fornecer contexto adicional ou recursos necessários para seguir essas instruções.

## Use o Flowglad como a biblioteca de Skills da sua equipe

O Flowglad mantém cada Skill como um pacote versionado. Publicar uma alteração cria uma nova revisão em vez de substituir o pacote anterior no lugar. Admins da organização podem abrir o **History** de uma Skill para inspecionar suas revisões, comparar alterações, restaurar uma revisão anterior ou descartar um rascunho quando essas ações estiverem disponíveis.

Isso dá à sua equipe um único local governado para manter instruções reutilizáveis, preservando qual versão estava ativa em um determinado momento. Revisões em rascunho e rejeitadas não substituem a versão ativa.

### Gerencie Skills pelo MCP

Depois de conectar o servidor MCP do Flowglad, um agente pode inspecionar e gerenciar a biblioteca de Skills da sua organização por você:

* `skills.list` retorna as Skills visíveis para a conexão.
* `skills.get` retorna os metadados da revisão mais recente e da revisão ativa de uma Skill.
* `skills.create` envia um novo pacote de Skill.
* `skills.create_candidate` envia uma nova revisão de uma Skill existente.
* `skills.publish_revision` verifica e publica uma revisão adiada.
* `skills.create_package_upload_session` e `skills.finalize_package_upload_session` transportam pacotes grandes demais para serem enviados inline.
* `skills.get` informa o resultado da verificação e da promoção da solicitação aceita.

Criar ou atualizar Skills exige a permissão `skills:write` tanto na membership do colega na organização quanto no grant da conexão MCP. Se você adicionar a permissão depois de conectar o servidor, reconecte o Flowglad MCP e autorize `skills:write` para que as ferramentas de escrita fiquem disponíveis.

**Permissões:** Admins têm acesso de autoria de Skills por padrão. Para dar o mesmo acesso a um Contributor, abra **Settings** → **Team**, selecione o colega e ative **Skill Authoring**. Isso concede permissão para criar e atualizar Skills da organização sem tornar o colega um admin.

## Carregue as Skills do Flowglad MCP no seu agente

O servidor MCP do Flowglad anuncia `io.modelcontextprotocol/skills` durante a inicialização do MCP. Isso informa aos clientes compatíveis que o servidor implementa os métodos de Skill para agentes `skills/list` e `skills/get`. Cada Skill retornada inclui URIs de recurso `skill://` e digests de conteúdo; os clientes podem recuperar os arquivos com `resources/read`.

Conectar o servidor não garante que um cliente chamará `skills/list` ou instalará os pacotes retornados. O suporte varia entre clientes. Adicione uma instrução de inicialização ao ChatGPT / Codex ou ao Claude quando quiser que o agente atualize o registro do Flowglad no início de cada sessão.

**Nomenclatura do MCP:** Os nomes são intencionalmente diferentes. `skills.list`, com ponto, é uma ferramenta do Flowglad para os registros versionados de Skills da sua organização. `skills/list`, com barra, é um método de extensão do protocolo MCP para descobrir pacotes de Skill voltados a agentes.

### Adicione a instrução de inicialização

Crie o diretório de destino uma vez antes de iniciar uma nova sessão e depois adicione o bloco de instruções correspondente abaixo.

#### ChatGPT / Codex

Crie o diretório de destino do ChatGPT / Codex com `mkdir -p ~/.agents/skills`.

Coloque o bloco a seguir em `~/.codex/AGENTS.md` para aplicá-lo a todos os projetos, ou no `AGENTS.md` de um repositório para compartilhá-lo com a equipe desse repositório.

```markdown AGENTS.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.agents/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `$skill-name` invocation.
6. If this ChatGPT / Codex client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

#### Claude

Crie o diretório de destino do Claude com `mkdir -p ~/.claude/skills`.

Coloque o bloco a seguir em `~/.claude/CLAUDE.md` para aplicá-lo a todos os projetos, ou no `CLAUDE.md` de um repositório para compartilhá-lo com a equipe desse repositório.

```markdown CLAUDE.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.claude/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `/skill-name` invocation.
6. If this Claude client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

Você pode pedir ao ChatGPT / Codex ou ao Claude que adicione o bloco apropriado ao seu próprio arquivo de instruções de nível de usuário. Revise a edição proposta antes de aceitá-la, pois esse arquivo afeta sessões futuras. A instrução é um bootstrap de agente em regime de melhor esforço; se o seu ambiente precisar atualizar as Skills de forma determinística, implemente a mesma sincronização em um hook `SessionStart` confiável ou na integração do seu cliente MCP.

## Onde as Skills são usadas

As Skills têm atualmente dois consumidores:

* Agentes externos compatíveis descobrem e sincronizam pacotes ativados pelo Flowglad MCP e depois os correspondem automaticamente ou os invocam pelo nome.
* Automations fixam uma revisão publicada exata de uma Skill como um recurso de código OWS `skill-revision`. A Automation seleciona um caminho de pacote e um entrypoint; as etapas de agente recebem apenas as Skills autorizadas pelo conjunto selado de capacidades da execução.

O primeiro caminho fornece instruções reutilizáveis a um agente externo. O segundo fornece código imutável e arquivos de apoio a uma execução repetível de Automation. Skills publicadas valem para toda a organização, então uma Automation autorizada pode selecionar a mesma revisão de Skill em qualquer Space. A Automation consumidora e suas execuções continuam pertencendo ao seu Space; selecionar uma Skill não altera esse limite.

## Criação e manutenção de Skills

Abra o **menu da organização** → **Skills** → **New Skill**. Na aba **Skill**, informe **Name**, **Slug**, uma **Description** opcional e as instruções reutilizáveis em **Markdown**. Use a aba **Files** para quaisquer arquivos de apoio do pacote e depois selecione **Create Skill**.

O Slug usa letras minúsculas, números e hifens, começa com uma letra ou um número e é o que os usuários digitam depois de `/`.

Criar ou editar uma Skill produz um rascunho. Na página de detalhes da Skill, as edições são salvas automaticamente; selecione **Publish Draft** para verificar e publicar o rascunho. Se a verificação falhar, use os diagnósticos exibidos para corrigir o rascunho e publique novamente.

Use **History** para inspecionar revisões, restaurar uma revisão substituída ou descartar um rascunho mutável quando essas ações estiverem disponíveis. **Disable Skill** a remove da descoberta por agentes externos e da resolução em Automations sem excluir o histórico de revisões; **Enable Skill** a torna disponível novamente.

## Crie ou edite uma Skill com MCP

Use um cliente MCP externo conectado para autoria orientada a pacotes. Chame `skills.get` antes de editar uma Skill existente. Use `skills.create` para um novo pacote ou `skills.create_candidate` para uma revisão baseada na revisão ativa atual.

Pacotes pequenos podem ser fornecidos inline. Para pacotes maiores, chame `skills.create_package_upload_session`, faça upload dos objetos solicitados e finalize com `skills.finalize_package_upload_session`. Se a verificação tiver sido adiada, chame `skills.publish_revision`. Consulte periodicamente `skills.get` para acompanhar a solicitação de ciclo de vida aceita e o resultado de sua verificação ou promoção.

Publicar uma Skill não cria, revisa nem ativa uma Automation; use explicitamente o ciclo de vida de Automation do MCP quando necessário.

## Comece a partir de um template de Skill

A página **Skills** inclui **Skill Templates**. Pesquise ou filtre o catálogo, visualize um template e selecione **Copy Skill**. A cópia se torna uma Skill da organização que pode ser editada e publicada como qualquer outra Skill.

## Skills e Automations

Uma Skill define como realizar um trabalho reutilizável. Ela não decide quando esse trabalho é executado.

Use uma Automation quando o trabalho precisar ser executado manualmente, em um agendamento ou em resposta a um evento. Uma Automation pode fixar uma ou mais revisões de Skill para que a mesma implementação seja reutilizada entre execuções.


## Related topics

- [MCP](/docs/pt-BR/mcp-server.md)
- [Automations](/docs/pt-BR/automations.md)
- [Boas-vindas](/docs/pt-BR/agents/introduction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.