> ## 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

As Skills são pacotes reutilizáveis de instruções e ficheiros de suporte opcionais. Permitem que a sua equipa defina uma única vez uma forma repetível de concluir uma tarefa e a aplique depois de forma consistente em todo o Flowglad.

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

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

O Flowglad guarda cada Skill como um pacote com versões. Publicar uma alteração cria uma nova revisão em vez de substituir o pacote anterior. Os administradores da organização podem abrir o **History** de uma Skill para inspecionar as suas revisões, comparar alterações, restaurar uma revisão anterior ou descartar um rascunho, quando essas ações estiverem disponíveis.

Isto dá à sua equipa um único local governado para manter instruções reutilizáveis, preservando qual a versão ativa num determinado momento. As revisões em rascunho e rejeitadas não substituem a versão ativa.

### Gerir Skills através de MCP

Depois de ligar o servidor MCP do Flowglad, um agente pode inspecionar e gerir a biblioteca de Skills da sua organização por si:

* `skills.list` devolve as Skills visíveis para a ligação.
* `skills.get` devolve os metadados da revisão mais recente e da revisão ativa de uma Skill.
* `skills.create` submete um novo pacote de Skill.
* `skills.create_candidate` submete uma nova revisão de uma Skill existente.
* `skills.publish_revision` verifica e publica uma revisão diferida.
* `skills.create_package_upload_session` e `skills.finalize_package_upload_session` transportam pacotes demasiado grandes para enviar inline.
* `skills.get` indica o resultado da verificação e da promoção do pedido aceite.

Criar ou atualizar Skills requer a permissão `skills:write` tanto na membership da organização do colega como no grant da ligação MCP. Se adicionar a permissão depois de ligar o servidor, volte a ligar o Flowglad MCP e autorize `skills:write` para que as ferramentas de escrita fiquem disponíveis.

**Permissões:** Os administradores têm, por predefinição, acesso à criação de Skills. Para dar o mesmo acesso a um Contributor, abra **Settings** → **Team**, selecione o colega e ative **Skill Authoring**. Isto concede permissão para criar e atualizar Skills da organização sem tornar o colega administrador.

## Carregue as Skills do Flowglad MCP no seu agente

O servidor MCP do Flowglad anuncia `io.modelcontextprotocol/skills` durante a inicialização MCP. Isto indica aos clientes compatíveis que o servidor implementa os métodos de Skills de agente `skills/list` e `skills/get`. Cada Skill devolvida inclui URIs de recursos `skill://` e digests do conteúdo; os clientes podem obter os ficheiros com `resources/read`.

Ligar o servidor não garante que um cliente chame `skills/list` ou instale os pacotes devolvidos. O suporte varia consoante o cliente. Adicione uma instrução de arranque ao ChatGPT / Codex ou ao Claude quando quiser que o agente atualize o registo do Flowglad no início de cada sessão.

**Nomes MCP:** Os nomes são intencionalmente diferentes. `skills.list`, com ponto, é uma ferramenta do Flowglad para os registos de Skills com versões da sua organização. `skills/list`, com barra, é um método de extensão do protocolo MCP para descobrir pacotes de Skills destinados a agentes.

### Adicione a instrução de arranque

Crie o diretório de destino uma vez antes de iniciar uma nova sessão e, em seguida, 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 seguinte em `~/.codex/AGENTS.md` para o aplicar a todos os projetos, ou no `AGENTS.md` de um repositório para o partilhar com a equipa 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 seguinte em `~/.claude/CLAUDE.md` para o aplicar a todos os projetos, ou no `CLAUDE.md` de um repositório para o partilhar com a equipa 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.
```

Pode pedir ao ChatGPT / Codex ou ao Claude que adicione o bloco adequado ao seu próprio ficheiro de instruções ao nível do utilizador. Reveja a edição proposta antes de a aceitar, porque esse ficheiro afeta sessões futuras. A instrução é um bootstrap de agente em regime de melhor esforço; se o seu ambiente tiver de atualizar as Skills de forma determinística, implemente a mesma sincronização num hook `SessionStart` de confiança ou na integração do seu cliente MCP.

## Onde as Skills são usadas

As Skills têm atualmente dois consumidores:

* Os agentes externos compatíveis descobrem e sincronizam os pacotes ativados através do Flowglad MCP e, em seguida, fazem a correspondência automática ou invocam-nos pelo nome.
* As Automations fixam uma revisão publicada exata de uma Skill como um recurso de código OWS `skill-revision`. A Automation seleciona um caminho do pacote e um entrypoint; os steps 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 ficheiros de suporte a uma execução repetível de uma Automation. As Skills publicadas abrangem toda a organização, pelo que uma Automation autorizada pode selecionar a mesma revisão de Skill em qualquer Space. A Automation consumidora e as suas execuções continuam a pertencer ao respetivo Space; selecionar uma Skill não altera essa fronteira.

## Criar e manter Skills

Abra o **organization menu** → **Skills** → **New Skill**. No separador **Skill**, introduza **Name**, **Slug**, uma **Description** opcional e as instruções reutilizáveis em **Markdown**. Use o separador **Files** para quaisquer ficheiros de suporte do pacote e, em seguida, selecione **Create Skill**.

O Slug usa letras minúsculas, números e hífenes, começa por uma letra ou um número e é o que os utilizadores escrevem depois de `/`.

Criar ou editar uma Skill produz um rascunho. Na página de detalhes da Skill, as edições são guardadas automaticamente; selecione **Publish Draft** para verificar e publicar o rascunho. Se a verificação falhar, use os diagnósticos apresentados 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** remove-a da descoberta por agentes externos e da resolução por Automations sem eliminar o histórico de revisões; **Enable Skill** torna-a novamente disponível.

## Criar ou editar uma Skill com MCP

Use um cliente MCP externo ligado para a criação centrada em 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.

Os pacotes pequenos podem ser fornecidos inline. Para pacotes maiores, chame `skills.create_package_upload_session`, carregue os objetos pedidos e termine com `skills.finalize_package_upload_session`. Se a verificação tiver sido diferida, chame `skills.publish_revision`. Consulte periodicamente `skills.get` para obter o pedido de ciclo de vida aceite e o respetivo resultado de verificação ou promoção.

Publicar uma Skill não cria, revê nem ativa uma Automation; use explicitamente o ciclo de vida MCP de Automations quando for necessário.

## Começar a partir de um template de Skill

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

## Skills e Automations

Uma Skill define como executar trabalho reutilizável. Não decide quando esse trabalho é executado.

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


## Related topics

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


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