Skip to main content
skill CX Codex

setup · fcakyon, overleaf-skills — Claude Code skill: what it does, how to install

setup — a skill for Claude Code and Codex that configures and refreshes Overleaf session tokens for overleaf-skills. Runs when requests return 401 unauthorized or expired sessions.

Apache-2.0 ★ 1,216 updated 2026-11-09

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install overleaf-skills@claude-settings
Open on GitHub

What setup does

The skill executes overleaf.py --check-auth to test current credentials. The script checks OVERLEAF_COOKIE, inspects ~/.claude/overleaf-skills/cookie, and attempts reading overleaf_session2 directly from Chrome using agent-browser. If the local host has no desktop browser, it can inspect a remote instance configured via OVERLEAF_CHROME_SSH_HOST.

When browser automation fails, it walks through DevTools steps across Chrome, Firefox, and Safari. The target row must be overleaf_session2 with an underscore, because legacy overleaf.session2 entries with a dot are rejected. The cookie carries the HttpOnly flag, which means document.cookie in DevTools console returns empty, leaving the Storage panel as the only viable source.

The input step validates the payload against an 80-character threshold, strips quotes, and confirms the s%3A prefix. A value starting with s%3Ac%3A1%3A gets flagged as an unauthenticated guest session. After checks pass, it creates a backup copy, writes the token to ~/.claude/overleaf-skills/cookie, applies chmod 600, and runs another auth test.

What it helps with

  • resolve 401 unauthorized errors in Overleaf integrations
  • extract active overleaf_session2 cookies from Chrome over SSH
  • validate pasted session tokens against anonymous guest patterns
  • safely store session files with restricted 600 permissions

Example prompts for the agent

  • Set up overleaf session cookie
  • Fix overleaf auth failed with 401 unauthorized
  • Help me refresh my overleaf_session2 cookie

How to install setup

1Plugin marketplace

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

This installs the whole overleaf-skills plugin with all its skills

2Skills CLI (Vercel)

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

3Manually: put the files in place

~/.claude/skills/setup/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/setup/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about setup

How to install setup in Claude Code?

Run /plugin marketplace add fcakyon/claude-codex-settings, then run /plugin install overleaf-skills@claude-settings.

What does setup do?

It verifies Overleaf credentials using overleaf.py, fetches cookies through Chrome if accessible, or guides manual entry into ~/.claude/overleaf-skills/cookie.

Why does Codex require path adjustments?

Claude Code populates ${CLAUDE_PLUGIN_ROOT} automatically, but Codex leaves the variable unexpanded, so you must point to the absolute path two levels above SKILL.md.

Source text

SKILL.md · Apache-2.0
---
name: setup
description: This skill should be used when user asks to "set up overleaf", "configure overleaf cookie", "overleaf auth failed", "overleaf 401", "overleaf session expired", "overleaf unauthorized", or needs to install or refresh their Overleaf session cookie for the overleaf-skills plugin.
---

# Overleaf Skills Setup

Make sure `overleaf.py` can authenticate. It tries `OVERLEAF_COOKIE`, then `~/.claude/overleaf-skills/cookie`, then reads `overleaf_session2` from a logged-in Chrome through `agent-browser` and saves it to the cookie file. The Chrome is the local one, or the one on the SSH host named by `OVERLEAF_CHROME_SSH_HOST` when this machine has no Chrome. Pasting a cookie by hand is the last resort.

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: Status check

```bash
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/overleaf.py --check-auth
```

- If `OK <email>`: report "Configured, logged in as <email>." Done.
- If it exits non-zero with the refresh hint: ask the user to log into overleaf.com in Chrome (on the `OVERLEAF_CHROME_SSH_HOST` machine when set), then rerun the check. If it still fails, or the user has no Chrome with `agent-browser` access, continue to Step 2.

## Step 2: Show browser guide

Tell the user to grab the cookie from their browser. Give all three branches; pick none for them:

**Chrome / Edge / Brave / Arc:** `Cmd+Option+I` (mac) or `F12` → **Application** tab → **Storage → Cookies → https://www.overleaf.com** → row where Name = `overleaf_session2` → double-click Value cell → `Cmd+A` → `Cmd+C`.

**Firefox:** `F12` → **Storage** tab (enable in DevTools settings if hidden) → **Cookies → https://www.overleaf.com** → click `overleaf_session2` row → right-click → **Copy Value**.

**Safari:** Enable Develop menu (**Settings → Advanced → Show features for web developers**), then `Cmd+Option+I` → **Storage** → **Cookies → www.overleaf.com** → click `overleaf_session2` row → copy from right-hand detail pane.

Add three warnings at the bottom:

1. The row name is `overleaf_session2` (UNDERSCORE). A row named `overleaf.session2` (DOT) is a stale legacy cookie that will not authenticate.
2. The cookie is `HttpOnly` — `document.cookie` in the JS console returns empty for it. The storage panel is the only path.
3. The value should start with `s%3A` and be ~80+ chars. If it starts with `s%3Ac%3A1%3A`, you're logged out — log into overleaf.com and re-grab.

## Step 3: Capture

Use AskUserQuestion: "Do you have your `overleaf_session2` cookie value ready?" with options "Yes, paste it now" and "Skip for now". The user pastes via the "Other" free-text field.

## Step 4: Validate

Normalize the input: strip whitespace; if it does NOT start with `overleaf_session2=`, prepend it (accept bare value).

Reject (re-prompt with reason):

- Starts with `overleaf.session2=` → "Overleaf renamed this cookie to `overleaf_session2` (underscore). Re-grab the underscore row."
- Value (after the `=`) starts with `s%3Ac%3A1%3A` → "That's an anonymous-visitor cookie. Log into overleaf.com first, then re-grab."
- Value does not start with `s%3A` after the `=` → "Doesn't look like an Overleaf session cookie. Confirm you copied from the `overleaf_session2` row on www.overleaf.com."
- Total length under 80 chars → "Cookie looks truncated. Re-copy with `Cmd+A` inside the Value cell."
- Contains newlines or quotes → "Strip the surrounding quotes/newlines."

## Step 5: Write

```bash
mkdir -p ~/.claude/overleaf-skills
[ -f ~/.claude/overleaf-skills/cookie ] && cp ~/.claude/overleaf-skills/cookie ~/.claude/overleaf-skills/cookie.backup
# Write the normalized value (one line, no trailing newline beyond what's natural)
printf '%s\n' "<normalized-cookie>" > ~/.claude/overleaf-skills/cookie
chmod 600 ~/.claude/overleaf-skills/cookie
```

## Step 6: Verify

```bash
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/overleaf.py --check-auth
```

- If `OK <email>`: report "Configured. Logged in as <email>." Done.
- If it exits non-zero: restore from `cookie.backup` if it exists (`mv ~/.claude/overleaf-skills/cookie.backup ~/.claude/overleaf-skills/cookie`), tell user the new cookie did not authenticate, loop back to Step 2.

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

setup by other authors comes first.

setup official anthropics setup is a Claude Code skill that checks connected tools, learns your writing style from sent email, and builds a starter dashboard without a questionnaire. For first run. CX Codex +1 371installs setup Alireza Rezvani setup sets up an autoresearch experiment by collecting its target file, evaluation command, metric, and optimization direction. Use it before starting an optimization loop. CX Codex +1 1,480installs setup aws This skill kicks off the connection setup for AWS DevOps Agent and AWS Security Agent. Reach for it when MCP tools go missing or you are wiring the toolkit up for the first time. CX Codex +1 1,600installs setup marketcalls setup sets up a Python backtesting environment with VectorBT and OpenAlgo. It configures the virtual environment, installs dependencies, and prepares .env. CX Codex +1 2,100installs setup assistant-ui setup is a Claude Code skill that installs and configures assistant-ui through its CLI. It covers new projects, existing Next.js apps, and package updates. CX Codex +1 6,400installs setup-browser-cookies garrytan setup-browser-cookies is a Claude Code skill that imports cookies from a local Chromium browser into a headless session. Runs when logging into test environments. CX Codex +1 379installs posterskill-academic-posters reason-machines posterskill-academic-posters turns an Overleaf paper into a print-ready conference poster. The result is one HTML file with a drag-and-drop editor built in. CX Codex +1 1,400installs browser-auth-flow ruvnet browser-auth-flow drives your login flow once, then probes it for redirect leaks, missing CSRF tokens, weak session cookies and OAuth mistakes. Writes a findings.md with a verdict. CX Codex +1 690installs overleaf-sync wanshuiyin overleaf-sync connects a local paper directory with an Overleaf project through Git and rsync. Use it when edits move between the Overleaf web UI and local ARIS workflows. CX Codex +1 493installs latex-conference-template-organizer Galaxy-Dawn latex-conference-template-organizer turns cluttered conference LaTeX zip archives into a clean, Overleaf-ready project structure. It helps prepare a fresh paper draft by stripping out sample text and messy comments. CX Codex +1 403installs olcli aloth olcli connects AI coding assistants to Overleaf projects to edit LaTeX files, run cloud compilation, download PDFs, and inspect comments. CX Codex +1 ★ 270repo stars

From the same set113

The whole set →
dokploy-deploy dokploy-deploy hands the agent Dokploy's own docs: cloud and self-hosted setup, app and Compose deploys, databases, domains, plus a CLI command index. CX Codex +1 ★ 1,216repo stars pr-reviewer The pr-reviewer subagent for Claude Code inspects GitHub pull requests for security flaws and breaking bugs using the gh CLI, without cluttering reviews. CX Codex ★ 1,216repo stars seo-audit The seo-audit skill for Claude Code and Codex audits pages for search visibility and investigates ranking problems. It checks crawl and index signals, page elements, content, and the order of follow-up checks. CX Codex +1 ★ 1,216repo stars review-overleaf review-overleaf — a skill for Claude Code and Codex that pulls unresolved reviewer comments from an Overleaf project, locates each in your local LaTeX repository, and proposes edits. CX Codex +1 ★ 1,216repo stars update-readme update-readme — a command for Claude Code and Codex rebuilds the plugin sections in README.md. It reads the plugin folders and marketplace data. CX Codex +1 ★ 1,216repo stars openship-deploy openship-deploy — a skill for running and maintaining a self-hosted OpenShip instance from the CLI: app deploys, domains, backups, upgrades. CX Codex +1 ★ 1,216repo stars list-performance-function-references list-performance-function-references instructs the AI agent to keep object references stable in virtualized lists. It prevents full list re-renders by moving state derivation into child items. CX Codex +1 ★ 1,216repo stars server-hoist-static-io The server-hoist-static-io rule for Claude Code and Codex moves static asset I/O to module scope, loading files once instead of on every server-function request. CX Codex +1 ★ 1,216repo stars

Project sponsors

Companies that keep this analytics open