Премини към основното съдържание
Български— Изберете език
Меню

Създаване на умение с SKILL.md

Урок 6 от 14 Обновен 2 ноември 2026 г. Напреднало
На тази страница
  1. Умения: Многоразови компоненти
  2. Анатомия на SKILL.md
  3. Полетата в YAML frontmatter
  4. Тялото на SKILL.md
  5. Създайте своето първо умение
  6. Най-добри практики
  7. Ключови изводи

Урокът е актуализиран на 2 ноември 2026 г. въз основа на страницата Skills в документацията на Vibe: умението е набор от инструкции (не добавя инструменти), allowed-tools се чете, но не се налага, и са добавени две полета (disable-model-invocation, compatibility). Източник: Skills.

Умения: Многоразови компоненти

Агентите дефинират кой изпълнява задачата. Уменията дефинират какво: те са многоразови набори от инструкции, които добавят процедури и слеш-команди към Mistral Vibe. Разликата става осезаема, когато я приложите към вашия екип – агентът отразява личен работен подход, докато умението обхваща процедура, която всеки трябва да изпълнява по един и същи начин.

Умението представлява директория, съдържаща файл SKILL.md с YAML frontmatter. Тази структура следва отворената спецификация Agent Skills, правейки уменията преносими и споделяеми: една и съща папка работи на машината на вашия колега без адаптация.

Анатомия на SKILL.md

Ето пълната структура на едно умение, илюстрирана с пример за автоматизиран код ревю:

---
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

Полетата в YAML frontmatter

Полето name е уникалният идентификатор на умението. То се използва за активиране, деактивиране и препращане към умението в конфигурациите. Това име също става слеш-команда, затова си струва да го поддържате кратко.

name: code-review

Полето description, до 1024 знака, е фразата, която се появява, когато Vibe изброява наличните умения. Напишете го от гледна точка на търсещия потребител: то трябва да му позволи да избере между две сходни умения, без да отваря файловете.

description: Performs automated code reviews with quality analysis

Полето license указва лиценза на умението, което става важно веднага щом го споделите извън вашата работна станция.

license: MIT

Булевото поле user-invocable, което по подразбиране е true, излага умението като слеш-команда. Задайте го на false, за да го скриете от менюто /: агентът все още може да го зареди автоматично, когато задачата го изисква.

user-invocable: true   # Accessible via /code-review
user-invocable: false  # Hidden from / menu, agent can still load it

Полето disable-model-invocation, когато е зададено на true, предотвратява автоматичното зареждане на умението от агента: то се изпълнява само ако въведете /skill-name. Запазете това за процедури, които никой модел не трябва да задейства без вашето изрично съгласие, като например деплой.

disable-model-invocation: true

Две информационни полета допълват списъка: compatibility, което отбелязва предварителните изисквания („Requires git“), и allowed-tools, което изброява инструментите, които умението възнамерява да използва. Бъдете внимателни с последното: документацията уточнява, че Vibe го чете, но не го налага. Едно умение може да извика всеки инструмент, който активният агент разрешава. За да ограничите какво може да прави едно умение, ограничете инструментите и разрешенията на агента (Уроци 2 и 3).

allowed-tools:
  - read_file
  - grep
  - ask_user_question

Тялото на SKILL.md

След frontmatter-а, тялото на файла е Markdown в свободен формат. То служи едновременно като документация и промпт: Vibe го чете, за да разбере как работи умението и в какъв контекст да го прилага. Тук описвате какво прави умението, стъпките на неговата работа, очаквания формат на изхода и примери за употреба. Неясно тяло води до непредсказуемо умение; прецизно тяло води до умение, което произвежда един и същи резултат седмица след седмица.

Създайте своето първо умение

Нека изградим умение за генериране на тестове. Започнете със създаването на неговата директория:

mkdir -p ~/.vibe/skills/test-generator

Поставете следния SKILL.md вътре. Обърнете внимание как тялото отговаря на въпроси, които Vibe иначе би трябвало да познае: кой фреймуърк да избере, как да наименува блоковете, къде да запише изходния файл.

---
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.

След като файлът е създаден, умението е незабавно достъпно: няма команда за инсталация, няма рестарт. Стартирайте Vibe и го извикайте върху реален файл.

vibe
# > /test-generator src/utils/math.ts

Vibe зарежда умението, чете неговия SKILL.md, за да разбере очакваното поведение, и изпълнява задачата с разрешените инструменти. Отделете време да прочетете резултата: сравнявайки изхода с това, което сте си представили, ще усъвършенствате тялото на файла.

Най-добри практики

Придържайте се към едно умение за една функция. Смесването на код ревю и генериране на тестове в един единствен файл създава промпт, който се колебае, и ви пречи да деактивирате едното, без да загубите другото. По същия начин, ограничете разрешените инструменти до онези, от които умението наистина се нуждае.

Останалото зависи от качеството на писането. Тялото на SKILL.md е вашият промпт: бъдете прецизни и включете конкретни примери за това какво произвежда умението – един пример за изход струва повече от три реда описание. Накрая, тествайте умението си върху няколко случая, включително един сложен, преди да го споделите с екипа.

Ключови изводи

  • Умението е директория с файл SKILL.md, съдържащ YAML frontmatter
  • Frontmatter дефинира името, описанието, разрешените инструменти и възможността за извикване
  • Markdown тялото служи едновременно като документация и промпт за Vibe
  • user-invocable: true прави умението достъпно чрез слеш-команда
  • Създавайте специализирани умения с минимално необходимите инструменти