review-overleaf — скилл для Claude Code и Codex
Скилл review-overleaf для Claude Code и Codex вытягивает необработанные комментарии рецензентов из Overleaf-проекта, находит их в локальном LaTeX-репозитории и предлагает правки.
Apache-2.0 ★ 1 216 обновлён 2026-11-09
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install overleaf-skills@claude-settingsЧто делает 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-code3Вручную: положить файлы
~/.claude/skills/review-overleaf/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/review-overleaf/
1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill review-overleaf -a codex2Вручную: положить файлы
.agents/skills/review-overleaf/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill review-overleaf -a cursor2Вручную: положить файлы
.cursor/skills/review-overleaf/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fcakyon/claude-codex-settings plugins/overleaf-skills/skills/review-overleaf2Вручную: положить файлы
.github/skills/review-overleaf/SKILL.md1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill review-overleaf -a gemini-cli2Командой платформы
gemini skills install https://github.com/fcakyon/claude-codex-settings --path plugins/overleaf-skills/skills/review-overleafВручную: положить файлы
.devin/skills/review-overleaf/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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