setup · fcakyon, overleaf-skills — скилл для Claude Code: что делает и как установить
Скилл setup для Claude Code и Codex настраивает сессионную куку Overleaf для плагина overleaf-skills. Запускается при ошибках авторизации 401 и протухшей сессии.
Apache-2.0 ★ 1 216 обновлён 2026-11-09
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install overleaf-skills@claude-settingsЧто делает setup
Скилл проверяет авторизацию через overleaf.py --check-auth. Скрипт по очереди опрашивает переменную OVERLEAF_COOKIE, файл ~/.claude/overleaf-skills/cookie и запущенный Chrome через agent-browser. Если на рабочей машине нет браузера, сессию можно достать с удалённого хоста через OVERLEAF_CHROME_SSH_HOST.
Когда автоматический вход не срабатывает, скилл ведёт по шагам ручного копирования из инструментов разработчика Chrome, Firefox или Safari. Нужна именно строка overleaf_session2, а старое имя overleaf.session2 с точкой скрипт сразу отбрасывает. Кука защищена флагом HttpOnly, поэтому через консоль document.cookie её получить нельзя: значение копируется только из вкладки Storage.
Перед сохранением скилл проверяет префикс s%3A и длину не менее 80 символов: префикс s%3Ac%3A1%3A означает анонимного пользователя без входа в аккаунт. Готовый токен записывается в ~/.claude/overleaf-skills/cookie с правами 600, а предыдущий файл временно сохраняется в резервную копию.
Какие задачи решает
- починить ошибку 401 и обновить протухшую сессию Overleaf
- проверить текущий статус авторизации через
overleaf.py - извлечь сессионную куку из Chrome локально или по SSH
- провалидировать формат и длину куки
overleaf_session2перед записью
Примеры запросов агенту
- Настрой сессию overleaf, авторизация упала с 401
- Проверь статус логина в Overleaf через cookie
- Помоги обновить сессионную куку overleaf_session2
Как установить setup
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 setup -a claude-code3Вручную: положить файлы
~/.claude/skills/setup/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/setup/
1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill setup -a codex2Вручную: положить файлы
.agents/skills/setup/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill setup -a cursor2Вручную: положить файлы
.cursor/skills/setup/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fcakyon/claude-codex-settings plugins/overleaf-skills/skills/setup2Вручную: положить файлы
.github/skills/setup/SKILL.md1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill setup -a gemini-cli2Командой платформы
gemini skills install https://github.com/fcakyon/claude-codex-settings --path plugins/overleaf-skills/skills/setupВручную: положить файлы
.devin/skills/setup/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о setup
Как установить setup в Claude Code?
Выполните обе команды маркетплейса: сначала /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install overleaf-skills@claude-settings.
Что делает скилл setup?
Он проверяет статус входа в Overleaf, пытается вытащить сессию из браузера или помогает вручную вставить и сохранить проверенную куку в файл ~/.claude/overleaf-skills/cookie.
Почему нельзя скопировать куку через document.cookie в консоли?
Кука overleaf_session2 защищена флагом HttpOnly. Браузер скрывает её от JavaScript, поэтому скопировать значение можно только из вкладки Storage в инструментах разработчика.
Исходный текст
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
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — setup от других авторов.