Skip to main content
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.
AGENTS.md

​
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.
CLAUDE.md
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.