Учим агента нормально презентовать свои идеи
Бесплатный скилл для Codex и Claude Code, который сэкономит вам кучу нервных клеток.
$ cat plan.md
Обычно нейронка пишет план как-то так
Все три проверяющих закончили. От вас нужно три решения, остальное — правки, на которые нужен ваш «ок».
Нужно решить
1. Напоминания о занятиях. Рекомендую слать утром по времени ученика.
- Сейчас бот проверяет расписание раз в 5 минут и шлёт напоминание за 12 часов до занятия по московскому времени. Поэтому часть учеников получает его ночью.
- Предлагаю спрашивать город при регистрации и ставить напоминание на 10:00 по времени ученика.
- Если город не указан — по Москве.
- При перезапуске бота напоминания не теряются и не дублируются.
- Минус: в регистрации появится ещё один вопрос. Вы этого не просили.
2. Что делать с теми, кто не оплатил.
- Вариант А: через 3 дня закрываем доступ к чату.
- Вариант Б: оставляем доступ, но раз в неделю напоминаем.
- При Б ограничу число напоминаний, иначе бота начнут блокировать.
- Текст напоминания тоже стоит поменять, сейчас он звучит как претензия.
3. Кнопка «Перенести занятие». Можно дать ученику переносить самому, но только если до занятия больше суток…
Правки, которые внесу, если вы не против
- Тексты сообщений. Убираю «Уважаемый клиент», обращение на «вы»…
- Админка.
- в списке учеников появится колонка «Оплачено до»;
- ученики без оплаты подсвечиваются;
- фильтр по группам…
- Таблица проверок. Добавляю проверки двойного нажатия на «Оплатить», смены часового пояса…
…и ещё три экрана. В конце: «Ваше решение по пунктам 1–3? И „ок“ на правки?»
Я не понимаю, че ты хочешь, объясни нормально
В этих бесконечных списках фиг разберёшься!
$ diff было стало
Скилл учит агента объяснять по-человечески
Вместо полотна текста в чате агент собирает HTML-файл, где наглядно объясняет, что и зачем предлагает поменять, как оно будет устроено.
К любому пункту вы можете оставить комментарий прямо в файле, агент его учтёт.
Простым языком
Не «вебхук и грейс-период», а что изменится для вас и ваших учеников.
Оплата и доступ к чату. Подключу вебхук ЮKassa: после успешного платежа бот выставляет ученику дату окончания доступа и сразу выдаёт инвайт-ссылку в чат.
- Раз в сутки по крону бот проверяет, у кого доступ истёк, и с грейс-периодом 3 дня исключает из чата.
- Инвайт-ссылки делаю одноразовыми, чтобы их нельзя было переслать.
- Ручную выдачу через админку оставлю как запасной вариант.
СейчасУченик оплатил, а в чат его добавляете вы руками. Иногда только на следующий день.
СтанетБот пришлёт ссылку на чат сразу после оплаты. Если ученик не продлил, ещё 3 дня он в чате, потом бот его уберёт и пришлёт ссылку на оплату.
Например: Аня оплатила в 23:40. Через минуту у неё в телеграме ссылка на чат, а вы в это время спите.
Показывать, а не рассказывать
Что можно показать, агент показывает: кадр, скриншот, варианты рядом.
Субтитры в роликах. Сейчас они стоят слишком низко: на телефоне их частично закрывает подпись к ролику, а справа — кнопки лайка и комментариев.
- Предлагаю поднять их примерно до уровня груди и сделать уже, чтобы не заходили под кнопки.
- Карточки с картинками сдвину выше, чтобы между ними и субтитрами оставался зазор.
- Верхний отступ не трогаю.
Зелёная рамка — тут субтитры видно всегда.
Красная — тут их закроют подпись к ролику и кнопки.
Всё в одном месте
Не «файл 1 — такой, файл 2 — такой», а картинка, описание и вопрос рядом.
Сделал три варианта обложки для уроков, сохранил в папку covers/:
cover-1.png— тёмный фон, крупный белый заголовок, номер урока в углу;cover-2.png— светлый фон, фото преподавателя справа, заголовок слева;cover-3.png— оранжевый фон, заголовок по центру.
Мне больше нравится второй: с фото на обложку обычно кликают охотнее. Посмотрите файлы и скажите, какой берём или что поменять.
Тёмнаястрого, хорошо читается
УРОК 3Воронка продаж за вечерС фотоживее, видно, кто ведёт
рекомендуюЯркаязаметна в ленте
Какую обложку берём для всех уроков?
С фото, только заголовок покрупнее
Коротко и понятно
Не полотно с промптами и подробностями, а главное в трёх строках.
Обновил инструкцию для ИИ-ассистента в боте. Вот новая версия целиком:
Ты — дружелюбный ассистент онлайн-школы. Отвечаешь ученикам на вопросы о расписании, оплате и доступе к урокам. Обращайся на «вы», пиши коротко, без эмодзи. Если ученик просит вернуть деньги, не обещай возврат и не называй сроки. Ответь, что передал вопрос куратору, и вызови функцию escalate_to_curator с текстом вопроса. Если не знаешь ответа, не придумывай. Предложи написать куратору…
Что изменилось по сравнению с прошлой версией:
- добавил блок про возвраты — раньше модель сама обещала вернуть деньги;
- убрал фразу «будь максимально полезным», из-за неё бот додумывал ответы;
- уточнил тон: коротко и на «вы».
Как проверил: прогнал 12 тестовых вопросов учеников. 1) «Когда следующий урок?» — ответ верный. 2) «Верните деньги за курс» — бот передал куратору. 3) «Не открывается урок 4» — …
…и ещё два экрана
Бот перестал обещать ученикам возврат денег
СейчасНа «верните деньги» бот отвечает «конечно, вернём», хотя решаете это вы.
СтанетБот ответит «передал куратору» и перешлёт вопрос вам.
Проверил на 12 вопросах учеников, ответы нормальные. Полный текст инструкции покажу, если попросите.
Комментарий к каждому предложению
Не «что из этого согласовываем?» в конце простыни, а поле для ответа под каждым пунктом.
По неоплатившим ученикам предлагаю:
- Через 3 дня после окончания оплаты бот убирает ученика из чата.
- За день до этого бот присылает предупреждение со ссылкой на оплату.
- После оплаты бот сам возвращает ученика в чат, без вас.
- В админке появляется список тех, кто не продлил.
- Текст напоминания делаю мягче, сейчас он звучит как претензия.
- Раз в неделю бот присылает вам сводку: кто ушёл, кто вернулся.
Что из этого согласовываем?
-
Не оплатил — через 3 дня бот убирает из чата
Рекомендую. Еженедельные напоминания раздражают.
Да, но пусть за день предупредит
-
Оплатил снова — бот сам возвращает в чат
Рекомендую. Без вас, сразу после оплаты.
Ок
-
Раз в неделю сводка: кто ушёл, кто вернулся
Не уверен. Полезно, но это ещё одно сообщение каждую неделю.
Ваш комментарий
$ ./install.sh
Как установить
Скачайте скилл
Архивом или из репозитория на GitHub.
- 1Откройте Claude Code или Codex.
- 2Напишите «Установи скилл из этого архива» и приложите файл.
- 3Когда агент принесёт план, попросите: «покажи наглядно» или «упакуй в страницу».
Обычные вопросы и короткие планы агент по-прежнему пишет в чат. Страницу он собирает, только когда вы попросили показать наглядно.
Нужны Claude Code или Codex и Python 3.7 или новее.
Что нового в версии 1.0.3
Первая версия. Скилл учит агента показывать планы и решения не полотном текста в чате, а наглядной страницей: варианты рядом, разметка поверх настоящих скриншотов, «как сейчас — как будет» простыми словами. Под каждым пунктом поле для комментария. Агент читает ответы, правит страницу и берётся за работу только по вашей команде. Работает в Claude Code и Codex, страница открывается у вас на компьютере и никуда не отправляется.
$ cat faq.md
Частые вопросы
Это правда бесплатно?
Да. Скилл лежит на GitHub под лицензией MIT: можно использовать в своих и коммерческих проектах и менять под себя.
Страница уходит в интернет?
Нет. Агент открывает её у вас на компьютере, а ваши комментарии сохраняются в файл рядом со страницей.
Для каких задач подходит?
Для любых, где агент приносит план: бот, сайт, автоматизация, монтаж роликов. Агент покажет вёрстку на скриншотах, схему процесса, варианты рядом или звук в одном плеере.
У меня уже есть свои скиллы. Они не сломаются?
Нет. Этот скилл ставится рядом и включается, только когда вы просите показать план наглядно.