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.19.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.19.0
File Size Uploaded
skrepka-0.19.0.tar.gz 576.1 kB Details

Built distribution (wheel)

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

Total release size: 823.7 kB

Release files / skrepka-0.19.0.tar.gz

Download URL skrepka-0.19.0.tar.gz
Size 576.1 kB
Tags Source
SHA-256 checksum
How to use checksums
a7ecda0743b7ffa0222b08b9b953c8a891fab923799c9a3de1a2eb3137eb2911
BLAKE2b-256 checksum
How to use checksums
ad91c509626776ff0f79d9d547412dd38734ba1f4e86456dbc870b23a435f8e0
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 Oct 6, 2026.

Transparency log

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

Download URL skrepka-0.19.0-py3-none-any.whl
Size 247.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7c2846bdb11234d968ee8fffa25cec8687c403a555fdb8722efb1d02d834dead
BLAKE2b-256 checksum
How to use checksums
f02ee8bf53af199e84b027c1f738e4087a4dfa6da6e7faf74254fe13e825ba89
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 Oct 6, 2026.

Transparency log

Release history Release notifications | RSS feed

0.20.1

2 release files

0.20.0

2 release files

This release

0.19.0 This release

2 release files

0.18.0

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