Custom skills як workflow-артефакти

Коли prompt стає skill

Custom skill доречний, коли вдалий prompt перетворився на повторювану процедуру зі стабільним типом входу, передбачуваним результатом, подібною послідовністю кроків і перевіркою якості.

Якщо контекст щоразу радикально різний або prompt доводиться переписувати, процедуру ще рано пакувати.

Мінімальний контракт skill

1. Опишіть, коли його застосовувати.
2. Визначте потрібні вхідні дані.
3. Назвіть артефакт, який має зʼявитися.
4. Зафіксуйте заборонені дії.
5. Опишіть, як перевірити результат.

сирий issue
   ↓
issue-analysis
   ↓
TASK_SPEC.md
   ↓
перевірка та погодження плану
   ↓
окрема реалізація

Skill має зупинятися до реалізації

Приклад `issue-analysis` перетворює баг на `TASK_SPEC.md`: goal, scope, non-goals, affected modules, критерії приймання, спосіб перевірки та відкриті питання. Він не редагує код і не починає реалізацію.

Така межа зберігає розділення між аналізом задачі, погодженням плану та виконанням.

Рівні поширення

Типові помилки

• робити skill універсальним набором інструкцій;
• дублювати правила з CLAUDE.md;
• змішувати аналіз, кодування, ревʼю та документацію;
• поширювати недозрілий workflow на всі проєкти;
• створювати skill без перевірюваного результату.