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.
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.”
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.
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
Abrir a caixa
Onde: Skills
Clique em Add skill, ou no botão em No skills yet se for a sua primeira.
Escolha Write your own
Onde: Add a skill
Uma caixa chamada Write a skill se abre com três campos.
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.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.”
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.
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.”
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.
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
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.
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.
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.