Criar e gerenciar habilidades

As habilidades se tornam mais úteis quando toda a equipe as compartilha. O Notion oferece à sua equipe uma biblioteca de habilidades compartilhada que todo agente pode usar.

• Funciona para toda a equipe. Qualquer pessoa pode escrever uma habilidade no editor do Notion, sem precisar de markdown. Os colegas de equipe podem deixar comentários e sugerir edições, e uma habilidade pode conter links para qualquer página do seu espaço de trabalho.

• Funciona com todos os agentes. Conecte um agente ao Notion uma vez e ele carregará suas habilidades em tempo real. Você também pode sincronizar habilidades com o GitHub ou baixá-las para agentes locais.

• Controles integrados. Habilidades são páginas, portanto, as permissões de página e o histórico de versões se aplicam. Administradores podem instalar habilidades para todos no espaço de trabalho, e as métricas mostram com que frequência cada habilidade é usada.

As habilidades são uma das poucas maneiras de trabalhar com a IA do Notion. Veja como cada uma se compara:

Use uma habilidade quando sua tarefa for:

• Repetível: Você ou sua equipe faz isso com frequência.

• Contextual: Deve ser executada em uma seleção ou página específica imediatamente.

• Consistente: Você quer a mesma estrutura ou qualidade sempre.

Uma boa regra: se você copiar e colar o mesmo prompt duas vezes, vale transformá-lo em uma habilidade.

• Reescritas prontas para executivos (tom, tamanho, formato).

• Transformar Anotações de reunião em itens de ação ou em um e-mail de resumo.

• Converter rascunhos em um modelo específico (Perguntas frequentes, resumo de PRD, esboço de especificações).

• Padronizar a formatação em vários documentos (marcadores, títulos, estilo).

1. Vá para Biblioteca na sua barra lateral e abra a guia Habilidades.

2. Selecione Nova habilidade.

3. O Notion cria uma nova página de habilidade particular e a abre. Escreva suas instruções e, em seguida, adicione uma Descrição que diga o que a habilidade faz e quando usá-la.

Sua Biblioteca pode ter várias guias, portanto, a guia Habilidades pode não ser a primeira que você vê. Você também pode chegar lá pelo chat do Agente do Notion digitando / para ver suas habilidades. Em seguida, selecione Ver todas as habilidades na Biblioteca.

Toda página de habilidade tem um campo Descrição e um campo Arquivos. Use Arquivos para material de apoio, como exemplos, modelos ou scripts.

De qualquer página, selecione ••• no topo, selecione Usar com IA e, em seguida, selecione Usar como habilidade de IA.

Você também pode pedir ao Agente do Notion para marcar uma página como uma habilidade para você.

As páginas de habilidade mostram controles de habilidade no topo, como a chave Ativado e Executar, para que você possa diferenciá-las de páginas comuns.

Se você já tem habilidades salvas como arquivos SKILL.md, você pode trazê-las para o Notion:

• Carregar uma habilidade: Em Biblioteca → Habilidades, selecione Mais maneiras de adicionar uma habilidade → Carregar habilidade. Você pode carregar um arquivo .md ou .zip.

• Peça ao seu agente: Quando você conecta um agente, ele oferece a opção de carregar para o Notion as habilidades que encontra no seu computador. Você também pode pedir que ele carregue uma pasta de habilidades depois.

• Transforme uma base de dados de instruções em habilidades: Saiba como transformar uma base de dados existente em uma base de dados de habilidades →

Ativar uma habilidade a torna disponível para você no Agente do Notion e em seus agentes conectados. Desativá-la a remove de ambos.

1. Acesse Biblioteca → Habilidades.

2. Ative a chave na coluna Ativar para mim ao lado da habilidade.

Para manter uma habilidade no Agente do Notion, mas fora dos seus agentes conectados, abra o menu Configurações da habilidade (o ícone de controles deslizantes ao lado da habilidade ou na parte superior da página da habilidade). Em Outros agentes, passe o mouse sobre Usar em agentes conectados e escolha Desativado.

