Hantera färdigheter: upptäckt, aktivering och prioritet
På denna sida
Lektionen uppdaterad 2 november 2026 baserat på Vibe-dokumentationens sida Skills: lagt till platserna
.agents/skills/, den officiella upptäcktsordningen (anpassade sökvägar, projekt, användare) och kommandot/reload. Dokumentationen definierar ingen prioritetsregel för två färdigheter med samma namn; den tidigare versionen beskrev en sådan. Källa: Skills.
Hur Vibe upptäcker färdigheter
Att skriva en färdighet är en sak; att veta vilken som faktiskt körs är en annan. Dokumentationen specificerar ordningen i vilken Vibe upptäcker färdigheter:
- Anpassade sökvägar deklarerade i
config.tomlmed hjälp avskill_paths; - Projekt-färdigheter, placerade i
./.vibe/skills/eller./.agents/skills/, laddas endast om mappen är betrodd; - Användar-färdigheter, placerade i
~/.vibe/skills/eller~/.agents/skills/.
Mapparna .agents/skills/ följer den öppna specifikationen för Agent Skills: en färdighet som lagras där delas med andra agenter som antar samma specifikation. En aktiv session plockar upp tillagda eller modifierade färdigheter; om en ändring inte syns, skriv /reload.
Katalogstruktur för färdigheter
Globala färdigheter finns i din hemkatalog, var och en i sin egen mapp som innehåller en SKILL.md. De är tillgängliga överallt, i varje projekt där du kör Vibe.
~/.vibe/skills/
├── code-review/
│ └── SKILL.md
├── test-generator/
│ └── SKILL.md
└── doc-writer/
└── SKILL.md
Lokala färdigheter versionshanteras däremot tillsammans med projektkoden. Detta är den naturliga platsen för en distributions- eller migreringsfärdighet, som beror på repositoryts exakta infrastruktur och skulle vara meningslös på andra ställen.
mon-projet/
├── .vibe/
│ └── skills/
│ ├── deploy-prod/
│ │ └── SKILL.md
│ └── db-migrate/
│ └── SKILL.md
├── src/
└── package.json
Slutligen finns det anpassade sökvägar, som används för att referera till färdigheter som finns på andra ställen i ditt system. Du deklarerar dessa i konfigurationen:
# ~/.vibe/config.toml
skill_paths = [
"/home/equipe/shared-skills",
"/opt/company-skills"
]
Detta är den föredragna mekanismen för att dela färdigheter inom ett team, via en nätverksmapp eller ett klonat Git-repository som alla uppdaterar lokalt.
Aktivera och inaktivera färdigheter
Som standard är alla upptäckta färdigheter aktiva. Två symmetriska inställningar låter dig återta kontrollen. Med enabled_skills växlar du till en vitlista: endast de listade färdigheterna är aktiva; alla andra ignoreras.
# ~/.vibe/config.toml
enabled_skills = ["code-review", "test-generator"]
Med disabled_skills stannar du på en svartlista: alla färdigheter är aktiva utom de du namnger. Detta är rätt val när en enskild färdighet tillfälligt är i vägen.
# ~/.vibe/config.toml
disabled_skills = ["experimental-feature"]
Filtreringsmönster
Båda fälten accepterar tre former av indata. Den enklaste är det exakta namnet, vilket fungerar så länge listan hålls kort:
enabled_skills = ["code-review", "test-generator", "doc-writer"]
Glob-mönster tar över när dina namn följer en konvention. Tecknet * matchar vilken sekvens av tecken som helst, så att du kan hantera en hel familj på en rad:
# Aktivera alla färdigheter som börjar med "test-"
enabled_skills = ["test-*"]
# Inaktivera alla experimentella färdigheter
disabled_skills = ["experimental-*", "beta-*"]
För fall som glob-mönster inte täcker – ett alternativ, ett mönster mitt i ett namn, ett numeriskt suffix – prefixa uttrycket med re: för att använda ett reguljärt uttryck:
# Aktivera färdigheter vars namn innehåller "review" eller "audit"
enabled_skills = ["re:review|audit"]
# Inaktivera versionshanterade färdigheter (t.ex. "tool-v1", "tool-v2")
disabled_skills = ['re:.*-v\d+'] # literal sträng: backslash behöver inte escape-kodas
Två färdigheter med samma namn
Dokumentationen beskriver ingen prioritetsregel för två färdigheter med samma namn på olika platser. Räkna alltså inte med implicit “åsidosättande”: ge dem distinkta namn (code-review-backend snarare än en andra code-review) och verifiera vad som faktiskt laddas. I menyn / börjar varje färdighets beskrivning med dess omfång, project, user eller vibe, vilket räcker för att upptäcka dubbletter. En färdighet som har samma namn som ett inbyggt kommando visas inte i denna meny.
Konfiguration på projektnivå
Alla dessa inställningar kombineras i en fil .vibe/config.toml placerad i projektrotskatalogen. Exemplet nedan visar alla tre reglage tillsammans: begränsa listan till relevanta färdigheter, exkludera de som inte är det, och lägg till backend-teamets delade mapp.
# mon-projet/.vibe/config.toml
# Aktivera endast färdigheter relevanta för detta projekt
enabled_skills = ["test-generator", "deploy-prod", "db-migrate"]
# Eller inaktivera de som inte är relevanta
disabled_skills = ["doc-writer"]
# Lägg till ytterligare sökvägar
skill_paths = ["/home/equipe/backend-skills"]
För att verifiera vilka färdigheter som faktiskt är tillgängliga öppnar du menyn / i sessionen: varje färdighet visas där med sitt omfång. Detta är den första reflexen när ett förväntat snedstreckskommando saknas, innan du provar /reload och kontrollerar mappens betroddstatus.
Viktiga punkter
- Vibe upptäcker färdigheter i
~/.vibe/skills/,.vibe/skills/och anpassadeskill_paths - Lokala färdigheter har prioritet framför globala färdigheter
- Använd
enabled_skillsellerdisabled_skillsför att styra aktiveringen - Glob-mönster (
test-*) och regex (re:review|audit) förenklar filtrering - Skapa en
.vibe/config.tomlper projekt för att anpassa kontexten - Dela färdigheter över ett team via
skill_pathssom pekar på en gemensam mapp