--- title: "Skills: ensine ao Briks seu tom, fatos e padrões | Briks" url: https://briks.dev/pt-br/docs/skills description: "Dê ao Briks orientações que ele segue em todo projeto do seu espaço de trabalho, como tom de voz e regras de nomes. Adicione, confira e desative skills." last_updated: 2026-10-08 --- # Skills: ensine ao Briks seu tom, fatos e padrões Uma skill é um conjunto curto de instruções que a Briks segue nos projetos do seu espaço de trabalho sempre que uma tarefa se encaixa nela. Use skills para o que só você sabe: como você fala, os fatos que toda página deve acertar e o jeito de nomear as coisas. Esta página mostra como adicionar uma skill de cada forma que o estúdio oferece, como desativar uma, a leitura de segurança que toda skill recebe e três exemplos para copiar. 8 min de leitura Conferido com o estúdio em 8 de outubro de 2026 ## O que é uma skill A página **Skills** resume assim: “Orientações que o construtor segue nos projetos do seu espaço de trabalho quando uma tarefa se encaixa: seu tom, seus fatos, suas convenções. As regras de design e de código do próprio estúdio vêm sempre primeiro.” Onde 1. Skills Toda habilidade tem três partes: | Parte | O que é | Limite | | --- | --- | --- | | **Name** | Palavras em minúsculas unidas por hifens, como `tone-of-voice` | 64 caracteres | | **Quando usar** | Uma a três frases dizendo o que a habilidade cobre. O Briks escolhe uma habilidade por esta linha, então seja específico. | 1,024 caracteres | | **Instructions** | As regras e os exemplos que a Briks segue ao usar a habilidade | 20.000 caracteres | Skills pertencem a um espaço de trabalho. As que estão ativadas alcançam todos os projetos desse espaço de trabalho e nenhum outro. Até 25 podem estar ativadas ao mesmo tempo. Acima da lista, a página as conta, por exemplo “3 of 4 on. The builder receives the ones that are on with every job in this workspace, and only here.” ## Quando uma skill é usada e quando não é | Situação | A habilidade é usada? | | --- | --- | | Uma primeira construção ou uma alteração, para um site, um app ou um dashboard | Sim, quando a linha **When to use it** combina com a tarefa | | A skill está desativada | Não | | Substituir em **Media**, desfazer ou restaurar, **Apply to the live site**, publicar em produção | Não: nada novo é escrito | | Uma pergunta que você faz no estúdio | Não: perguntas são respondidas sem um build | | Uma regra que contradiz as regras de design ou de código do estúdio | Essa parte foi deixada de lado | | Uma regra que pede um segredo, um endereço externo ou arquivos fora do site | Essa parte foi deixada de lado | Skills acrescentam conhecimento, não design. Para regras fixas sobre o visual, como um rodapé preto, use **Rules in your own words** em **Settings**, **Preferences**, que é “Kept to, build after build.” Uma habilidade nova ou editada passa a valer a partir do próximo build ou alteração. Seu site publicado não muda até lá. ## Quem pode gerenciar habilidades Owners e Admins podem adicionar, editar, ativar, atualizar e excluir habilidades; o papel Admin diz “Gerencia membros, configurações, modelos e habilidades, e move projetos.” Editors e Viewers podem abrir a página **Skills** e ler a lista, mas os botões de alternância ficam acinzentados e não há o botão **Add skill**. Veja [Membros e funções](https://briks.dev/pt-br/docs/members-and-roles). ## Adicionar uma habilidade Clique em **Add skill**. Uma caixa com o título **Add a skill** oferece três formas de começar: “Escolha como começar. Você lê e pode editar cada habilidade antes que o construtor a receba.” | Opção | O que o estúdio diz | Depois de adicionado | Custo | | --- | --- | --- | --- | | **Escreva você mesmo** | Dê um nome, diga quando usar, escreva as instruções. | Desativado até você ativar, com a etiqueta **Written here** | Nada | | **Draft with AI** | Descreva o que deve fazer; um rascunho volta para você editar. Usa alguns créditos. | Desativado até você ativar, marcado como **Drafted by AI** | Reserva 5 créditos, cobrados pelo trabalho | | **Import from GitHub** | Cole um link para um SKILL.md, uma pasta ou um repositório. Ele fica fixado no commit que você leu. | Desativado até você ativar, marcado com **GitHub** e o commit | Nada | Escreva o seu 1. Abrir a caixa Onde: Skills Clique em **Add skill**, ou no botão em **No skills yet** se for a sua primeira. 2. Escolha Write your own Onde: Add a skill Uma caixa chamada **Write a skill** se abre com três campos. 3. Dê um nome Onde: Write a skill Digite um nome. Quando você sai do campo, a Briks o transforma em palavras minúsculas separadas por hífens: “Tone of voice” vira `tone-of-voice`. 4. Diga quando usar Onde: Write a skill Escreva **When to use it** como uma frase sobre a tarefa, como “A voz de cada palavra nos nossos sites. Use sempre que um texto for escrito ou reescrito.” 5. Escreva as instruções Onde: Write a skill Preencha **Instructions** com regras e exemplos. Um contador abaixo da caixa mostra quanto dos 20.000 caracteres você já usou. 6. Salve Onde: Write a skill Clique em **Add skill**. O estúdio confirma com “tone-of-voice added. It stays off until you turn it on.” 7. Ativar Onde: Skills Mude o botão à direita da habilidade para **On**. A Briks passa a usá-la a partir da sua próxima construção ou alteração. ### Rascunhar com IA Em **Draft a skill with AI**, descreva em **What the skill should do** o que a Briks deve saber ou sempre fazer, de 20 a 4.000 caracteres. Clique em **Draft it**; o estúdio avisa “Usually under a minute.” O rascunho abre em **Review the drafted skill** para você ler e editar. Depois de **Add skill**, aparece “added. It stays off until you turn it on.” ### Importar do GitHub Em **Import a skill from GitHub**, cole um **GitHub link** para o SKILL.md de um repositório público, uma pasta ou o repositório inteiro, e clique em **Read it**. Se o link tiver várias skills, escolha uma na lista e clique em **Read this one**. **Review the imported skill** mostra tudo com o commit: “Leia tudo: o construtor segue o que está escrito.” Até 30 importações podem ser lidas por hora. Uma skill importada continua fixada no commit que você leu. Para pegar uma mais nova, abra o menu da skill e escolha **Check for update**. Ou ela está atualizada, ou a versão mais nova se abre para você revisar antes de salvar. ## A leitura de segurança Cada habilidade é lida enquanto você a digita e de novo quando é salva. Se algo parecer arriscado, um painel intitulado **Read these before adding it** lista o que foi encontrado, e **Add skill** só fica disponível depois que você marcar “Li as instruções e elas são seguras de seguir.” A habilidade então recebe uma etiqueta **Read before use** na lista, com as mesmas observações. O que ele procura: - “Pede ao criador que deixe de lado regras ou instruções anteriores.” - “Tenta mudar quem é o criador ou o que o sistema dele diz.” - “Menciona chaves, segredos ou credenciais.” - “Ele pede requisições a outros endereços.” - “Ele adiciona às páginas um script de outro endereço.” - “Ele pede código que executa texto como código ou define HTML bruto.” - Os endereços web que ele cita, contados. Nunca coloque senha ou chave em uma skill Skills são texto simples que o Briks lê a cada build. Chaves e senhas devem ficar em [Secrets](https://briks.dev/pt-br/docs/secrets), onde não aparecem nos arquivos do seu site. ## Desativar, editar ou excluir Cada habilidade tem um botão à direita e um menu com **Edit**, **Check for update** para habilidades importadas, e **Delete**. Toda habilidade nova começa desativada, para você lê-la antes de a Briks usá-la. Desativar guarda a habilidade para depois. Quando 25 estão ativas, os botões das outras ficam em cinza até você desativar uma. Excluir pergunta antes: “The builder stops receiving it from the next change on.” ## Três habilidades para copiar Tom de voz tom de voz, para um escritório de direito de família em Leeds > Quando usar: A voz de cada palavra nos sites da Hollin & Hart: títulos, texto, botões, rótulos de formulário e mensagens. Use sempre que um texto for escrito ou reescrito. Instruções: Escreva como o escritório, usando nós e nosso. Use palavras simples que um pai preocupado entenda e explique qualquer termo jurídico na primeira vez que aparecer. Mantenha a calma: nunca use lutar, batalha ou vencer. Use frases curtas e nenhum ponto de exclamação. Os botões dizem o que acontece em seguida, como Agende uma conversa gratuita de 20 minutos, nunca Enviar. Páginas novas e mudanças voltam nessa voz. Um pedido para “adicionar uma página sobre mediação” devolve um texto que explica o que é mediação antes de vender qualquer coisa. Dados da casa house-facts, para uma marcenaria em Sheffield > Quando usar: Os fatos que toda página da Oakline Joinery precisa acertar: onde atuamos, o que fazemos, prazos, preços, dados de contato e horários. Use sempre que uma página mencionar qualquer um deles. Instruções: Nossa oficina fica em Sheffield e instalamos em um raio de 30 milhas. Toda cozinha é feita sob medida em carvalho maciço ou nogueira; nunca mencione MDF. O prazo é de 10 a 12 semanas a partir dos desenhos finais. As cozinhas começam em £18,000 com instalação; nunca informe outro preço. Telefone 0114 496 0321. Fechamos aos sábados. Uma mudança como “adicionar uma seção de perguntas frequentes” responde dúvidas de prazo e preço com estes números, em vez de adivinhar. Convenção de nomes product-naming, para um comerciante de chás > Quando usar: Como a Kettle & Leaf nomeia seus chás e infusões em páginas, cartões, menus e botões. Use em qualquer lista de produtos, página de produto ou preço. Instruções: Os nomes completos seguem origem, jardim, grau e depois colheita, como em Darjeeling, Castleton, FTGFOP1, segunda colheita 2026. Os cartões usam apenas origem e jardim. Os preços são por 100 g. Rooibos e camomila são infusões, nunca chás. Uma nova página de loja lista todos os produtos do mesmo jeito, com preços por 100 g, e mantém as infusões em um grupo próprio. ## Como escrever uma skill que funciona - Faça **When to use it** nomear a tarefa, como “qualquer página de cardápio ou lista de pratos”. Uma linha vaga pode fazer o Briks não recorrer à habilidade. - Escreva as regras como coisas a fazer, com o motivo quando ele não for óbvio. - Dê um exemplo do certo e do errado. Um bom exemplo muitas vezes vale mais que cinco regras. - Mantenha os fatos atualizados. Quando um preço ou um endereço mudar, edite a skill e depois peça uma alteração para que o site no ar assuma a mudança. - Mantenha um assunto por habilidade. Uma habilidade de tom e outra de fatos são mais fáceis de trocar e atualizar do que uma habilidade longa com as duas. ### Uma nova skill muda o meu site no ar na hora? Não. Ele vale a partir da próxima criação ou alteração. Peça uma alteração, como “Reescreva a página Sobre no nosso tom de voz”, para aplicá-lo às páginas que já existem. ### As habilidades custam alguma coisa? Escrever e importar é grátis. **Draft with AI** reserva 5 créditos e cobra pelo trabalho que deu. Uma habilidade em uso é lida como parte de uma construção, que é cobrada normalmente. ### Um projeto pode dispensar uma habilidade? As habilidades alcançam todos os projetos do espaço de trabalho. Desative uma enquanto trabalha em um projeto ao qual ela não serve, ou mantenha esse cliente em um espaço de trabalho próprio. ## Leia a seguir - [Construindo **Como escrever um bom briefing** O que colocar em um briefing para a primeira versão acertar: negócio, público, páginas, ação principal, fatos e tom, com seis exemplos de antes e depois.](https://briks.dev/pt-br/docs/writing-a-brief) - [Trabalhando em um projeto **Como fazer alterações no site** Como mudar seu site escrevendo ao Briks: o que dizer, imagens, o que uma mudança inclui e custa, páginas internas, pedidos na fila e como corrigir um erro.](https://briks.dev/pt-br/docs/making-changes) - [Espaços de trabalho e conta **Membros e papéis** Convide pessoas por link no email e dê a cada uma um papel: Owner, Admin, Editor ou Viewer. Veja o que cada um faz e quantas pessoas cada plano comporta.](https://briks.dev/pt-br/docs/members-and-roles) - [Espaços de trabalho e conta **Espaços de trabalho** Um espaço de trabalho reúne seus projetos, membros, mídia, skills, plano e créditos. Crie um, alterne entre eles, renomeie e exclua os que não precisar mais.](https://briks.dev/pt-br/docs/workspaces) Ainda travado? Escreva para [hello@briks.dev](mailto:hello@briks.dev) com o nome do seu projeto e o que você esperava ver. Uma captura de tela ajuda.