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.
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.”
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.
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
Apri la scatola
Dove: Skills
Clicca Add skill, oppure il pulsante in No skills yet se è la tua prima.
Scegli Write your own
Dove: Add a skill
Si apre un riquadro intitolato Write a skill con tre campi.
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.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.»
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.
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.”
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.
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
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.
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.
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.