Suas escolhas são pessoais. Elas não alteram o que outros membros veem.

Você pode executar habilidades automaticamente ou a partir do editor destacando texto, passando o cursor sobre um bloco ou digitando / próximo ao conteúdo.

No chat com o Notion Agent, digite / para ver um menu de todas as habilidades que você adicionou, ou digite / seguido pelo nome da habilidade para executar uma diretamente.

O Notion Agent pode usar suas habilidades sem que você as chame pelo nome. Descreva o que você precisa e, se uma habilidade for adequada, o Notion Agent poderá usá-la automaticamente. Veja como funciona:

• O uso automático está ativado por padrão, para que o Notion Agent possa começar a usar uma habilidade assim que ela estiver pronta.

  • Se você quiser que uma habilidade seja executada apenas quando você solicitar, abra o menu Configurações da habilidade. Em Agente do Notion, defina Usar automaticamente como Desativado.

• Uma habilidade precisa de uma descrição para ser executada automaticamente. Adicione uma no campo Descrição na parte superior da página da habilidade, ou na propriedade Descrição se a habilidade estiver em uma base de dados de habilidades.

• O Notion Agent lê a descrição para decidir se a habilidade é adequada, então mantenha-a clara e específica.

Selecione um corpo de texto e escolha uma habilidade no menu de seleção de texto.

Apenas as habilidades configuradas para aparecer em uma página aparecem nesses menus. Para alterar isso, abra o menu Configurações da habilidade na guia Habilidades da sua Biblioteca e selecione Mostrar habilidade. Suas habilidades personalizadas aparecem primeiro, seguidas pelos padrões integrados: Melhorar escrita, Revisar, Explicar e Reformatar.

No menu de barra:

• Digite /skill próximo ao conteúdo para navegar pelas suas habilidades disponíveis. O menu de barra só mostra habilidades quando há conteúdo na linha, pois uma habilidade precisa de algo para ser executada.

• No chat com o Notion Agent, você também pode digitar / seguido pelo nome da habilidade para ir direto a uma habilidade específica. Este atalho não funciona em uma página a menos que haja conteúdo ao lado dele.

No menu de bloco:

• Selecione o ícone ⁚⁚ que aparece ao passar o cursor sobre um bloco para abrir o menu do bloco.

• Selecione Habilidades.

• Escolha uma habilidade para executá-la nesse bloco.

As habilidades estão disponíveis em blocos de texto, títulos (H1, H2, H3), citações, frases de destaque, listas com marcadores, listas numeradas, tarefas, alternadores, /imagem e blocos sincronizados. As habilidades não aparecerão em blocos vazios ou tipos de bloco que não estejam nesta lista. Se você aplicar uma habilidade a um bloco que tenha conteúdo aninhado, a habilidade incluirá esse conteúdo aninhado também.

O Notion pode sugerir habilidades nas suas Anotações IA para você agir com base no que foi discutido, com um clique.

1. Abra uma anotação de reunião que esteja sendo transcrita ou uma com um resumo concluído.

2. Você verá habilidades sugeridas na anotação. Você também pode abrir o Agente do Notion pelo ícone de rosto no canto inferior da anotação para vê-las.

3. Selecione uma habilidade sugerida para executá-la, como recapitular decisões durante a reunião ou criar tarefas de acompanhamento após o término dela. Você também pode criar uma nova habilidade a partir daqui.

Você verá sugestões diferentes durante a reunião e após o término dela. Para escolher quais habilidades aparecem nas anotações de reunião, acesse Biblioteca → Habilidades, abra o menu Configurações da habilidade, selecione Mostrar habilidade e ative Durante reuniões, Após reuniões, ou as duas opções. Cada lista comporta até 12 habilidades.

Saiba mais sobre Anotações de reunião com IA →

Existem três maneiras de usar suas habilidades do Notion fora do Notion. Cada uma mantém o Notion como o local onde as habilidades são criadas e mantidas.

