review-overleaf

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.

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> — extract via regex
• Project name in quotes — call:

  python3 ${CLAUDE_PLUGIN_ROOT}/scripts/overleaf_reviews.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: Cookie precheck

If ~/.claude/overleaf-skills/cookie does not exist, tell the user to "set up overleaf" (which triggers the setup skill) and stop.

If it exists but auth fails (the next script call returns a refresh hint), point at the same 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?