Przejdź do głównej treści
Polski— Wybierz język
Menu

Tworzenie umiejętności z plikiem SKILL.md

Lekcja 6 z 14 Zaktualizowano 2 listopada 2026 Zaawansowany
Na tej stronie
  1. Umiejętności: Komponenty wielokrotnego użytku
  2. Anatomia pliku SKILL.md
  3. Pola nagłówka YAML
  4. Treść pliku SKILL.md
  5. Stwórz swoją pierwszą umiejętność
  6. Najlepsze praktyki
  7. Kluczowe wnioski

Lekcja zaktualizowana 2 listopada 2026 r. na podstawie strony Skills w dokumentacji Vibe: umiejętność to zestaw instrukcji (nie dodaje narzędzi), pole allowed-tools jest 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.md zawierają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: true udostępnia umiejętność poprzez polecenie ukośne
  • Twórz wyspecjalizowane umiejętności z minimalną niezbędną liczbą narzędzi