القائمة
Создание и обновление скиллов — генерация, правка и доводка SKILL.md. Использовать при авторинге новых скиллов или ревизии структуры, фронтматтера и инструкций существующих.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Когда нужна короткая демонстрация Agent Skill или проверка команд /skill: в этом проекте.
Реализация утверждённой фичи по PRODUCT.md и TECH.md с поддержанием спек и кода синхронными в одном PR. Использовать после утверждения спек, когда следующий шаг — сборка фичи. Канонический источник правил «спеки и код в одном PR» и «держи спеки актуальными».
Разрешение Git-конфликтов через компактные выжимки (хвосты ours/base/theirs и diff) вместо загрузки целых файлов в контекст. Использовать, когда merge, rebase, cherry-pick или stash pop остановились на конфликтах, git status показывает unmerged paths или в файлах есть маркеры конфликтов.
Ревью diff'а pull request с записью структурированного результата в review.json для публикации workflow'ом. Использовать при ревью выкачанного PR по локальным артефактам pr_diff.txt и pr_description.txt; в GitHub напрямую ничего не постится.
Исполняемый плейбук автономных прогонов roadmap — механика порций, процедура defer/отката, гигиена коммитов, критерии hard stop. Принципы и активация — в .vibe/rules/roadmap-autopilot.mdc.
Spec-first процесс для существенных фич — оркестратор: PRODUCT.md до реализации, TECH.md когда оправдан, реализация по утверждённым спекам. Использовать при старте значимой фичи, планировании агентной реализации или когда спеки нужно хранить в репозитории.
| name | update-skill |
| description | Создание и обновление скиллов — генерация, правка и доводка SKILL.md. Использовать при авторинге новых скиллов или ревизии структуры, фронтматтера и инструкций существующих. |
| vibeVersion | 1.1.0 |
Инструкции по созданию и обновлению скиллов: обязательная структура, фронтматтер, лучшие практики.
Скилл — это каталог в .vibe/skills/ с файлом SKILL.md: YAML-фронтматтер + markdown-тело:
---
name: pdf-processing
description: Извлечение текста и таблиц из PDF, заполнение форм, объединение документов. Использовать при работе с PDF-файлами.
vibeVersion: 1.0.0
---
# Обработка PDF
## Когда использовать
...
## Как извлечь текст
1. Использовать pdfplumber...
add-feature-flag, unit-tests, update-skill.merge, rebase, PRD), если пользователь может писать ими.vibe skills validate).Хорошие описания: см. «Описания» в references/best-practices.md.
Тело — на русском. На английском остаются: код, команды, имена файлов/секций-контрактов (PRODUCT.md, review.json), машинные метки и ключевые термины без устоявшегося перевода.
Типовые секции: заголовок + краткое резюме; Суть/Overview (опционально); основной контент — шаги, процедура, workflow; принципы/Best Practices (опционально); примеры (опционально). Структура гибкая: простой скилл — заголовок + инструкции, без церемоний.
references/, со ссылками из SKILL.md. Скрипты — в scripts/.Выносить в references/, когда: SKILL.md подходит к 200+ строкам; скилл покрывает несколько независимых доменов, загружаемых порознь; справочный материал замусоривает основные инструкции. В SKILL.md остаются только процедура и workflow; схемы, развёрнутые примеры и справочники — в references/.
Скилл и правило (.vibe/rules/*.mdc) не дублируют друг друга: принципы, активация и инварианты — в правиле; пошаговая механика — в скилле. У парного скилла указывать своё правило первой строкой тела (пример: roadmap-autopilot). Конфликт текстов → правило главнее.
Подробное руководство — references/best-practices.md: progressive disclosure, лаконичность, оформление примеров кода, антипаттерны.