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

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