Agentes conectados ao Notion via MCP podem carregar suas habilidades do Notion no início de cada sessão e escolher a certa para a tarefa. Quando você edita uma habilidade no Notion, cada agente conectado recebe a atualização. Você precisa de uma conexão MCP do Notion funcional primeiro.

1. Abra Biblioteca → Habilidades.

2. Selecione Configurar no banner que diz Usar suas habilidades com agentes conectados?

3. Selecione Copiar para copiar o prompt de configuração.

4. Cole o prompt em um novo chat com seu agente e siga as instruções dele. Ele adiciona uma linha às próprias instruções para carregar suas habilidades a cada sessão e oferece a opção de enviar as habilidades que você já tem no computador.

Configure cada aplicativo de agente separadamente. Se você usa Claude e Cursor, execute o prompt de configuração em cada um.

A sincronização com o GitHub copia suas habilidades do Notion para um repositório do GitHub a cada hora. Seu administrador pode então adicionar esse repositório como um marketplace de plugins no Claude ou ChatGPTcodex, para que as habilidades apareçam para todos nesses apps. Comece com o projeto de código aberto Notion skills GitHub sync.

Envie uma cópia de uma habilidade para um agente local como Claude Code, Codex, Cursor, Gemini ou Grok Build. Isso funciona no aplicativo para computador do Notion, se o seu espaço de trabalho permitir downloads de habilidades locais.

1. Abra a página da habilidade no aplicativo para computador do Notion.

2. Abra o menu Configurações da habilidade (o ícone deslizante) na parte superior da página.

3. Em Outros agentes, selecione Baixar para agentes locais e, em seguida, escolha para onde enviar a habilidade.

O Notion salva a habilidade como um arquivo SKILL.md e pergunta antes de instalar quaisquer arquivos anexados. Quando a habilidade é alterada no Notion, a cópia baixada é marcada como desatualizada para que você saiba que deve baixá-la novamente.

Os desenvolvedores também podem listar, baixar e fazer upload de habilidades com a Agent Skills API. Consulte a documentação para desenvolvedores →

Uma base de dados de habilidades oferece à sua equipe um local para criar e gerenciar habilidades em conjunto. Cada página que você cria nela se torna uma habilidade automaticamente, e cada habilidade recebe uma propriedade de descrição. O Notion Agent lê essa descrição para decidir quando usar a habilidade por conta própria.

Uma base de dados de habilidades funciona como qualquer outra base de dados do Notion, com algumas propriedades já configuradas para você:

• Descrição diz o que a habilidade faz e quando usá-la. O Agente do Notion a lê para decidir quando a habilidade se encaixa.

• Arquivos contém material de suporte, como exemplos, documentos de referência, imagens, arquivos de dados ou scripts.

Você pode adicionar quaisquer outras propriedades com as quais sua equipe se importe, como Proprietário para mostrar quem mantém uma habilidade atualizada, ou Status para mostrar quais habilidades estão prontas para uso.

Comece com uma base de dados de habilidades compartilhada

Uma base de dados funciona bem quando o mesmo grupo usa as habilidades e as mesmas pessoas as mantêm atualizadas, porque todos sabem onde procurar primeiro. Adicione outra base de dados de equipe, ou uma particular, quando um grupo precisar de acesso diferente, proprietários diferentes ou um lugar para trabalhar em uma habilidade antes de compartilhá-la.

Base de dados vs. biblioteca

A Biblioteca de Habilidades não é uma base de dados. É uma visualização que reúne todas as habilidades às quais você tem acesso em todas as bases de dados do seu espaço de trabalho.

• Crie uma nova página, selecione base de dados e, em seguida, escolha Habilidades (ou /bdd in-line → Habilidades).

• Ou selecione + ao lado do nome de um Espaço de equipe e escolha a mesma opção.

Criá-la em um Espaço de equipe significa que sua equipe pode acessá-la imediatamente, para que você não precise movê-la ou alterar o acesso mais tarde.

1. Abra a base de dados.

