# skill-conventions

Правило skill-conventions задаёт стандарты разработки скиллов: разделяет ручной и автоматический запуск, фиксирует семантику записи данных и правила синхронизации роутера.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 2966 у репозитория
- Автор: Rohit Ghumare
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/rohitg00/pro-workflow/tree/HEAD/rules/skill-conventions.mdc
- Обновлён: 2026-09-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/skill-conventions

## Что делает

Правило внедряет строгие соглашения для всех скиллов внутри воркфлоу. Главное требование — однозначный выбор режима вызова: либо ручной с флагом `user-invocable: true` для действий с побочными эффектами, либо автозапуск агентом по точному описанию задачи. Если условия срабатывания нельзя сформулировать в одном предложении, скилл обязан оставаться ручным.

Для работы с хранилищем фактов, заметок и истории правило вводит три операции: `add` с адресацией по содержимому и апсертом, точечный `update` по найденному идентификатору и `append` для последовательных логов. Скилл, который при повторном запуске плодит дубликаты вместо обновления записи, считается сломанным.

Жизненный цикл навыка делится на три корзины: черновик, релиз и устаревший. Перед добавлением в роутер `skills/skill-router/SKILL.md` файл должен пройти проверку через режим `deslop`: текст умещается на один экран, дублирующих инструкций нет, а описание автозапуска чётко откалибровано.

## Установка

### Cursor (родная платформа)

**Вручную: положить файлы**
- Файл: `.cursor/rules/skill-conventions.mdc` — Во frontmatter: description, globs, alwaysApply

### Claude Code

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add rohitg00/pro-workflow
```
В чате агента (не в терминале):
```text
/plugin install pro-workflow@pro-workflow
```

2. **Вручную: положить файлы**
- Файл: `.claude/rules/skill-conventions.md` — Поле paths во frontmatter ограничивает файлы: globs из источника → paths

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/skill-conventions.instructions.md` — Поле applyTo задаёт, к каким файлам применять: globs из источника → applyTo

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/skill-conventions.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/skill-conventions.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/rohitg00/pro-workflow/tree/HEAD/rules/skill-conventions.mdc

## Когда брать
- Исключить случайные срабатывания скиллов от посторонних фраз в промпте
- Предотвратить дублирование записей при повторном выполнении команд
- Разграничить ручные сценарии и автономные навыки агента
- Поддерживать реестр навыков в актуальном состоянии

## Примеры запросов агенту
- Проверь этот файл навыка на соответствие skill-conventions перед релизом
- Помоги переписать описание скилла, чтобы агент вызывал его только при поиске багов
- Определи семантику записи для сохранения итогов сессии: add, update или append?

## Похожие
- [gstack](https://affpapa.org/nevibecode/skills/gstack.md) — скилл · 24900 установок
- [gsd-next](https://affpapa.org/nevibecode/skills/gsd-next.md) — скилл · 558 установок
- [start](https://affpapa.org/nevibecode/skills/ulpi-io-start.md) — скилл · 152 установки
- [paperthin](https://affpapa.org/nevibecode/skills/paperthin.md) — скилл · 120 установок
- [04-skill-generate](https://affpapa.org/nevibecode/skills/04-skill-generate.md) — скилл · ★ 571 у репозитория
- [abi-and-calling-conventions](https://affpapa.org/nevibecode/skills/abi-and-calling-conventions.md) — скилл · 442 установки

Из того же набора: [rohitg00/pro-workflow](https://affpapa.org/nevibecode/by/rohitg00/pro-workflow.md) — 83 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
