| name | telegraph-article |
| description | Написание статей для Telegraph (Telegram). Используй когда нужно написать статью для Telegraph. |
Telegraph Article Writer
Скилл для написания статей в Telegraph от имени Игоря Масленникова.
Когда использовать
- Пользователь просит написать статью для Telegraph
- Нужна длинная статья для Telegram-аудитории
- Контент слишком большой для обычного поста, но не тянет на Хабр
Платформа: Telegraph
Аудитория: Telegram-пользователи, подписчики канала
Тон: Разговорный, прямой, без академизма — как рассказываешь коллеге за кофе
Длина: 5,000-15,000 символов
Язык: Русский
Культура Telegraph
Аудитория
- Кто читает: Подписчики Telegram-каналов — предприниматели, разработчики, менеджеры, технически грамотные люди. Не обязательно глубокие технари, но понимают контекст.
- Где читают: 67% — с мобильного телефона. Остальные — с десктопного Telegram. Почти никто не открывает Telegraph в отдельном браузере специально.
- Как читают: Быстрый скроллинг. Решение "читать или закрыть" — за 3-5 секунд. Если первые два абзаца не зацепили — закроют. Дочитывают до конца ~30-40% открывших.
- Ожидания: Конкретика, опыт, цифры. Не хотят читать учебник — хотят узнать, как сделал ты.
Что работает на Telegraph
- Короткие абзацы (2-3 предложения максимум)
- Чёткая визуальная структура: заголовки, разделители, воздух между блоками
- Личный опыт и конкретные примеры
- Прямая речь автора — "я сделал", "мы попробовали", "вот что получилось"
- Цифры и результаты в начале, а не в конце
- Мобильно-удобные блоки: короткие строки, без горизонтального скролла
Что НЕ работает на Telegraph
- Длинные академические абзацы (5+ предложений — стена текста на мобильном)
- Сложные таблицы (ломаются на мобильном)
- Развёрнутые блоки кода (syntax highlighting нет, длинный код нечитаем)
- Абстрактные рассуждения без примеров
- Заголовки длиннее 60 символов (обрезаются в превью)
- "Вводная часть" на 3 экрана до сути
Тон общения
- Как в личном разговоре — не лекция, не доклад
- Короткие мысли — одна идея = один абзац
- Безжалостно к воде — каждое предложение должно нести смысл
- Допустима незавершённость — "это мы ещё тестируем, результаты потом"
- Прямота — без "с одной стороны / с другой стороны"
ФАЗА 0: ИНТЕРВЬЮ С АВТОРОМ (ОБЯЗАТЕЛЬНО!)
Перед написанием — задай автору 3-4 вопроса. Telegraph-статьи короче хабровских, но без живого контекста они мгновенно опознаются как AI-генерат.
ФАЗА 0.1 — Загрузить правила живого письма
Before any drafting, invoke Skill('living-text-style') and keep its rules in
context for ФАЗА 1–2. This is the preventive layer — write right the first time;
the detective layer (cleanup-ai-noise in ФАЗА 3) catches what slipped through.
Do not skip this step. Skipping degrades draft quality and inflates ФАЗА 3
cleanup cost.
Выбери релевантные:
- Что случилось: "Расскажи конкретную ситуацию — что за проект, что пошло не так, что получилось?"
- Реакция: "Что тебя удивило / бесило / порадовало в процессе? Какая была первая реакция?"
- Цифры: "Есть конкретные числа — сроки, стоимость, сколько раз переделывали?"
- Вывод для читателя: "Что бы ты посоветовал тому, кто столкнулся с такой же задачей? Одним предложением."
Зачем это нужно: Telegraph-аудитория особенно чувствительна к "синтетике". Они привыкли к живому авторскому тону в каналах. AI-генерат бросается в глаза мгновенно — нет деталей, нет эмоций, всё слишком гладкое.
Если автор не может ответить — предупреди: "Без личного опыта статья будет выглядеть как пересказ документации. Telegraph-аудитория такое не читает."
Полученные ответы вплетай в текст как конкретные детали и микро-истории, а не как абстрактные утверждения.
ФАЗА 1: ВЫБОР СТРУКТУРЫ (НЕ ШАБЛОН!)
КРИТИЧНО: Каждая статья должна иметь УНИКАЛЬНУЮ структуру. Не копируй формат предыдущей.
Варианты зачинов (выбери один, чередуй между статьями):
A) Быстрая личная история:
"В четверг утром клиент написал: 'нужен магазин к понедельнику'. Я подумал — нереально. Через 6 дней магазин работал."
B) Дерзкое утверждение:
"AI не заменит разработчиков. Но 3 разработчика + AI заменят 15 без него."
C) Результат вперёд:
"Было: 2 месяца и 500К. Стало: 6 дней и 100К. Рассказываю как."
D) Вопрос-крючок:
"Что будет, если дать 44 AI-агентам работать параллельно? Мы попробовали — вот что вышло."
Строительные блоки (комбинируй свободно, НЕ используй все):
- Личная предыстория / боль (короткая, 2-3 абзаца)
- Суть решения (без занудного теоретического обоснования)
- Конкретный кейс с цифрами
- Что не сработало / грабли
- Результат до/после (список или пара предложений — не таблица)
- Мнение / позиция автора
- Ссылки на инструменты
- Контакты автора
Правила комбинирования:
- Используй 4-6 блоков, не все
- Порядок блоков — из логики статьи, не из шаблона
- Секции должны быть РАЗНОЙ длины (от 1 абзаца до 5)
- НЕ каждая статья нуждается в "Итого" или списке результатов
- На мобильном длинная секция = потеря читателя. Максимум 5 абзацев подряд без подзаголовка
Форматирование Telegraph
Доступно
# Заголовок (H1)
## Подзаголовок (H2)
**жирный**
_курсив_
[ссылка](url)
- Списки (- или *)
- Цитаты (>)
- Код (`)
- Изображения
НЕ доступно
- Spoiler-блоки
- Сложные таблицы (только простейшие)
- Syntax highlighting
- Встроенное видео (только ссылки)
- Кастомные шрифты или цвета
Заголовки для Telegraph (формулы)
Работающие формулы:
- Цифра + результат: "E-commerce за 6 дней: как мы это сделали"
- Как + конкретика: "Как настроить Claude Code за 5 минут"
- Что + результат: "Что случилось, когда мы дали AI вести 5 проектов"
- Провокация: "Почему ваш разработчик стоит дороже, чем нужно"
- Прямой опыт: "Мы попробовали X — вот честный результат"
Правила:
- Максимум 60 символов (длиннее — обрезается в Telegram-превью)
- Без кликбейта уровня "ШОК! Вы не поверите!"
- Конкретика бьёт абстракцию: "за 6 дней" лучше чем "быстро"
- Без двоеточия в начале: "Заголовок: подзаголовок" — OK, но не злоупотреблять
ФАЗА 2: НАПИСАНИЕ (АНТИ-AI ГИГИЕНА)
Лимиты форматирования (ЖЁСТКИЕ!)
| Элемент | Максимум на статью |
|---|
| Bullet-списки | 4 |
| Блоки кода | 3 |
| Жирные абзацы (целиком bold) | 5 |
| Цитаты | 3 |
Правило 70/30: Минимум 70% текста — связная проза. Максимум 30% — форматированные блоки (код, списки, цитаты). На Telegraph форматирование ограничено, поэтому основная сила — в тексте. Если получается больше 30% форматированных блоков — перепиши в прозу.
Анти-AI гигиена при написании
Базовая дисциплина: пиши конкретно, варьируй ритм, не используй штампы. Полный каталог запрещённых паттернов (27 категорий + штампы проекта + telegraph-специфика — правило 70/30, мобильная читаемость) и автоматическая чистка — в агенте ai-text-checker, который запускается в ФАЗА 3 через skill cleanup-ai-noise. Здесь — только напоминания:
- Никаких «В современном мире...», «давайте рассмотрим», «важно отметить»
- Никаких «революционный/game-changer», «значительно/существенно», «уникальный/инновационный»
- Никаких «данный подход позволяет оптимизировать», «в результате внедрения достигнуты»
- Короткие абзацы (≤3 предложений) — на мобильном длинные абзацы убивают чтение
См. ФАЗА 3 → автоматическая чистка через cleanup-ai-noise.
Структурные маркеры (НИКОГДА не повторять между статьями):
- Одинаковый формат контактов — ВАРЬИРОВАТЬ каждый раз
- Одинаковая концовка "Итого" с bullet-списком — ВАРЬИРОВАТЬ
- Фиксированный формат "Пишу про AI-агентов..." — ВАРЬИРОВАТЬ подпись
Обязательные элементы "живости"
1. Истории (минимум 1-2 на статью):
Не нужен роман — достаточно 2-3 предложений с конкретикой:
Не "Мы используем AI-агентов для ускорения" — а:
"На прошлой неделе запустили 7 агентов параллельно на e-commerce проект.
Один агент залип на TypeScript-ошибке и потратил 200k токенов впустую.
Остальные шесть сделали работу за день."
2. Эмоциональные реакции (минимум 2-3 на статью):
Варианты (чередуй, не повторяй одни и те же):
- Удивление: "Я не ожидал.", "Серьёзно?"
- Раздражение: "Это раздражало.", "Два часа на ерунду."
- Самоирония: "Да, мы это сделали. Нет, не горжусь."
- Прямота: "Не работает. Пробовали."
3. Ритм коротких абзацев (2-3 предложения максимум):
На мобильном длинный абзац = стена текста. Правило:
Плохо:
"AI-агенты позволяют автоматизировать рутинные задачи разработки,
такие как написание тестов, code review, рефакторинг. При правильной
настройке команда из 3-5 человек может выполнять работу, которая
раньше требовала 10-15 специалистов. Это достигается за счёт
параллельной работы агентов, каждый из которых специализируется
на конкретной области."
(Один абзац — 5 предложений. На мобильном это непрерывная стена.)
Хорошо:
"AI-агенты берут на себя рутину: тесты, review, рефакторинг.
3-5 человек делают работу, которая раньше требовала 15.
Не потому что люди стали умнее — потому что агенты работают параллельно.
Каждый агент — узкий специалист. Один гоняет тесты, другой ищет баги,
третий пишет документацию."
(Три коротких абзаца. Воздух между ними. Легко скроллить.)
4. Минимум 1 отступление (tangent):
Боковая мысль, ассоциация, мини-комментарий в скобках:
"(Забавно: мы потратили больше времени на настройку агентов,
чем они потом — на весь проект. Классика автоматизации.)"
Структурные антипаттерны (чего НЕ делать)
- НЕ начинай каждую секцию с определения: "X — это технология, которая..."
- НЕ заканчивай каждую секцию выводом: "Таким образом, X позволяет..."
- НЕ чередуй секции одинаковой длины — варьируй
- НЕ ставь bullet-список в каждую вторую секцию
- НЕ используй "переходные" предложения: "Перейдём к следующему пункту"
- НЕ пиши "Заключение" как заголовок последней секции
- НЕ пересказывай документацию — дай ссылку и добавь свой опыт
- НЕ балансируй: имей позицию, не "с одной стороны / с другой"
ФАЗА 3: ПОСТ-ПРОВЕРКА (ОБЯЗАТЕЛЬНО!)
После написания — два этапа: автоматическая чистка и ручной чек-лист.
Шаг 1: Автоматическая чистка AI-шума (ОБЯЗАТЕЛЬНО)
Запусти skill cleanup-ai-noise с параметром platform=telegraph. Скилл сохранит черновик в .tmp/current/articles/, прогонит агента ai-text-checker (27 паттернов + штампы проекта + telegraph-специфика — правило 70/30, мобильная читаемость) и вернёт отчёт с правками + спорные места. Только после автоправки — переходи к ручному чек-листу.
Чеклист "Не робот" (Telegraph)
Если 3+ пунктов не пройдены — перепиши.
Секция контактов
Включай в конце, но ВАРЬИРУЙ формулировку каждый раз. Не копируй блок из предыдущей статьи.
Данные:
Примеры разных формулировок (чередуй, придумывай свои):
Вариант 1: "Пишите в @maslennikovig — обсудим."
Вариант 2: "Инструменты — на GitHub. Вопросы — в Telegram @maslennikovig."
Вариант 3: Вплести в последний абзац без отдельного блока:
"Исходники лежат на GitHub, а если хотите попробовать на своём проекте —
пишите в @maslennikovig, расскажу подробнее."
Вариант 4: Минималистично — только ссылки, без подводки:
Telegram: @maslennikovig
GitHub: github.com/maslennikov-ig/claude-code-orchestrator-kit
Метрики (актуальные данные)
При написании используй актуальные метрики:
- Команда: 54 специалиста + 44 AI-агента (3-7 человек на проект)
- Экономия: -80% стоимости
- Скорость: 1-2 недели вместо 2-3 месяцев
- Параллелизация: 5-7 проектов одновременно
Метрики вплетай в текст естественно, не вываливай все сразу списком.
Примеры
Технический туториал
# Как настроить Claude Code за 5 минут
Вы скачали Claude Code, но работаете "из коробки"?
Потратьте 5 минут на настройку — сэкономите часы.
---
## Шаг 1: Создайте settings.json
Откройте терминал и выполните:
`mkdir -p .claude && touch .claude/settings.json`
## Шаг 2: Добавьте базовые настройки
Скопируйте в файл:
{
"plansDirectory": "./docs/plans",
"enableAllProjectMcpServers": true,
"permissions": {
"allow": ["Bash(npm:*)", "Bash(git:*)"]
}
}
## Шаг 3: Проверьте
Запустите `claude` — теперь без вопросов "Allow?".
---
3 настройки = минус 50 кликов в день.
Telegram: @maslennikovig
Бизнес-кейс
# E-commerce за 6 дней: как мы это сделали
Клиент написал: интернет-магазин с каталогом, корзиной, оплатой.
Бюджет ограничен, сроки — "вчера".
Обычная команда: 30 дней, 5 человек, 500К.
Мы: 6 дней, 3 человека + AI-агенты, 100К.
---
## День 1-2: Архитектура
[Описание с конкретикой]
## День 3-4: Разработка
[Описание с цифрами и граблями]
## День 5-6: Тестирование
[Описание с результатами]
---
6 дней. 100К. Работающий магазин.
Хотите так же? Пишите: @maslennikovig
Метаданные
---
platform: telegraph
title: "[Заголовок — до 60 символов]"
author: Igor Maslennikov
date: [YYYY-MM-DD]
length: ~[N] characters
telegram_channel: https://t.me/maslennikovigor
language: ru
---
Сохранение файла
articles/telegraph/[slug].md
Где [slug] — короткое описание темы через дефис.
Публикация
- Скопировать контент
- Открыть telegra.ph
- Вставить и отформатировать
- Опубликовать
- Поделиться ссылкой в канале https://t.me/maslennikovigor
Источники