BrandDocs — плагин
Плагин с тремя скиллами изучает ваш шаблон Word, PowerPoint или Excel и создает новые документы в том же фирменном стиле
- 287 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает Python-движок, читает ваши шаблоны и записывает готовые документы на диск
- Скрипт настройки визуальной проверки ставит в систему LibreOffice и Poppler
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/branddocsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает Python-движок, читает ваши шаблоны и записывает готовые документы на диск
- Скрипт настройки визуальной проверки ставит в систему LibreOffice и Poppler
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
BrandDocs состоит из трех скиллов: `brand-docx` для Word, `brand-pptx` для PowerPoint и `brand-xlsx` для Excel. Вы показываете агенту один фирменный файл `.docx`, `.pptx` или `.xlsx`. Скилл извлекает из него цвета и шрифты темы, именованные стили, порядок разделов, макеты, логотипы и таблицы и сохраняет все это как профиль бренда. Новые документы собираются на оболочке исходного шаблона и используют только то, что в шаблоне определено. Генератор не записывает буквальные имена стилей, цвета и шрифты. Значения берутся из профиля. Команда `verify` отклоняет профиль, ссылающийся на отсутствующий в шаблоне элемент. В Excel сохраняются формулы и числовые форматы бренда, в PowerPoint используются настоящие мастера и макеты, а встроенные диаграммы остаются нативными. Конвертации между форматами нет. Движок работает без модели и офлайн, а шаги с участием модели лишь называют уже извлеченные факты. Первый документ по новому шаблону занимает до 15 минут вместе с проверкой, следующие создаются из сохраненного профиля за секунды. Если шаблонов несколько, `extract --blend` дополняет профиль вторым, а `compare-profiles` показывает расхождения между профилями.
Для кого. Для сотрудников компаний, которым нужны регулярные отчеты, презентации, таблицы и письма строго в корпоративном шаблоне.
Подходит, если
- Нужно писать отчеты и записки в корпоративном шаблоне Word, не перенося текст вручную
- Презентации должны собираться из настоящих мастеров и макетов вашего образца, с диаграммами и таблицами
- В книге Excel заполняются именованные области, а формулы и числовые форматы должны уцелеть
- Брендбук хранится только в виде готового файла, и из него нужен переиспользуемый профиль
- Профили двух шаблонов нужно сравнить в CI, чтобы заметить расхождение цветов и шрифтов
Не подходит, если
- Нет фирменного шаблона: скилл учится по готовому файлу и без образца не работает
- Нужен перенос документа из одного формата в другой, например Word в PowerPoint: конвертации в проекте нет
- Требуется свободный дизайн вне шаблона, ведь генерация использует только артефакты образца
- Нужна стабильность уровня релиза для PowerPoint и Excel: автор называет проект альфа-версией, а Word надежнее остальных
Пример запроса к агенту
Возьми наш шаблон company-report.docx и напиши по нему отчет о результатах квартала, сохрани как q3-report.docxОграничения
Проект в альфа-стадии, версия 0.10.1. Лучше других отработан Word, PowerPoint и Excel используют тот же движок и догоняют его по зрелости. Схема профиля заморожена, профили продолжают работать между релизами.
Нужны Python версий с 3.10 по 3.13 и пакеты из `requirements.txt`: `python-docx`, `python-pptx`, `openpyxl`, `lxml`, `Pillow`. Визуальная проверка использует LibreOffice и Poppler, Tesseract нужен по желанию для распознавания текста. Без них генерация проходит с проверками низшего уровня. Установить все можно командой `bash scripts/setup_visual_qa.sh`, а состояние покажет `python scripts/brandkit/cli.py doctor`.
Устанавливать нужно весь репозиторий: папка одного скилла без общего движка в `scripts/brandkit/` не заработает.
Как отключить. В Claude Code отключите плагин через `/plugin`. Для Codex удалите три символические ссылки `brand-docx`, `brand-pptx` и `brand-xlsx` из `~/.codex/skills` и при желании папку `~/.codex/brand-docs`. Сохраненные профили лежат в проекте или в пользовательской папке, их можно удалить отдельно.
Частые вопросы
Как поставить BrandDocs в Claude Code?
Выполните `/plugin marketplace add ferdinandobons/brand-docs`, затем `/plugin install brand-docs@brand-docs`. Плагин загружает все три скилла вместе с общим движком. После установки подготовьте Python-пакеты и проверьте окружение командой `python scripts/brandkit/cli.py doctor`.
Как подключить BrandDocs к Codex?
Клонируйте репозиторий в `~/.codex/brand-docs`, создайте виртуальное окружение и поставьте пакеты из `requirements.txt`. Затем сделайте символические ссылки на `brand-docx`, `brand-pptx` и `brand-xlsx` в `~/.codex/skills`. Если скиллы не появились, перезапустите агента.
Что такое профиль бренда?
Это файл, куда команда `extract` записывает факты шаблона: цвета и шрифты темы, стили, структуру, макеты, якоря обложки, логотипы и таблицы. Дальше генератор берет оформление только оттуда. Профиль можно проверить командой `verify` и улучшить командами `learn`, `propose-overrides` и `refine`.
Можно ли попробовать без собственного шаблона?
Да. В репозитории лежит синтетический образец `examples/templates/branddocs_template.docx`, рядом такие же файлы `.pptx` и `.xlsx`. По ним можно пройти извлечение, проверку и генерацию.
Уходят ли мои документы в облако?
Облачный сервис не нужен: работа идет локально. Реальные шаблоны в репозитории исключены из git. Данные видит только модель вашего агента, если вы просите ее сочинить текст документа.
Почему первый документ делается долго?
На новом шаблоне запускаются извлечение, необязательный разбор моделью, написание содержимого и визуальная проверка с возможным исправлением. Вместе это до 15 минут. Дальше профиль уже сохранен, и документы создаются за секунды.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныСкилл верстает по шаблонам резюме, одностраничники, письма, отчеты и слайды в PDF, PNG и PPTX и проверяет результат скриптами до выдачи
CLI для создания и правки Word, Excel и PowerPoint агентом: один бинарник без установки Office и без сторонних библиотек
CLI и скилл, через которые агент создает, читает, конвертирует и редактирует настоящие файлы docx, xlsx и pptx локально
Скилл для конвертации Markdown в Word и обратно через Pandoc с готовыми шаблонами оформления и Lua-фильтрами
Скилл и CLI превращают Markdown в DOCX, PDF, PPTX, XLSX, PNG и еще десяток форматов, все считается локально
Скилл-конвейер документов: что угодно в markdown, markdown в аккуратный html и docx уровня издательства, html обратно в markdown
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| BrandDocs (эта запись) | нет | 287 | |
| Dashi PPT | нет | 10 141 | делает презентацию из документа в редактируемой HTML-колоде и не учит фирменный шаблон |
| vkr-docx: оформление ВКР по ГОСТ 7.32-2017 | нет | 0 | оформляет главы ВКР по ГОСТ, а не по вашему шаблону |
Коротко о README
README объясняет идею, называет три скилла и общий набор шагов: извлечение, разбор, проверка, генерация. Дальше идут требования, установка для Claude Code и Codex, быстрый старт и статус проекта.