2. Na barra de ferramentas da visualização, abra as configurações (ícone deslizante).

3. No painel de configurações, selecione Mais configurações → Transformar em.

4. Selecione Transformar em base de dados de habilidades.

5. Você verá uma caixa de diálogo de configuração. Escolha quais propriedades existentes associar a Descrição, Arquivos e Tags, ou mantenha as opções padrão para criar novas propriedades. Para ativar também as páginas existentes como habilidades para você, marque a caixa Habilitar habilidades para mim (ela mostra o número de páginas).

A partir de então, cada página criada na base de dados se torna uma habilidade. Isso funciona melhor quando as páginas na base de dados já explicam como uma tarefa deve ser feita, como um conjunto de playbooks ou instruções.

Se você já tem uma página que explica como realizar uma tarefa repetível, mova-a para uma base de dados de habilidades. A página se torna uma habilidade e adquire as propriedades de habilidade, incluindo Descrição.

1. Abra a página e selecione •••, depois selecione Mover para.

2. Escolha sua base de dados de habilidades.

3. Adicione uma Descrição clara para que o Agente do Notion saiba quando usá-la.

Editar uma habilidade

Você pode editar uma habilidade a partir do menu de seleção de texto ou do menu de bloco.

Para editar o conteúdo de uma habilidade a partir do menu de seleção de texto, passe o cursor sobre o nome dela e selecione o ícone de lápis. Você também pode abrir a página de uma habilidade a partir da sua Biblioteca ou da base de dados de habilidades para editá-la.

Gerenciar habilidades a partir da sua Biblioteca

1. Vá para Biblioteca na sua barra lateral e abra a guia Habilidades.

2. A partir daí, você pode visualizar suas habilidades existentes, adicionar novas habilidades e abrir qualquer página de habilidade para editá-la.

3. Para escolher onde uma habilidade aparece, abra o menu Configurações dela e selecione Mostrar habilidade. Escolha Em uma página para o editor de texto, o menu de comandos de barra e o menu de blocos, No chat para o chat do Agente do Notion e Durante reuniões ou Após reuniões para as anotações de reunião.

Gerenciar habilidades a partir do seu editor de texto

Destaque qualquer texto e selecione Gerenciar habilidades ao lado das suas habilidades no menu.

• A aba Descobrir da Biblioteca mostra páginas de habilidades que outras pessoas compartilharam com você, para que você possa navegar pelo que sua equipe criou.

• Encontrou uma que você deseja? Ative a chave na coluna Ativar para mim para adicioná-la às suas próprias habilidades.

Como as habilidades são páginas, o compartilhamento funciona da mesma forma para qualquer outra página no Notion.

• Se você compartilhar uma habilidade com alguém, essa pessoa poderá executá-la assim que tiver acesso à página da habilidade.

• Se a pessoa puder editar a página de habilidade, as edições dela mudarão a habilidade.

• Veja as habilidades que você criou, as habilidades compartilhadas com você e as habilidades no seu espaço de trabalho acessando Biblioteca na sua barra lateral e abrindo a guia Habilidades.

• Páginas de habilidades compartilhadas se comportam como páginas comuns, por isso também aparecem em Compartilhado na sua Biblioteca.

• Compartilhe uma página de habilidade quando apenas algumas pessoas precisarem daquele fluxo de trabalho. Compartilhe toda a base de dados de habilidades quando sua equipe precisar ter acesso a todas as habilidades nela.

• Qualquer pessoa com acesso de edição pode alterar uma habilidade compartilhada para todos que a utilizam, portanto, escolha editores tendo isso em mente. O Histórico da página mostra o que foi alterado caso você precise reverter.

• Agentes conectados só veem as habilidades que você pode acessar no Notion.

Ter acesso e ativar uma habilidade são duas coisas diferentes. O acesso decide quem pode abrir ou editar uma habilidade. Ativá-la decide se ela aparece no seu próprio menu de habilidades. As habilidades compartilhadas com você aparecem na guia Descobrir da sua Biblioteca, onde você pode ativá-las na coluna Ativar para mim.

