К основному содержанию
скилл CX Codex

review-overleaf — скилл для Claude Code и Codex

Скилл review-overleaf для Claude Code и Codex вытягивает необработанные комментарии рецензентов из Overleaf-проекта, находит их в локальном LaTeX-репозитории и предлагает правки.

Apache-2.0 ★ 1 216 обновлён 2026-11-09

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install overleaf-skills@claude-settings
Открыть на GitHub

Что делает review-overleaf

Скилл работает пошагово: сначала запрашивает ID проекта (можно передать хексовый ID, URL или имя проекта — скилл найдёт его через список), затем вытягивает все нерешённые тред-комментарии через Python-скрипт overleaf.py в JSON. Для каждого комментария, который скилл сумел привязать к строке в локальном .tex-файле, он показывает контекст, предлагает конкретное редактирование текста и применяет его. После всех правок показывает полный git diff и остаток комментариев, которые не удалось локализовать.

Автентификация срабатывает автоматически: скилл ищет сессию в переменной окружения, cookie-файле или логированном Chrome. Если сессия протухла, скилл отправляет к скиллу setup. Для проектов, к которым только чтение, скилл предупредит, что синхронизировать обратно в Overleaf можно только копипастом. С GitHub-синхром Overleaf можно протащить изменение обратно в облако командой --sync-github --compile и загрузить обновлённый PDF.

Скилл не загружает файлы в Overleaf напрямую — только локальное редактирование. Мультистрочные комментарии и ссылки на .bib остаются вне скопа первой версии.

Какие задачи решает

  • вытянуть все открытые комментарии рецензентов из Overleaf в локальный проект
  • найти, на какую строку LaTeX ссылается каждый комментарий
  • применить правки рецензента к исходнику автоматически
  • синхронизировать отредактированный проект обратно в Overleaf через GitHub

Примеры запросов агенту

  • Скажи ассистенту: «Возьми отзывы из моего Overleaf-проекта и примени их локально»
  • «Синхронизируй комментарии рецензентов из проекта с ID 5f3a2b1c0d9e8f7a6b5c4d3e»
  • «Покажи, какие правки предложили в Overleaf на этот LaTeX-документ, и примени их»

Как установить review-overleaf

1Через маркетплейс плагинов

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install overleaf-skills@claude-settings

Команда ставит плагин overleaf-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add fcakyon/claude-codex-settings --skill review-overleaf -a claude-code

3Вручную: положить файлы

~/.claude/skills/review-overleaf/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/review-overleaf/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о review-overleaf

Как установить review-overleaf в Claude Code?

Выполни подряд: /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install overleaf-skills@claude-settings, потом npx skills add fcakyon/claude-codex-settings --skill review-overleaf -a claude-code. Проверь, что файл скилла появился в ~/.claude/skills/review-overleaf/SKILL.md.

Как установить скилл в Codex?

Запусти npx skills add fcakyon/claude-codex-settings --skill review-overleaf -a codex. Скилл установится в .agents/skills/review-overleaf/SKILL.md.

Что произойдёт, если комментарий не найдётся в локальном файле?

Скилл соберёт такие комментарии в отдельный список с предпросмотром текста и doc_id, чтобы ты мог найти их вручную или применить через веб-интерфейс.

Исходный текст

SKILL.md · Apache-2.0
---
name: review-overleaf
description: This skill should be used when user asks to "fetch overleaf review comments", "address overleaf reviews", "apply overleaf comments", "review my overleaf paper", "sync overleaf feedback to local", "what comments are on my overleaf doc", or wants to act on Overleaf reviewer feedback in a local git-tracked LaTeX repo.
---

# Review Overleaf

Pull unresolved review threads from an Overleaf project, locate each in the local repo, propose edits the user reviews, and apply them. Does not push back to Overleaf — the web UI is still the place to mark threads resolved after the user verifies the local change.

Commands use `${CLAUDE_PLUGIN_ROOT}`, this plugin's root. Claude Code fills it in. Codex and Antigravity leave it as written, so replace it with the absolute path two directories above this SKILL.md.

## Step 1: Resolve project ID

Accept any of:

- Raw 24-char hex ID (`^[0-9a-f]{24}$`)
- Full URL like `https://www.overleaf.com/project/<id>`, passed to the script as is
- Project name in quotes — call:
  ```bash
  python3 ${CLAUDE_PLUGIN_ROOT}/scripts/overleaf.py --list-projects
  ```
  Each line is `<24-hex>  <accessLevel>  <name>`. Fuzzy-match the name. If multiple match, AskUserQuestion to disambiguate.

If the user has not given a project ID at all, run `--list-projects` and show the user the table so they can pick one.

## Step 2: Auth

The script finds a session by itself (env var, cookie file, then a logged-in Chrome via `agent-browser`). If any call exits with the refresh hint, point the user at the `setup` skill and stop.

## Step 3: Access-level guard

If the project ID came from name resolution, check the matched entry's `accessLevel`. If `readOnly`, warn:

> Project is read-only. You can edit local files but cannot sync them back to Overleaf via the web UI; you would need to copy-paste manually. Continue?

For `owner`, `readAndWrite`, or `review`, proceed silently.

## Step 4: Fetch comments

```bash
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/overleaf.py --json --repo . < project-id > --unresolved-only
```

Parses to a JSON array. Each record has: `thread_id`, `doc_id`, `snippet`, `offset`, `resolved`, `messages` (list of `{user, ts, content}`), `file`, `line`. The `file` and `line` are null when the snippet did not match any local `*.tex`.

