assistant-skills/gmail-browser/SKILL.md

name	description	version
gmail-browser	Read Gmail emails and threads using a persistent authenticated Chromium session. Use when asked to read, review, or extract content from a Gmail URL.	1.0.0

Gmail Browser

Read Gmail emails via Playwright using a saved auth session (no manual login required).

Auth State

Saved at: ~/notes/skills/.playwright-auth/google.json

If the session has expired (redirects to Google sign-in), run the re-auth flow below.

Reading an Email

# Start a named session with saved auth
playwright-cli -s=gmail open --persistent 2>&1 &
sleep 5
playwright-cli -s=gmail state-load ~/notes/skills/.playwright-auth/google.json
playwright-cli -s=gmail goto "<gmail_url>"

# Extract full email body text
playwright-cli -s=gmail eval "Array.from(document.querySelectorAll('.a3s')).map(el => el.innerText).join('\n\n---\n\n')"

# Close when done
playwright-cli -s=gmail close

Re-Auth Flow (if session expired)

playwright-cli -s=gmail open --persistent --headed "https://accounts.google.com"
# User logs in manually in the browser window
playwright-cli -s=gmail state-save ~/notes/skills/.playwright-auth/google.json
playwright-cli -s=gmail close

Notes

• The .a3s CSS class is Gmail's email body container.
• The session is saved with --persistent so cookies survive restarts as long as state-load is called.
• Auth state path is gitignored — do not commit it.