---
title: "Skills: insegna a Briks tono, fatti e convenzioni | Briks"
url: https://briks.dev/it/docs/skills
description: "Dai a Briks indicazioni che segue in ogni progetto del tuo spazio di lavoro: tono di voce, dati aziendali e nomi. Aggiungi, verifica e disattiva le skill."
last_updated: 2026-10-08
---

# Skills: insegna a Briks tono, fatti e convenzioni

Una skill è un breve insieme di istruzioni che Briks segue sui progetti del tuo spazio di lavoro ogni volta che un'attività la richiede. Usa le skill per ciò che sai solo tu: come ti esprimi, i fatti che ogni pagina deve riportare con precisione e il modo in cui dai i nomi alle cose. Questa pagina spiega come aggiungere una skill in ogni modo offerto dallo studio, come disattivarne una, il controllo di sicurezza che ogni skill riceve e tre esempi da copiare.

8 minuti di lettura Verificato rispetto allo studio il 8 ottobre 2026

## Cos'è una skill

La pagina **Skills** lo riassume così: “Guidance the builder follows on your workspace's projects when a task fits it: your tone, your facts, your conventions. The studio's own design and code rules always come first.”

Dove

1. Skills

Ogni skill ha tre parti:

| Parte | Che cos'è | Limite |
| --- | --- | --- |
| **Name** | Parole minuscole unite da trattini, come `tone-of-voice` | 64 caratteri |
| **Quando usarlo** | Da una a tre frasi che dicono cosa copre la skill. Briks sceglie una skill in base a questa riga, quindi sii specifico. | 1.024 caratteri |
| **Istruzioni** | Le regole e gli esempi che Briks segue quando usa la skill | 20.000 caratteri |

Le competenze appartengono a uno spazio di lavoro. Quelle attive raggiungono ogni progetto di quello spazio di lavoro e nessun altro. Se ne possono attivare al massimo 25 insieme. Sopra l'elenco, la pagina le conta, per esempio «3 of 4 on. The builder receives the ones that are on with every job in this workspace, and only here.»

## Quando una competenza viene usata e quando no

| Situazione | La skill viene usata? |
| --- | --- |
| Una prima creazione o una modifica, per un sito web, un'app o una dashboard | Sì, quando la sua riga **When to use it** si adatta al compito |
| La skill è disattivata | No |
| Sostituisci da **Media**, annulla o ripristina, **Apply to the live site**, pubblicazione in produzione | No: non viene scritto nulla di nuovo |
| Una domanda che fai nello studio | No: alle domande si risponde senza una build |
| Una regola in contrasto con le regole di design o di codice dello studio | Quella parte è stata messa da parte |
| Una regola che richiede un segreto, un indirizzo esterno o file fuori dal sito | Quella parte è stata messa da parte |

Le skill aggiungono conoscenza, non design. Per regole fisse sull'aspetto, come un footer nero, usa **Rules in your own words** in **Settings**, **Preferences**, che è “Kept to, build after build.”

Una skill nuova o modificata ha effetto dalla build o dalla modifica successiva. Il tuo sito pubblicato non cambia fino ad allora.

## Chi può gestire le skill

