| name | update-skill |
| description | Создание и обновление скиллов — генерация, правка и доводка SKILL.md. Использовать при авторинге новых скиллов или ревизии структуры, фронтматтера и инструкций существующих. |
| vibeVersion | 1.1.0 |
update-skill
Инструкции по созданию и обновлению скиллов: обязательная структура, фронтматтер, лучшие практики.
Быстрый старт
Скилл — это каталог в .vibe/skills/ с файлом SKILL.md: YAML-фронтматтер + markdown-тело:
---
name: pdf-processing
description: Извлечение текста и таблиц из PDF, заполнение форм, объединение документов. Использовать при работе с PDF-файлами.
vibeVersion: 1.0.0
---
# Обработка PDF
## Когда использовать
...
## Как извлечь текст
1. Использовать pdfplumber...
Требования
Фронтматтер (обязателен)
- name — kebab-case идентификатор (строчные буквы, цифры, дефисы), совпадает с именем каталога. Примеры:
add-feature-flag, unit-tests, update-skill.
- description — конкретное описание: что скилл делает и когда его использовать. Начинать с отглагольного существительного или глагола действия («Разрешение Git-конфликтов…», а не «Помогает с гитом»); сразу за ним — конкретный сценарий использования («Использовать, когда merge остановился на конфликтах»). Третье лицо, без «я помогу». Включать ключевые термины для обнаружения скилла, в том числе английские (
merge, rebase, PRD), если пользователь может писать ими.
- vibeVersion — semver скилла; поднимать при содержательных изменениях.
- depends — опционально: список скиллов-зависимостей (DAG без циклов;
vibe skills validate).
Хорошие описания: см. «Описания» в references/best-practices.md.
Язык
Тело — на русском. На английском остаются: код, команды, имена файлов/секций-контрактов (PRODUCT.md, review.json), машинные метки и ключевые термины без устоявшегося перевода.
Структура скилла
Типовые секции: заголовок + краткое резюме; Суть/Overview (опционально); основной контент — шаги, процедура, workflow; принципы/Best Practices (опционально); примеры (опционально). Структура гибкая: простой скилл — заголовок + инструкции, без церемоний.
Организация файлов
- Простые (≤200 строк): всё в SKILL.md.
- Сложные (>200 строк): детали — в подкаталог
references/, со ссылками из SKILL.md. Скрипты — в scripts/.
Выносить в references/, когда: SKILL.md подходит к 200+ строкам; скилл покрывает несколько независимых доменов, загружаемых порознь; справочный материал замусоривает основные инструкции. В SKILL.md остаются только процедура и workflow; схемы, развёрнутые примеры и справочники — в references/.
Связь с правилами
Скилл и правило (.vibe/rules/*.mdc) не дублируют друг друга: принципы, активация и инварианты — в правиле; пошаговая механика — в скилле. У парного скилла указывать своё правило первой строкой тела (пример: roadmap-autopilot). Конфликт текстов → правило главнее.
Лучшие практики
Подробное руководство — references/best-practices.md: progressive disclosure, лаконичность, оформление примеров кода, антипаттерны.
