fcakyon/claude-codex-settings / plugins/overleaf-skills/skills/setup
setup
UnverifiedThis 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
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/overleaf.py --check-auth
- If
OK <email>: report "Configured, logged in as ." 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_HOSTmachine when set), then rerun the check. If it still fails, or the user has no Chrome withagent-browseraccess, 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:
- The row name is
overleaf_session2(UNDERSCORE). A row namedoverleaf.session2(DOT) is a stale legacy cookie that will not authenticate. - The cookie is
HttpOnly—document.cookiein the JS console returns empty for it. The storage panel is the only path. - The value should start with
s%3Aand be ~80+ chars. If it starts withs%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 tooverleaf_session2(underscore). Re-grab the underscore row." - Value (after the
=) starts withs%3Ac%3A1%3A→ "That's an anonymous-visitor cookie. Log into overleaf.com first, then re-grab." - Value does not start with
s%3Aafter the=→ "Doesn't look like an Overleaf session cookie. Confirm you copied from theoverleaf_session2row on www.overleaf.com." - Total length under 80 chars → "Cookie looks truncated. Re-copy with
Cmd+Ainside the Value cell." - Contains newlines or quotes → "Strip the surrounding quotes/newlines."
Step 5: Write
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
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/overleaf.py --check-auth
- If
OK <email>: report "Configured. Logged in as ." Done. - If it exits non-zero: restore from
cookie.backupif 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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |