SKILL.md: анатомія і виклик skill

`SKILL.md` — контракт, а не нотатки

`SKILL.md` має пояснювати іншій людині призначення, тригер, вхід, процес, результат і заборони skill. Його читають як опис workflow, який можна переглянути, версіонувати та підтримувати.

Точні назви frontmatter-полів і синтаксис виклику можуть відрізнятися між версіями Claude Code, тому актуальну форму перевіряйте через `/help` та документацію.

---
name: issue-analysis
description: Готує TASK_SPEC.md з issue та evidence.
when_to_use: Коли потрібно спочатку проаналізувати issue.
---

# Мета

## Вхід

## Кроки

## Результат

## Заборони

## Перевірка

Що має бути в skill

Приклад issue-analysis

• вхід: текст issue, посилання на файли та за потреби логи;
• процес: знайти повʼязані модулі, визначити goal, scope, non-goals і ризики;
• результат: заповнений TASK_SPEC.md з evidence та відкритими питаннями;
• заборона: не редагувати код і не починати реалізацію;
• перевірка: наявні goal, scope, non-goals, acceptance criteria та verification plan.

Права мають відповідати призначенню

Для аналітичного skill достатньо читання й пошуку. Не надавайте йому доступ до редагування всього проєкту без необхідності. Новий або неперевірений skill краще запускати вручну, а автоматичні пропозиції додавати лише після стабілізації.

Перевірка чужого `SKILL.md`

1. Зʼясуйте, коли skill запускається.
2. Перевірте, що він отримує на вході.
3. Знайдіть очікуваний артефакт.
4. Прочитайте заборони та доступні інструменти.
5. Переконайтеся, що права відповідають призначенню.
6. Порівняйте процес із патернами самого репозиторію.