Notion lança API para equipes compartilharem instruções entre agentes

O problema: habilidades presas em repositórios de engenharia

A Notion defende que times modernos precisam de uma biblioteca de skills compartilhada - instruções que tornam agentes de IA mais capazes e adaptados aos fluxos de trabalho. Quando essas habilidades ficam em repositórios como GitHub, apenas engenheiros conseguem editá-las ou acessá-las, o que limita o benefício coletivo.

Para a empresa, uma biblioteca de skills deve atender a quatro requisitos: ser utilizável por todo o time (vendas, marketing, finanças, operações), ser neutra em relação ao agente (disponível em qualquer ferramenta, não presa a uma só), ser colaborativa (sugestões, permissões e histórico de versões) e ser observável e governável (métricas de uso e controle de quais skills chegam a quais usuários).

A Skills API

A resposta da Notion é a Skills API: um conjunto de endpoints para carregar skills da Notion em formatos compatíveis com especificações abertas. Como a API retorna arquivos em formatos padronizados, ferramentas de terceiros não precisam lidar com formatos proprietários da Notion.

No Notion, as skills são editadas como páginas comuns e organizadas em databases, com suporte a pastas de arquivos de apoio (assets e código), permissões, edições sugeridas e analíticas. Nima Gardideh, CEO da Pearmill, cliente citada no anúncio, relata que a equipe passou a compartilhar skills várias vezes por semana entre marketing, design e operações.

Casos de uso no lançamento

Sincronização com o GitHub: equipes podem manter a Notion como casa colaborativa das skills e sincronizá-las para repositórios, de onde apps como Claude, ChatGPT e Grok Bot as consomem. Uma vez sincronizadas, as skills suportam recursos nativos desses apps, como invocação pelo menu de barra e controles de instalação de administrador. Também é possível criar e editar skills na Notion a partir dos próprios apps de agente via ferramentas MCP, fechando um ciclo de melhoria contínua baseado no uso real.

A Notion está disponibilizando um starter kit de código aberto para times de TI configurarem essa sincronização, que também serve de exemplo para integrações com qualquer agente ou ferramenta interna.

Suporte de terceiros: a Vercel adicionou suporte à Notion em sua CLI de skills, uma das ferramentas mais populares para instalar skills. É possível rodar npx skills add <url da Notion> para instalar uma página marcada como skill ou npx skills add notion para instalar plugins interativamente a partir do workspace. A CLI é open source e funciona como referência de integração com a API.

Depoimentos de clientes reforçam o argumento: Hillary Helmling, da Candidly, diz que documentar skills na Notion aumenta a visibilidade do que está disponível e apoia o uso com o Claude; Josh Reid, da Brainlabs, explica que skills não podem ficar apenas no GitHub porque nem todo criador de skill é desenvolvedor.

Conclusão

A Notion posiciona sua skills library como infraestrutura compartilhada por todos os agentes do time, e a API como o passo para torná-la acessível ondequer que a equipe trabalhe. Interessados podem consultar a documentação da Agent Skills API e a página sobre skills do agente da Notion no Help Center.