Tworzenie umiejętności z plikiem SKILL.md
Na tej stronie
Lekcja zaktualizowana 2 listopada 2026 r. na podstawie strony Skills w dokumentacji Vibe: umiejętność to zestaw instrukcji (nie dodaje narzędzi), pole
allowed-toolsjest odczytywane, ale nie egzekwowane, a dwa pola zostały dodane (disable-model-invocation,compatibility). Źródło: Skills.
Umiejętności: Komponenty wielokrotnego użytku
Agenci definiują, kto wykonuje zadanie. Umiejętności definiują, co: są to wielokrotnie używalne zestawy instrukcji, które dodają procedury i polecenia ukośne (slash commands) do Mistral Vibe. Rozróżnienie to staje się konkretne, gdy zastosujesz je w swoim zespole – agent odzwierciedla osobisty styl pracy, podczas gdy umiejętność encapsuluje procedurę, którą każdy musi wykonywać w ten sam sposób.
Umiejętność to katalog zawierający plik SKILL.md z nagłówkiem YAML. Struktura ta遵循 otwartą specyfikację Agent Skills, dzięki czemu umiejętności są przenośne i łatwe do udostępniania: ten sam folder działa na komputerze Twojego kolegi bez żadnych adaptacji.
Anatomia pliku SKILL.md
Oto kompletna struktura umiejętności, zilustrowana przykładem automatycznego przeglądu kodu:
---
name: code-review
description: Performs automated code reviews with quality analysis
license: MIT
user-invocable: true
allowed-tools:
- read_file
- grep
- ask_user_question
---
# Code Review Skill
This skill analyzes source code quality by checking:
1. **Naming conventions** — variables, functions, classes
2. **Cyclomatic complexity** — functions that are too long or nested
3. **Duplication** — copy-pasted code to refactor
4. **Security** — dangerous patterns (eval, SQL injection, XSS)
## Usage
Run `/code-review` followed by the path or description of the code to analyze.
## Output format
The report is structured in three levels:
- 🔴 **Critical** — fix immediately
- 🟡 **Warning** — fix before merging
- 🟢 **Suggestion** — optional improvement
Pola nagłówka YAML
Pole name to unikalny identyfikator umiejętności. Służy do włączania, wyłączania i odwoływania się do umiejętności w konfiguracjach. Ta nazwa staje się również poleceniem ukośnym, więc warto utrzymać ją w krótkiej formie.
name: code-review
Pole description, mające maksymalnie 1024 znaków, to fraza wyświetlana, gdy Vibe listuje dostępne umiejętności. Napisz ją z perspektywy osoby szukającej rozwiązania: powinna pozwolić jej wybrać między dwiema podobnymi umiejętnościami bez konieczności otwierania plików.
description: Performs automated code reviews with quality analysis
Pole license wskazuje licencję umiejętności, co staje się istotne, gdy tylko udostępniasz ją poza własnym stanowiskiem pracy.
license: MIT
Wartość logiczna user-invocable, domyślnie ustawiona na true, udostępnia umiejętność jako polecenie ukośne. Ustaw ją na false, aby ukryć ją w menu /: agent nadal może ją załadować automatycznie, gdy zadanie będzie tego wymagać.
user-invocable: true # Dostępne przez /code-review
user-invocable: false # Ukryte w menu /, agent nadal może je załadować
Pole disable-model-invocation, gdy ustawione na true, zapobiega samodzielnemu ładowaniu umiejętności przez agenta: uruchamia się ona tylko wtedy, gdy wpiszesz /nazwa-umiejętności. Zarezerwuj to dla procedur, których żaden model nie powinien wywoływać bez Twojej wyraźnej zgody, takich jak wdrożenie.
disable-model-invocation: true
Dwa pola informacyjne uzupełniają listę: compatibility, które odnotowuje wymagania wstępne (np. „Wymaga git“), oraz allowed-tools, które wymienia narzędzia, z których umiejętność zamierza korzystać. Uważaj na to ostatnie: dokumentacja precyzuje, że Vibe je odczytuje, ale nie egzekwuje. Umiejętność może wywołać każde narzędzie, na które upoważniony jest aktywny agent. Aby ograniczyć możliwości działania umiejętności, musisz ograniczyć narzędzia i uprawnienia samego agenta (lekcje 2 i 3).
allowed-tools:
- read_file
- grep
- ask_user_question
Treść pliku SKILL.md
Po nagłówku, treść pliku to dowolny format Markdown. Pełni ona podwójną rolę: dokumentacji i promptu: Vibe odczytuje ją, aby zrozumieć, jak działa umiejętność i w jakim kontekście ją zastosować. To tutaj opisujesz, co robi umiejętność, kroki jej działania, oczekiwany format wyjścia oraz przykłady użycia. Niejasna treść skutkuje nieprzewidywalną umiejętnością; precyzyjna treść daje umiejętność, która produkuje ten sam rezultat tydzień po tygodniu.
Stwórz swoją pierwszą umiejętność
Zbudujmy umiejętność generowania testów. Zacznij od utworzenia jej katalogu:
mkdir -p ~/.vibe/skills/test-generator
Umieść wewnątrz następujący plik SKILL.md. Zwróć uwagę, jak treść odpowiada na pytania, które Vibe musiałby inaczej zgadywać: który framework wybrać, jak nazwać bloki, gdzie zapisać plik wyjściowy.
---
name: test-generator
description: Generates unit tests for TypeScript/JavaScript functions
license: MIT
user-invocable: true
allowed-tools:
- read_file
- write_file
- grep
---
# Test Generator
Generates comprehensive unit tests for
TypeScript and JavaScript functions.
## Process
1. Read the target source file
2. Identify all exported functions
3. For each function, generate:
- Happy path test
- Test with empty/null inputs
- Edge case tests
- Expected error tests
4. Write tests to an adjacent `.test.ts` file
## Conventions
- Framework: Vitest (default) or Jest if detected
- Naming: `describe` per function, `it` per test case
- Assertions: `expect` with precise matchers
- No mocks unless necessary (external dependencies)
## Example
For a file `utils/math.ts` containing `add(a, b)`,
the skill generates `utils/math.test.ts` with corresponding tests.
Gdy plik zostanie utworzony, umiejętność jest natychmiast dostępna: żadna komenda instalacji, żaden restart nie są potrzebne. Uruchom Vibe i wywołaj ją na rzeczywistym pliku.
vibe
# > /test-generator src/utils/math.ts
Vibe ładuje umiejętność, odczytuje jej plik SKILL.md, aby zrozumieć oczekiwane zachowanie, i wykonuje zadanie przy użyciu autoryzowanych narzędzi. Poświęć czas na przeczytanie wyniku: porównując wyjście z tym, co sobie wyobrażałeś, dopracujesz treść pliku.
Najlepsze praktyki
Trzymaj się zasady: jedna umiejętność na jedną funkcję. Mieszanie przeglądu kodu i generowania testów w jednym pliku tworzy prompt, który jest niejednoznaczny, i uniemożliwia wyłączenie jednej funkcji bez utraty drugiej. Podobnie, ogranicz autoryzowane narzędzia tylko do tych, których umiejętność rzeczywiście potrzebuje.
Reszta zależy od jakości zapisu. Treść pliku SKILL.md to Twój prompt: bądź precyzyjny i dołącz konkretne przykłady tego, co umiejętność produkuje – przykład wyjścia jest wart więcej niż trzy linijki opisu. Na koniec przetestuj swoją umiejętność na kilku przypadkach, w tym na jednym trudnym, zanim udostępnisz ją zespołowi.
Kluczowe wnioski
- Umiejętność to katalog z plikiem
SKILL.mdzawierającym nagłówek YAML - Nagłówek definiuje nazwę, opis, dozwolone narzędzia i możliwość wywołania
- Treść Markdown służy zarówno jako dokumentacja, jak i prompt dla Vibe
user-invocable: trueudostępnia umiejętność poprzez polecenie ukośne- Twórz wyspecjalizowane umiejętności z minimalną niezbędną liczbą narzędzi