# Чек-лист скилла: 7 правил

Андрей Пекинский · noonz.ru/skilly

Прогони свой скилл по списку, прежде чем отдавать его в работу.

## Как он устроен

- [ ] **Описание решает всё.** В описании есть, что делает скилл и когда его звать.
      Словами, которыми ты реально просишь. Настойчиво: «используй всегда, когда…,
      даже если не прозвучало слово …».
- [ ] **SKILL.md короче 500 строк.** Подробности вынесены в `references/`, а в SKILL.md
      написано, какой файл когда читать: «ставки — смотри references/bids.md».
- [ ] **Скрипт вместо текста.** Расчёты, выгрузки и сборка отчётов лежат в `scripts/`,
      а не описаны словами. Код скрипта не тратит контекст — он просто запускается.
- [ ] **Есть источники.** Ссылки на документацию и API, файлы-примеры, ловушки, на которые
      ты уже наступал, и формат готового результата.

## Как он проверен

- [ ] **Собран через /skill-creator.** 2–3 тестовых запроса, каждый прогнан со скиллом
      и без. Сравнил токены и время — видно, что со скиллом лучше.
- [ ] **Финальный прогон через ai-agent-discipline.** Скилл отработал на живых данных,
      каждый результат открыт, есть честный отчёт: что работает, что нет, что не проверено.
- [ ] **Нет очевидного и капса.** В тексте только то, чего Claude не знает сам. Вместо
      «ОБЯЗАТЕЛЬНО» — объяснение, почему это важно.

## Лайфхаки

- Уже сделал задачу в чате руками? Напиши «сделай из этого чата скилл» — skill-creator
  вытащит шаги, твои правки и формат ответа сам.
- В тестах Claude каждый раз пишет один и тот же вспомогательный код? Это знак, что
  его пора положить в `scripts/`.
- Скилл не срабатывает, когда должен? Почти всегда дело в описании, а не в теле скилла.