Gestione delle competenze: scoperta, attivazione e priorità
In questa pagina
Lezione aggiornata il 2 novembre 2026 sulla base della pagina Skills della documentazione Vibe: aggiunte le posizioni
.agents/skills/, l’ordine ufficiale di scoperta (percorsi personalizzati, progetto, utente) e il comando/reload. La documentazione non definisce una regola di priorità per due competenze con lo stesso nome; la versione precedente ne descriveva una. Fonte: Skills.
Come Vibe scopre le competenze
Scrivere una competenza è una cosa; sapere quale viene effettivamente eseguita è un’altra. La documentazione specifica l’ordine in cui Vibe scopre le competenze:
- Percorsi personalizzati dichiarati in
config.tomltramiteskill_paths; - Competenze di progetto, situate in
./.vibe/skills/o./.agents/skills/, caricate solo se la cartella è attendibile; - Competenze utente, situate in
~/.vibe/skills/o~/.agents/skills/.
Le cartelle .agents/skills/ seguono la specifica aperta Agent Skills: una competenza memorizzata lì è condivisa con altri agenti che adottano la stessa specifica. Una sessione attiva rileva le competenze aggiunte o modificate; se una modifica non appare, digita /reload.
Struttura della directory delle competenze
Le competenze globali risiedono nella tua home directory, ciascuna nella propria cartella contenente un file SKILL.md. Sono disponibili ovunque, in ogni progetto in cui esegui Vibe.
~/.vibe/skills/
├── code-review/
│ └── SKILL.md
├── test-generator/
│ └── SKILL.md
└── doc-writer/
└── SKILL.md
Le competenze locali, invece, sono versionate insieme al codice del progetto. Questo è il luogo naturale per una competenza di deployment o migrazione, che dipende dall’infrastruttura esatta del repository e non avrebbe senso altrove.
mon-projet/
├── .vibe/
│ └── skills/
│ ├── deploy-prod/
│ │ └── SKILL.md
│ └── db-migrate/
│ └── SKILL.md
├── src/
└── package.json
Infine, esistono i percorsi personalizzati, utilizzati per riferirsi a competenze situate altrove nel tuo sistema. Li dichiari nella configurazione:
# ~/.vibe/config.toml
skill_paths = [
"/home/equipe/shared-skills",
"/opt/company-skills"
]
Questo è il meccanismo preferito per condividere le competenze all’interno di un team, tramite una cartella di rete o un repository Git clonato che tutti aggiornano lato loro.
Abilitazione e disabilitazione delle competenze
Per impostazione predefinita, tutte le competenze scoperte sono attive. Due impostazioni simmetriche ti permettono di riprendere il controllo. Con enabled_skills, passi a una whitelist: solo le competenze elencate sono attive; tutte le altre vengono ignorate.
# ~/.vibe/config.toml
enabled_skills = ["code-review", "test-generator"]
Con disabled_skills, rimani su una blacklist: tutte le competenze sono attive tranne quelle che nomini. Questa è la scelta giusta quando una singola competenza ti sta temporaneamente ostacolando.
# ~/.vibe/config.toml
disabled_skills = ["experimental-feature"]
Pattern di filtraggio
Entrambi i campi accettano tre forme di input. La più semplice è il nome esatto, che funziona finché la lista rimane breve:
enabled_skills = ["code-review", "test-generator", "doc-writer"]
I pattern glob subentrano una volta che i tuoi nomi seguono una convenzione. Il carattere * corrisponde a qualsiasi sequenza di caratteri, permettendoti di gestire un’intera famiglia in una riga:
# Abilita tutte le competenze che iniziano con "test-"
enabled_skills = ["test-*"]
# Disabilita tutte le competenze sperimentali
disabled_skills = ["experimental-*", "beta-*"]
Per i casi che i glob non coprono—un’alternativa, un pattern nel mezzo di un nome, un suffisso numerico—prefissa l’espressione con re: per usare un’espressione regolare:
# Abilita le competenze il cui nome contiene "review" o "audit"
enabled_skills = ["re:review|audit"]
# Disabilita le competenze versionate (es. "tool-v1", "tool-v2")
disabled_skills = ['re:.*-v\d+'] # stringa letterale: il backslash non necessita di escape
Due competenze con lo stesso nome
La documentazione non descrive una regola di priorità per due competenze con lo stesso nome in posizioni diverse. Quindi non contare su una “sovrascrittura” implicita: dai loro nomi distinti (code-review-backend invece di un secondo code-review) e verifica cosa viene effettivamente caricato. Nel menu /, la descrizione di ogni competenza inizia con il suo ambito, project, user o vibe, il che è sufficiente per individuare un duplicato. Una competenza con lo stesso nome di un comando built-in non appare in questo menu.
Configurazione a livello di progetto
Tutte queste impostazioni si combinano in un file .vibe/config.toml posizionato alla radice del progetto. L’esempio seguente mostra tutte e tre le leve insieme: limita la lista alle competenze rilevanti, esclude quelle che non lo sono e aggiungi la cartella condivisa del team backend.
# mon-projet/.vibe/config.toml
# Abilita solo le competenze rilevanti per questo progetto
enabled_skills = ["test-generator", "deploy-prod", "db-migrate"]
# Oppure disabilita quelle non rilevanti
disabled_skills = ["doc-writer"]
# Aggiungi percorsi aggiuntivi
skill_paths = ["/home/equipe/backend-skills"]
Per verificare quali competenze sono effettivamente disponibili, apri il menu / nella sessione: ogni competenza appare lì con il suo ambito. Questo è il primo riflesso quando un comando slash atteso manca, prima di provare /reload e controllare lo stato di attendibilità della cartella.
Punti chiave
- Vibe scopre le competenze in
~/.vibe/skills/,.vibe/skills/e neiskill_pathspersonalizzati - Le competenze locali hanno priorità su quelle globali
- Usa
enabled_skillsodisabled_skillsper controllare l’attivazione - I pattern glob (
test-*) e le regex (re:review|audit) semplificano il filtraggio - Crea un
.vibe/config.tomlper progetto per personalizzare il contesto - Condividi le competenze tra un team tramite
skill_pathsche puntano a una cartella comune