As métricas de habilidades mostram com que frequência uma habilidade é executada, no Notion e em outros agentes.

• Na sua Biblioteca: A coluna Usos em Biblioteca → Habilidades mostra quantas vezes as pessoas no seu espaço de trabalho usaram cada habilidade nos últimos 28 dias, incluindo usos em agentes conectados via MCP.

• Para uma habilidade: Abra o menu Configurações da habilidade e selecione Ver métricas para ver como o uso dela mudou ao longo do tempo.

Novos usos podem levar algumas horas para aparecer.

Os proprietários do espaço de trabalho podem escolher habilidades para instalar para todos, para que toda a equipe comece com o mesmo conjunto. Vá para Configurações → IA do Notion → Geral e encontre Habilidades padrão do espaço de trabalho na seção Habilidades.

1. Escolha a quem as habilidades se destinam: a todos no espaço de trabalho ou a um grupo específico.

2. Selecione Adicionar habilidade e escolha as habilidades para instalar.

3. Para cada habilidade, escolha onde ela aparece, como no chat ou em uma página.

As habilidades padrão são instaladas para os membros automaticamente, inclusive em seus agentes conectados. Os membros ainda podem desativar uma habilidade padrão para si mesmos.

A seção Habilidades também possui configurações para desativar habilidades para todo o espaço de trabalho, para desativar habilidades em agentes conectados e para desativar downloads de habilidades locais.

Existem algumas maneiras de remover uma habilidade, dependendo do que você deseja:

• Excluir a habilidade completamente: Uma habilidade é uma página, então você pode movê-la para a lixeira como qualquer outra página. Isso também funciona para páginas de habilidade dentro de uma base de dados de habilidades. Lembre-se de que excluir a página remove a habilidade para todos que a utilizam.

• Remover uma habilidade que você adicionou: Se você adicionou uma habilidade pela guia Descobrir e não a quer mais, desative a chave na coluna Ativar para mim na

  aba Habilidades da sua Biblioteca. Isso remove a habilidade para você no Agente do Notion e em seus agentes conectados. Ela permanece disponível para todos os outros.

• Transforme uma página de habilidade em uma página comum: Selecione ••• no topo da página, selecione Usar com IA e desmarque Usar como habilidade de IA. Você também pode selecionar Deixar de usar a página como habilidade no menu Configurações da habilidade. A página e seu conteúdo permanecem onde estão. Ela deixa de ser uma habilidade.

• Use seu Agente do Notion para ajudar a fazer brainstorming ou escrever habilidades.

• Comece com um fluxo de trabalho comum que você executa semanalmente, como reescrever, recapitular, resumir ou formatar.

• Escreva sua habilidade como um prompt forte, incluindo o objetivo, as entradas, as restrições e o formato de saída desejado.

• Explicite os requisitos de saída, como “retornar 5 marcadores” ou “incluir riscos e etapas seguintes”.

• Mantenha a página de habilidade curta e crie um /link para referências mais longas quando necessário.

• Faça iterações ao longo do tempo, atualizando a página da habilidade à medida que você aprende o que funciona melhor.

• Dê a cada habilidade uma descrição clara do que ela faz e quando usá-la. O Agente do Notion e seus agentes conectados usam a descrição para escolher a habilidade certa por conta própria.

• Se a sua equipe também trabalha com agentes locais, mantenha a página de habilidade no Notion atualizada e faça o download novamente após fazer alterações.

• Dê a cada habilidade compartilhada um proprietário, para que uma pessoa a mantenha atualizada conforme o processo da sua equipe muda.

Os agentes leem o nome e a descrição de cada habilidade que você ativou antes de escolher uma. Esses limites mantêm a lista enxuta e ajudam os agentes a escolher a habilidade certa rapidamente:

Se algumas das suas habilidades não aparecerem em um agente conectado, desative as habilidades de que você não precisa nos agentes conectados.