## Step 5: Edit loop

For each record where `file` is non-null:

1. `Read` the file at `line` ± 5 lines for context.
2. Summarize the comment thread in one sentence: who said what.
3. Propose a concrete edit grounded in the comment text. If the comment is a question (e.g., "did you mean X?"), the edit should answer it in the prose; if it's a correction (e.g., "wrong notation"), the edit should make the correction.
4. Apply via `Edit`. Do not batch — one comment, one edit, then move on.

Skip records where `file` is null (snippet did not map). Collect them in an `<unmapped>` list.

## Step 6: Wrap up

After the loop:

1. Run `git diff` and show the user the full set of changes.
2. List the `<unmapped>` records (if any) with `doc_id` + snippet preview, so the user can hunt them manually.
3. Suggest a commit message in the style: `address overleaf review: <one-line summary of the changes>`. Do NOT auto-commit. The user can run `/github-dev:commit-staged` or commit by hand.
4. Remind the user to mark the addressed threads as resolved in the Overleaf web UI once they verify the local diff.
5. If the project has Overleaf GitHub sync and the user pushed the commit, offer to pull it into Overleaf and recompile:

   ```bash
   python3 ${CLAUDE_PLUGIN_ROOT}/scripts/overleaf.py <project-id> --sync-github --compile
   ```

   Prints `SYNC pull <repo> (<n> commit(s))` and `COMPILE <status> (<pages> pages, ..., errors=<n>)`. Add `--download-pdf <path>` to save the PDF, or `--push "<message>"` to push Overleaf-side edits to GitHub instead of pulling.

## Non-goals

- No file uploads to Overleaf. Changes reach Overleaf only through its GitHub sync (`--sync-github`).
- No thread resolution in Overleaf (web UI only).
- No `.bib` edits unless a comment specifically targets a citation.
- No multi-line snippets that span paragraph breaks — those land in `<unmapped>` for v1; the snippet matcher is line-anchored.

## Pairs naturally with

- `github-dev` — `/github-dev:commit-staged` after the edit loop, `/github-dev:create-pr` if the project is collaborative.

© Fatih C. Akyon · Apache-2.0 · fcakyon/claude-codex-settings

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
overleaf-sync wanshuiyin Скилл overleaf-sync для Claude Code синхронизирует локальную папку статьи с проектом Overleaf через Git bridge. Он помогает переносить правки между веб-интерфейсом и локальными ARIS-процессами. CX Codex +1 493установок overleaf-mcp-server YounesBensafia Связывает ИИ-ассистента с проектами Overleaf через Git. Позволяет читать и редактировать статьи прямо из чата. CX Codex +1 ★ 66звёзд репо olcli aloth MCP-сервер olcli управляет проектами Overleaf через ИИ-агента: синхронизирует файлы LaTeX, запускает компиляцию PDF, читает рецензии и правки. CX Codex +1 ★ 270звёзд репо review-delta tirth8205 Скилл review-delta для Claude Code проверяет изменения после последнего коммита и оценивает радиус их влияния. Он делает точечное ревью без загрузки всего проекта. CX Codex +1 1 200установок ds-review-loop aicodeking Скилл ds-review-loop для Claude Code запускает автора и ревьюера в цикле для проверки кода до согласия сторон или исчерпания лимитов. CX Codex +1 548установок posterskill-academic-posters reason-machines Скилл posterskill-academic-posters собирает печатный конференц-постер из исходников статьи в Overleaf. На выходе один HTML-файл с редактором прямо в браузере. CX Codex +1 1 400установок

Из того же набора113

Весь набор →
gcloud-usage Скилл gcloud-usage помогает разбирать логи, метрики и трассировки Google Cloud, а также настраивать фильтры и алерты. Пригодится при отладке проблем в GCP. CX Codex +1 ★ 1 216звёзд репо dokploy-deploy Скилл dokploy-deploy подключает к агенту документацию Dokploy: облачную и self-hosted панель, деплой приложений и Docker Compose, базы, домены и индекс CLI-команд. CX Codex +1 ★ 1 216звёзд репо pr-reviewer Субагент pr-reviewer находит критические баги и проблемы безопасности в пулл-реквестах GitHub через консоль gh без лишнего шума в комментариях. CX Codex ★ 1 216звёзд репо seo-audit Скилл seo-audit для Claude Code и Codex проверяет SEO страницы или сайта и помогает найти причины проблем с ранжированием. Агент разбирает индексацию, элементы страницы и качество контента, затем расставляет проверки по приоритету. CX Codex +1 ★ 1 216звёзд репо setup Скилл setup для Claude Code и Codex настраивает сессионную куку Overleaf для плагина overleaf-skills. Запускается при ошибках авторизации 401 и протухшей сессии. CX Codex +1 ★ 1 216звёзд репо update-readme Команда update-readme для Claude Code и Codex обновляет разделы плагинов в README.md. Она сверяет их с файлами плагинов и данными маркетплейса. CX Codex +1 ★ 1 216звёзд репо openship-deploy Скилл openship-deploy для развёртывания и сопровождения самостоятельного инстанса OpenShip через CLI: деплой приложений, домены, бэкапы, обновления. CX Codex +1 ★ 1 216звёзд репо list-performance-function-references Правило list-performance-function-references запрещает трансформировать массивы перед передачей в виртуализированные списки. Оно заставляет переносить вычисления внутрь элементов, сохраняя стабильные ссылки на данные. CX Codex +1 ★ 1 216звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой