overleaf-project-sync

Compare local LaTeX directories with Overleaf project ZIPs and update files.

7|1|Updated May 9, 2026
One-click install
npx skills add https://github.com/black-yt/skills --skill overleaf-project-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: overleaf-project-sync
Source: https://github.com/black-yt/skills/tree/main/overleaf-project-sync
Command: npx skills add https://github.com/black-yt/skills --skill overleaf-project-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you compare a local LaTeX or paper directory with an Overleaf project, then safely pull remote files into the local workspace when the remote version should become the source of truth.

Core Features & Use Cases

  • Browser-session based download: Uses the current logged-in Overleaf session cookie to fetch a project ZIP without storing credentials in the repository.
  • Safe compare and update workflow: Supports dry-run checks first, then explicit overwrite-based updates only when you confirm the changes.
  • Repository-friendly synchronization: Preserves local-only files, avoids unsafe ZIP extraction paths, and encourages Git verification after syncing.
  • Use Case: You have been editing a paper in Overleaf and need to confirm whether your local directory matches the cloud version before merging the latest remote changes.

Quick Start

Ask the assistant to compare your current local paper folder against a specific Overleaf project and report the differences before any overwrite is performed.

Frequently Asked Questions about overleaf-project-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync LaTeX projects from Overleaf to a local directory?

Overleaf project synchronization compares your local directory with a remote project ZIP, then updates local files from the remote source when needed using a browser session cookie for safe, clean syncing.

Can I use my browser cookie to download an Overleaf project ZIP without storing credentials?

Yes, Overleaf project sync uses your current logged-in browser session cookie to fetch a project ZIP without storing credentials in the repository, ensuring safe and clean synchronization.

What is the best way to check differences between local LaTeX files and Overleaf before overwriting?

The best way to check differences is a dry-run comparison, which reports differences between your local paper folder and the Overleaf project before any explicit overwrite-based updates are performed.

Does Overleaf project sync preserve local-only files during the ZIP extraction process?

Yes, Overleaf project sync preserves local-only files and avoids unsafe ZIP extraction paths by applying ignore-rule handling and optional overwrite-based file copying to maintain repository integrity.

Do I need a download URL and session cookie to compare local LaTeX manuscripts with Overleaf?

Yes, comparing local LaTeX manuscripts with Overleaf requires an Overleaf download URL and a browser-copied session cookie to fetch the ZIP file for temporary extraction and diff checking.