Smart Illustrator

中文文档

🆕 v1.4.0 — Трёхдвижковая система (февраль 2026)

Новый движок Excalidraw для рукописных концептуальных диаграмм. Трёхуровневый приоритет: Gemini → Excalidraw → Mermaid. Все движки теперь выводят PNG по умолчанию. Подробнее →

Интеллектуальный Skill для Claude Code для иллюстрирования статей с трёхдвижковой системой: автоматически выбирает Gemini (для креативных изображений), Excalidraw (для рукописных диаграмм) или Mermaid (для структурных схем) в зависимости от типа контента.

Статус

Статус: Экспериментальный

• Это публичный прототип, который работает для демонстраций, но пока не охватывает все масштабы входных данных и граничные случаи.
• Качество вывода зависит от версии модели и структуры входных данных; результаты могут варьироваться.
• Основная цель — демонстрация того, как инструменты и системы работают вместе, а не поддержка кодовой базы.
• При возникновении проблем, пожалуйста, предоставьте воспроизводимый кейс (входной файл + выходной файл + шаги воспроизведения).

Зачем Smart Illustrator?

Создание иллюстраций для статей — трудоёмкий процесс: ручной дизайн занимает часы, стоковые фото лишены контекста, а универсальные ИИ-инструменты не понимают структуру статьи. Smart Illustrator сочетает интеллектуальное определение позиций, трёхдвижковую систему (Gemini + Excalidraw + Mermaid) и обучение на обложках, чтобы генерировать контекстные иллюстрации за считанные минуты.

Для кого: Авторы рассылок, YouTube-креаторы, технические блогеры, преподаватели курсов.

Когда использовать: Когда нужны качественные иллюстрации для статей, превью для YouTube с учётом лучших практик или единый визуальный стиль для серии материалов.

Предыстория: версия на Make (авто-иллюстрирование + публикация в WeChat)

До упаковки в Skill уже был создан сквозной Make-воркфлоу: поиск → написание → авто-иллюстрирование → форматирование/публикация (WeChat Official Account).

Полный разбор (логика воркфлоу и архитектурные решения): https://youtu.be/TbyJ3imLuXQ

Возможности

• Трёхдвижковая система: автоматически выбирает Gemini, Excalidraw или Mermaid в зависимости от типа контента
• Умное определение позиций: анализирует структуру статьи для поиска оптимальных мест вставки иллюстраций
• 10+ типов иллюстраций: flowchart, sequence, mindmap, concept, comparison, scene, metaphor и другие
• Расширяемая система стилей: Light, Dark, Minimal, Cover и пользовательские стили
• Режим обложки: генерация YouTube-превью с высоким CTR и встроенными лучшими практиками
• Размеры для разных платформ: пресеты для YouTube, WeChat, Twitter, Xiaohongshu
• Возобновление генерации: пропуск уже созданных изображений, повторная генерация отдельных
• Настройка бренда: изменяйте styles/ для применения фирменного стиля
• Несколько бэкендов: Gemini API для креативных изображений (разрешение 2K), Excalidraw для рукописных диаграмм, Mermaid CLI для структурных схем — все выводят PNG по умолчанию

Что такое Skills?

Skills — это расширения на основе промптов для Claude Code, которые дают Claude специализированные возможности. В отличие от MCP-серверов, требующих сложной настройки, Skills — это простые markdown-файлы, которые Claude загружает по запросу.

Установка

Требования

• Установленный Claude Code CLI
• Среда выполнения Bun (для скриптов)
• Mermaid CLI (для диаграмм Mermaid): npm install -g @mermaid-js/mermaid-cli
• Зависимости для экспорта Excalidraw (опционально, для диаграмм Excalidraw): cd ~/.claude/skills/smart-illustrator/scripts && npm install && npx playwright install firefox
• Gemini API Key (опционально, для креативных изображений): https://aistudio.google.com/apikey

Вариант A: Ручная установка (рекомендуется)

# Клонировать в директорию Skills для Claude Code
git clone https://github.com/axtonliu/smart-illustrator.git ~/.claude/skills/smart-illustrator

Вариант B: Копирование отдельных файлов

# Если нужен только skill без скриптов
cp -r smart-illustrator/SKILL.md ~/.claude/skills/smart-illustrator/
cp -r smart-illustrator/styles ~/.claude/skills/smart-illustrator/

Использование

Базовое использование

# Анализ статьи и автогенерация иллюстраций (по умолчанию)
/smart-illustrator path/to/article.md

# Вывод только промптов без генерации изображений
/smart-illustrator path/to/article.md --prompt-only

# Указать стиль (загружается из директории styles/)
/smart-illustrator path/to/article.md --style light     # Светлый стиль (по умолчанию)
/smart-illustrator path/to/article.md --style dark      # Тёмный технический стиль
/smart-illustrator path/to/article.md --style minimal   # Минималистичный стиль

# Список доступных стилей
/smart-illustrator --list-styles

# Без обложки
/smart-illustrator path/to/article.md --no-cover

# Указать количество иллюстраций
/smart-illustrator path/to/article.md --count 5

Параметры