Deckuse CLI
Deckuse, CLI и скилл для агентов, правит PPTX и DOCX локально командами JSON с версиями рабочей папки, проверкой и откатом.
- 105 ★ репозитория
- Последний коммит
- AGPL-3.0
Минимальный доступ
Почему такой уровень
- Правки пишутся в рабочую папку и пересобирают документ; исходный файл остается отдельно.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/deckuseОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Правки пишутся в рабочую папку и пересобирают документ; исходный файл остается отдельно.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Deckuse открывает документ Office в версионируемую рабочую папку и дает агенту править его через смысловые адреса вроде `slide:1/shape:2`. Каждая успешная запись создает ревизию Git, дописывает `operations.jsonl` и пересобирает пакет. Готовы адаптеры PPTX и DOCX, а XLSX, Keynote и Numbers возвращают `FORMAT_NOT_IMPLEMENTED`. Цикл такой: `init` или `new`, затем `list` и `get`, правки `set` и `add`, `validate`, `export`. Есть `undo`, `history`, пакетное применение `apply`, живой просмотр `monitor` и снимок слайда в PNG командой `render`. Скилл в `skills/deckuse/SKILL.md` объясняет единицы, адреса и частые рецепты.
Для кого. Разработчикам и аналитикам, которые поручают агенту обновлять готовые презентации и документы Word без пересборки с нуля.
Подходит, если
- В квартальной презентации обновляют даты, цифры и цены.
- Из одного файла делают варианты под разные рынки с проверяемыми правками.
- Ищут устаревший или чувствительный текст по документу и проверяют каждое совпадение.
- Автоматическую правку нужно уметь откатить командой `undo`.
Не подходит, если
- Нужно оценить, красиво ли выглядит слайд: движок не судит о верстке.
- Правят таблицы XLSX, Keynote или Numbers.
- Документ нельзя хранить в рабочей папке с историей Git.
Пример запроса к агенту
Открой `report.pptx` в рабочей папке, замени дату на втором слайде и итоговую цифру на пятом, проверь результат и экспортируй `report-v2.pptx`.Ограничения
Это community-редакция, коммерческая надстройка закрыта. Движок не отрисовывает слайды полноценно, поэтому внешний вид проверяют через `render` и глазами. Нужен Node.js 18 или новее. Лицензия AGPL-3.0 накладывает условия на сетевое использование и распространение изменений. Скилл требует CLI версии 1.2.0 или новее. Перед рассылкой измененного файла откройте его в PowerPoint или Word и просмотрите вручную.
Как отключить. Удалите пакет командой `npm uninstall -g @deckflow/deckuse` и каталог скилла из `.cursor/skills/deckuse/`. Рабочие папки документов удалите отдельно.
Частые вопросы
Какие форматы поддерживаются?
PPTX и DOCX. Адаптеры XLSX, Keynote и Numbers возвращают `FORMAT_NOT_IMPLEMENTED`.
Как откатить неудачную правку?
Выполните `deckuse undo --workspace ./workspace --steps 1`. Историю смотрите командой `history`.
Можно ли начать без готового файла?
Да. Команда `deckuse new ./workspace` создает рабочую папку из встроенного пустого шаблона 16:9.
Как посмотреть результат?
`deckuse monitor` открывает живой просмотр в браузере, `render` сохраняет один слайд в PNG.
Нужна ли отдельная установка скилла?
Да. CLI ставится через npm, а каталог `skills/deckuse` копируют в каталог скиллов агента.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыУтилита создает презентации PPTX, документы DOCX, таблицы XLSX, отчеты и картинки по текстовому запросу из терминала или скрипта.
Скилл и программа docx: агент заполняет формы, правит таблицы и ведет рецензирование Word с отслеживаемыми правками
Скилл собирает редактируемые PowerPoint-колоды из outline.json скриптами и проверяет верстку и плотность до выдачи файла.
Скилл делает агента продюсером презентаций: бриф, раскадровка, постеры слайдов, проверка и PDF или редактируемый PPTX.
CLI на Rust проверяет PDF, Office и iWork без открытия и возвращает JSON с числом страниц, слайдов и признаками безопасности.
Скилл для сборки презентаций из HTML-слайдов с рендером, визуальной проверкой каждого слайда и конвертацией в редактируемый PPTX
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
Коротко о README
README есть на восьми языках, включая русский. Движок сохраняет нетронутый XML и неизвестные части пакета, насколько это возможно.