Správa zručností: objavovanie, aktivácia a priority
Na tejto strane
Lekcia aktualizovaná 2. novembra 2026 na základe stránky Skills v dokumentácii Vibe: pridané umiestnenia
.agents/skills/, oficiálne poradie objavovania (vlastné cesty, projekt, používateľ) a príkaz/reload. Dokumentácia nedefinuje pravidlo priority pre dve zručnosti s rovnakým názvom; predchádzajúca verzia jednu opisovala. Zdroj: Skills.
Ako Vibe objavuje zručnosti
Napísať zručnosť je jedna vec; vedieť, ktorá sa skutočne spustí, je druhá. Dokumentácia špecifikuje poradie, v akom Vibe objavuje zručnosti:
- Vlastné cesty deklarované v súbore
config.tomlpomocouskill_paths; - Projektové zručnosti, umiestnené v
./.vibe/skills/alebo./.agents/skills/, načítané iba vtedy, ak je priečinok dôveryhodný; - Používateľské zručnosti, umiestnené v
~/.vibe/skills/alebo~/.agents/skills/.
Priečinky .agents/skills/ sa riadia otvorenou špecifikáciou Agent Skills: zručnosť uložená na tomto mieste je zdieľaná s ostatnými agentmi, ktorí túto špecifikáciu využívajú. Aktívna relácia zachytí pridané alebo upravené zručnosti; ak sa zmena neprejaví, zadaj príkaz /reload.
Štruktúra priečinka so zručnosťami
Globálne zručnosti žijú v tvojom domovskom priečinku, každá vo vlastnom podpriečinku obsahujúcom súbor SKILL.md. Sú dostupné všade, v každom projekte, kde spúšťaš Vibe.
~/.vibe/skills/
├── code-review/
│ └── SKILL.md
├── test-generator/
│ └── SKILL.md
└── doc-writer/
└── SKILL.md
Lokálne zručnosti sú naopak verzované spolu s kódom projektu. Je to prirodzené miesto pre zručnosti týkajúce sa nasadenia alebo migrácie, ktoré závisia od presnej infraštruktúry repozitára a inde by nedávali zmysel.
mon-projet/
├── .vibe/
│ └── skills/
│ ├── deploy-prod/
│ │ └── SKILL.md
│ └── db-migrate/
│ └── SKILL.md
├── src/
└── package.json
Nakoniec tu sú vlastné cesty, ktoré slúžia na odkazovanie na zručnosti uložené inde v tvojom systéme. Tieto cesty deklaruješ v konfigurácii:
# ~/.vibe/config.toml
skill_paths = [
"/home/equipe/shared-skills",
"/opt/company-skills"
]
Toto je preferovaný mechanizmus na zdieľanie zručností v rámci tímu, či už cez sieťový priečinok, alebo naklonovaný Git repozitár, ktorý si každý aktualizuje na svojej strane.
Povolenie a zakázanie zručností
Predvolene sú všetky objavené zručnosti aktívne. Dva symetrické nastavenia ti umožňujú prevziať kontrolu späť. Pomocou enabled_skills prejdeš na bielu listinu: aktívne sú iba uvedené zručnosti, všetky ostatné sa ignorujú.
# ~/.vibe/config.toml
enabled_skills = ["code-review", "test-generator"]
Pomocou disabled_skills zostávaš na čiernej listine: aktívne sú všetky zručnosti okrem tých, ktoré vymenuješ. Toto je správna voľba, keď ti jedna konkrétna zručnosť dočasne prekáža.
# ~/.vibe/config.toml
disabled_skills = ["experimental-feature"]
Filtrovacie vzory
Obe polia prijímajú tri formy vstupu. Najjednoduchšia je presný názov, čo funguje, pokiaľ zostáva zoznam krátky:
enabled_skills = ["code-review", "test-generator", "doc-writer"]
Glob vzory preberajú iniciatívu, keď sa tvoje názvy riadia konvenciou. Znak * zodpovedá ľubovoľnej sekvencii znakov, čo ti umožňuje vybaviť celú rodinu zručností jedným riadkom:
# Povoliť všetky zručnosti začínajúce na "test-"
enabled_skills = ["test-*"]
# Zakázať všetky experimentálne zručnosti
disabled_skills = ["experimental-*", "beta-*"]
Pre prípady, ktoré glob vzory nepokrývajú – alternatíva, vzor v strede názvu, číselná prípona – prefixuj výraz reťazcom re:, aby si použil regulárny výraz:
# Povoliť zručnosti, ktorých názov obsahuje "review" alebo "audit"
enabled_skills = ["re:review|audit"]
# Zakázať verzované zručnosti (napr. "tool-v1", "tool-v2")
disabled_skills = ['re:.*-v\d+'] # doslovný reťazec: spätné lomítko netreba escapovať
Dve zručnosti s rovnakým názvom
Dokumentácia neopisuje pravidlo priority pre dve zručnosti s rovnakým názvom na rôznych miestach. Nespoliehaj sa teda na implicitné „prepísanie“: daj im odlišné názvy (code-review-backend namiesto druhého code-review) a over si, čo sa skutočne načítalo. V ponuke / začína popis každej zručnosti jej rozsahom: project, user alebo vibe, čo stačí na odhalenie duplikátu. Zručnosť pomenovaná ako vstavaný príkaz sa v tejto ponuke nezobrazuje.
Konfigurácia na úrovni projektu
Všetky tieto nastavenia sa kombinujú v súbore .vibe/config.toml umiestnenom v koreňovom adresári projektu. Nasledujúci príklad ukazuje všetky tri páky spoločne: obmedziť zoznam na relevantné zručnosti, vylúčiť tie, ktoré nie sú potrebné, a pridať zdieľaný priečinok backend tímu.
# mon-projet/.vibe/config.toml
# Povoliť iba zručnosti relevantné pre tento projekt
enabled_skills = ["test-generator", "deploy-prod", "db-migrate"]
# Alebo zakázať tie, ktoré nie sú relevantné
disabled_skills = ["doc-writer"]
# Pridať ďalšie cesty
skill_paths = ["/home/equipe/backend-skills"]
Ak chceš overiť, ktoré zručnosti sú skutočne dostupné, otvor v relácii ponuku /: každá zručnosť sa tam zobrazí spolu so svojím rozsahom. Toto je prvý reflex, keď očakávaný lomítkový príkaz chýba, ešte pred tým, než skúsiš /reload a skontroluješ stav dôveryhodnosti priečinka.
Kľúčové poznatky
- Vibe objavuje zručnosti v
~/.vibe/skills/,.vibe/skills/a vlastnýchskill_paths - Lokálne zručnosti majú prioritu pred globálnymi zručnosťami
- Na ovládanie aktivácie použi
enabled_skillsalebodisabled_skills - Glob vzory (
test-*) a regex (re:review|audit) zjednodušujú filtrovanie - Vytvor
.vibe/config.tomlpre každý projekt na prispôsobenie kontextu - Zdieľaj zručnosti v rámci tímu pomocou
skill_pathssmerujúcich na spoločný priečinok