Skip to main content

skrepka 📎

ИИ-соавтор в Google Документах. Агент работает из вашего терминала прямо в документе: читает комментарии, отвечает на них и правит текст на месте.

In English · Приватность · Безопасность

Зачем

Работа над текстом с ИИ обычно идёт в двух окнах: документ и чат с агентом. Скопировать абзац в чат, вставить ответ обратно, руками починить оформление. Пока текст ходит туда-сюда, теряются правки и комментарии.

skrepka убирает это копирование. Вы оставляете по тексту обычные комментарии: про структуру, логику, формулировки. Потом зовёте агента в документ, он читает треды, отвечает и правит текст на месте. Заказчик приходит, комментирует там же, работа продолжается тем же способом. Комментарии при этом не рвутся: даже когда прокомментированный абзац переписан целиком, тред остаётся и переезжает на новый текст. Где сделать это безопасно нельзя, skrepka отказывает по одной операции, называет причину и правит остальной документ — что именно она не делает. Закрывает треды только человек.

Для кого

Редакторам, копирайтерам и контент-менеджерам, которые ведут и согласовывают тексты в Google Docs, а к работе подключают ИИ-агента: Claude Code, Codex или другого. Быть разработчиком не нужно, доступ к Google настраивает мастер skrepka init.

Что умеет

Главный сценарий — разобрать комментарии. Вы говорите агенту «отработай комментарии», он читает треды, отвечает по делу и вносит правки в текст.

Кроме этого skrepka выгружает документ в markdown и заливает правки обратно, создаёт документы из markdown и разбирает предложенные правки. Полный список сценариев — в docs/PLUGIN.md.

Как это выглядит

Работу ведёт агент, но команды видны, и вот весь цикл:

skrepka comments DOC --output comments.json     # прочитать треды
skrepka patch DOC ops.json --dry-run            # примерить правки
skrepka patch DOC ops.json                      # применить
skrepka reply DOC --file replies.json           # ответить в треды

Третья строка — единственная, которая меняет документ. Вторая говорит по каждой правке, что с ней будет, и не пишет ничего: примерить дёшево, поэтому пробовать можно без риска. Треды при этом остаются живыми, а закрывает их человек.

Как начать

Нужен macOS или Linux: защиты файлового ввода-вывода опираются на механизмы Unix, Windows не поддержан.

  1. Поставьте skrepka: pipx install skrepka.
  2. Настройте доступ к Google: skrepka init. Первая настройка занимает 15–30 минут, инструкция со снимками экрана — в docs/QUICKSTART.md.
  3. Подключите навыки к агенту: docs/PLUGIN.md.

Дальше попросите агента отработать комментарии в тестовом документе.

Вы заводите собственный проект Google Cloud и работаете от своего имени. У skrepka нет сервера и телеметрии: автор skrepka ваших документов и токенов не видит. Подробности в PRIVACY.md.

Документация

Файл Что внутри
docs/QUICKSTART.md Настройка доступа к Google по шагам
docs/PLUGIN.md Навыки для Claude Code и Codex
docs/LIMITATIONS.md Что skrepka не делает
docs/LIMITATIONS-TECHNICAL.md То же подробно: команды, коды причин, поведение API
PRIVACY.md Какие данные и куда идут
SECURITY.md Модель угроз и как сообщить об уязвимости

Лицензия

MIT

Metadata

Release files for skrepka 0.18.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for skrepka 0.18.0
File Size Uploaded
skrepka-0.18.0.tar.gz 569.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for skrepka 0.18.0
File Interpreter ABI Platform
skrepka-0.18.0-py3-none-any.whl Python 3 none any Details

Total release size: 815.5 kB

Release files / skrepka-0.18.0.tar.gz

Download URL skrepka-0.18.0.tar.gz
Size 569.0 kB
Tags Source
SHA-256 checksum
How to use checksums
33a0314fece31ccc35bc7a950e4bc26349037581bac09914ee0ec35a839b2b99
BLAKE2b-256 checksum
How to use checksums
bd451bba41b8e02915655232360b09e7392f61e5e751ca0991ac8b7d74493135
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / skrepka-0.18.0-py3-none-any.whl

Download URL skrepka-0.18.0-py3-none-any.whl
Size 246.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c306d4a60beb0670066feb2cf97fd45310f228d46505ae2c24a28d2c38fde4a3
BLAKE2b-256 checksum
How to use checksums
519eb34373ed197ebe3af4cf951374559c285fdf02444177ed559074dd6872f6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release history Release notifications | RSS feed

0.20.1

2 release files

0.20.0

2 release files

This release

0.18.0 This release

2 release files

0.17.0

2 release files

0.16.1

2 release files

0.16.0

2 release files

0.15.0

2 release files

0.14.0

2 release files

0.13.0

2 release files

0.12.0

2 release files

0.11.0

2 release files

0.9.2

2 release files

0.9.1

2 release files

0.9.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page