Owner e Admin possono aggiungere, modificare, attivare o disattivare, aggiornare ed eliminare le competenze; il ruolo Admin riporta «Gestisce membri, impostazioni, modelli e competenze, e sposta i progetti.» Editor e Viewer possono aprire la pagina **Skills** e leggere l'elenco, ma i suoi interruttori sono disattivati e non c'è il pulsante **Add skill**. Vedi [Membri e ruoli](https://briks.dev/it/docs/members-and-roles).

## Aggiungi una competenza

Clicca su **Add skill**. Una finestra intitolata **Add a skill** offre tre modi per iniziare: “Choose how to start. You read and can edit every skill before the builder receives it.”

| Opzione | Cosa dice lo studio | Una volta aggiunto | Costo |
| --- | --- | --- | --- |
| **Scrivi tu** | Dagli un nome, indica quando usarlo, scrivi le istruzioni. | Disattivato finché non lo attivi, con l'etichetta **Written here** | Niente |
| **Draft with AI** | Descrivi cosa deve fare; ti torna una bozza da modificare. Usa alcuni crediti. | Disattivato finché non lo attivi, con l'etichetta **Drafted by AI** | Trattiene 5 crediti, addebitati per il lavoro svolto |
| **Import from GitHub** | Incolla un link a uno SKILL.md, a una cartella o a un repository. Viene fissato al commit che hai letto. | Disattivato finché non lo attivi, con l'etichetta **GitHub** e il commit | Niente |

Scrivi il tuo

1. Apri la scatola

   Dove: Skills

   Clicca **Add skill**, oppure il pulsante in **No skills yet** se è la tua prima.

2. Scegli Write your own

   Dove: Add a skill

   Si apre un riquadro intitolato **Write a skill** con tre campi.

3. Dagli un nome

   Dove: Write a skill

   Scrivi un nome. Quando esci dal campo, Briks lo sistema in parole minuscole separate da trattini: “Tone of voice” diventa `tone-of-voice`.

4. Indica quando usarlo

   Dove: Write a skill

   Scrivi **When to use it** come una frase sul compito, ad esempio «La voce per ogni parola dei nostri siti. Da usare ogni volta che si scrive o si riscrive un testo.»

5. Scrivi le istruzioni

   Dove: Write a skill

   Compila **Instructions** con regole ed esempi. Un contatore sotto il campo mostra quanti dei 20.000 caratteri hai usato.

6. Salvalo

   Dove: Write a skill

   Fai clic su **Add skill**. Lo studio conferma con “tone-of-voice added. It stays off until you turn it on.”

7. Attivalo

   Dove: Skills

   Sposta l'interruttore sulla destra della competenza su **On**. Briks la usa dalla tua prossima creazione o modifica.

### Scrivi una bozza con l'IA

In **Draft a skill with AI**, descrivi in **What the skill should do** ciò che Briks deve sapere o fare sempre, da 20 a 4.000 caratteri. Fai clic su **Draft it**; lo studio indica “Usually under a minute.” La bozza si apre in **Review the drafted skill** perché tu la legga e la modifichi. Dopo **Add skill**, compare “added. It stays off until you turn it on.”

### Importa da GitHub

In **Import a skill from GitHub**, incolla un **GitHub link** al SKILL.md di un repository pubblico, a una cartella o all'intero repository, e fai clic su **Read it**. Se il link contiene più skill, scegline una dall'elenco e fai clic su **Read this one**. **Review the imported skill** la mostra per intero con il suo commit: “Read it all: the builder follows it as written.” Si possono leggere fino a 30 importazioni all'ora.

Una skill importata resta fissata al commit che hai letto. Per ottenerne uno più recente, apri il menu della skill e scegli **Check for update**. O è aggiornata, oppure la versione più recente si apre per essere esaminata prima di salvarla.

## La lettura di sicurezza

Ogni skill viene letta mentre la scrivi e di nuovo quando viene salvata. Se qualcosa sembra rischioso, un pannello intitolato **Read these before adding it** elenca ciò che è stato trovato, e **Add skill** resta in attesa finché non spunti “I have read the instructions and they are safe to follow.” La skill riporta poi nell'elenco un'etichetta **Read before use**, con le stesse note. Cosa cerca:

- “Chiede al builder di mettere da parte regole o istruzioni precedenti.”
- “Cerca di cambiare chi è il creatore o cosa dice il suo sistema.”
- “Cita chiavi, segreti o credenziali.”
- “Chiede richieste ad altri indirizzi.”
- “Aggiunge alle pagine uno script da un altro indirizzo.”
- “Richiede codice che esegue testo come codice o imposta HTML grezzo.”
- Tutti gli indirizzi web che nomina, contati.

Non inserire mai una password o una chiave in una skill

Le skill sono semplice testo che Briks legge a ogni creazione. Chiavi e password vanno in [Secrets](https://briks.dev/it/docs/secrets), dove restano fuori dai file del tuo sito.

## Disattiva, modifica o elimina

Ogni competenza ha un interruttore sulla destra e un menu con **Edit**, **Check for update** per le competenze importate e **Delete**. Ogni nuova competenza parte spenta, così la leggi prima che Briks la usi. Spegnerla la conserva per dopo. Quando ce ne sono 25 attive, gli interruttori delle altre sono disattivati finché non ne spegni una. Eliminare chiede prima conferma: “The builder stops receiving it from the next change on.”

## Tre competenze da copiare

Tono di voce tone-of-voice, per uno studio legale di diritto di famiglia a Leeds

> Quando usarla: la voce di ogni parola nei siti di Hollin & Hart: titoli, testi, pulsanti, etichette dei moduli e messaggi. Usala ogni volta che un testo viene scritto o riscritto. Istruzioni: scrivi come lo studio, usando noi e nostro. Usa parole semplici che un genitore preoccupato capisce, e spiega ogni termine legale la prima volta che compare. Resta calmo: non usare mai lotta, battaglia o vincere. Tieni le frasi brevi e non usare punti esclamativi. I pulsanti dicono cosa succede dopo, ad esempio Prenota una chiamata gratuita di 20 minuti, mai Invia.

Le nuove pagine e le modifiche tornano con quella voce. Una richiesta come “aggiungi una pagina sulla mediazione” restituisce un testo che spiega che cos'è la mediazione prima di vendere qualsiasi cosa.

Informazioni sulla casa house-facts, per una falegnameria di Sheffield

> Quando usarlo: I fatti che ogni pagina di Oakline Joinery deve riportare correttamente: dove lavoriamo, che cosa produciamo, tempi di consegna, prezzi, recapiti e orari. Usalo ogni volta che una pagina ne cita uno. Istruzioni: Il nostro laboratorio è a Sheffield e montiamo entro 30 miglia. Ogni cucina è fatta su misura in rovere massello o noce; non nominare mai l'MDF. Il tempo di consegna è di 10-12 settimane dai disegni definitivi. Le cucine partono da £18,000 con montaggio incluso; non citare mai nessun altro prezzo. Telefono 0114 496 0321. Il sabato siamo chiusi.

Una modifica come “aggiungi una sezione FAQ” risponde alle domande su tempi di consegna e prezzi con queste cifre invece di andare a intuito.

Convenzione di denominazione product-naming, per un commerciante di tè

> Quando usarla: come Kettle & Leaf dà il nome ai suoi tè e alle sue infusioni su pagine, schede, menu e pulsanti. Da usare per ogni elenco prodotti, pagina prodotto o prezzo. Istruzioni: i nomi completi seguono origine, giardino, grado, poi raccolto, come in Darjeeling, Castleton, FTGFOP1, second flush 2026. Le schede usano solo origine e giardino. I prezzi sono per 100 g. Rooibos e camomilla sono infusioni, mai tè.

Una nuova pagina del negozio elenca ogni prodotto nello stesso modo, con i prezzi per 100 g, e tiene le tisane in un gruppo a parte.

## Scrivere una skill che funziona

- Fai in modo che **When to use it** indichi il compito, ad esempio «qualsiasi pagina del menu o elenco di piatti». Una riga vaga può far sì che Briks non usi la competenza.
- Scrivi le regole come cose da fare, con il motivo quando non è ovvio.
- Fai un esempio di giusto e sbagliato. Un buon esempio spesso vale più di cinque regole.
- Tieni aggiornati i fatti. Quando cambia un prezzo o un indirizzo, modifica la skill, poi chiedi una modifica così il sito online la recepisce.
- Dedica ogni competenza a un solo argomento. Una competenza sul tono e una sui fatti sono più facili da attivare e aggiornare di una sola lunga competenza che le contiene entrambe.

### Una nuova skill cambia subito il mio sito online?

No. Viene usato dalla prossima creazione o modifica. Chiedi una modifica, per esempio «Riscrivi la pagina Chi siamo con il nostro tono di casa», per applicarlo alle pagine già esistenti.

### Le competenze hanno un costo?

Scrivere e importare è gratuito. **Draft with AI** trattiene 5 crediti e addebita il lavoro svolto. Una competenza in uso viene letta come parte di una creazione, che viene addebitata come di consueto.

### Un progetto può saltare una skill?

Le competenze raggiungono ogni progetto dello spazio di lavoro. Disattivane una mentre lavori a un progetto a cui non si adatta, oppure tieni quel cliente in uno spazio di lavoro a parte.

## Da leggere dopo

- [Creazione in corso **Scrivere una buona descrizione** Cosa mettere in un brief perché la prima creazione riesca: l'attività, il pubblico, le pagine, l'azione principale, fatti e tono, con sei esempi prima e dopo.](https://briks.dev/it/docs/writing-a-brief)
- [Lavorare a un progetto **Fare modifiche** Come cambiare il sito scrivendo a Briks: cosa dire, aggiungere immagini, cosa include e costa una modifica, pagine interne, richieste in coda, correzioni.](https://briks.dev/it/docs/making-changes)
- [Spazi di lavoro e account **Membri e ruoli** Invita le persone con un link via email e dai a ognuna un ruolo: Owner, Admin, Editor o Viewer. Scopri cosa può fare ogni ruolo e quante persone ha ogni piano.](https://briks.dev/it/docs/members-and-roles)
- [Spazi di lavoro e account **Spazi di lavoro** Uno spazio di lavoro contiene progetti, membri, media, competenze, piano e crediti. Creane uno, cambia spazio, rinomina o elimina quelli che non servono.](https://briks.dev/it/docs/workspaces)

Hai ancora dubbi?

Scrivi a [hello@briks.dev](mailto:hello@briks.dev) indicando il nome del tuo progetto e cosa ti aspettavi di vedere. Uno screenshot aiuta.