git:20260208.f21eb1a to git:20260208.fabf3ce

30 added, 96 removed. Audit A to A.

---

name: notebooklm

- description: "Query and manage Google NotebookLM notebooks with persistent profile auth, source sync, batch/multi queries, and structured exports. Use when user asks to query NotebookLM, manage notebook sources, or automate NotebookLM workflows."

+ description: "Query and manage Google NotebookLM notebooks with persistent profile auth, source sync, batch/multi queries, and structured exports. Use when user asks to query NotebookLM, 'ask my notebook', shares NotebookLM notebook URLs, wants to list/create notebooks, manage sources, do bulk folder sync, dedupe, or audit exports."

---

# NotebookLM Skill

- Use this skill to ask questions against NotebookLM notebooks and manage notebooks/sources through browser automation.

+ Query NotebookLM notebooks and manage notebooks/sources via Playwright browser automation.

- ## When to use

+ All commands run from the skill directory. All scripts output JSON to stdout and exit 1 on error. Use `--help` on any script for full flag reference.

- - User asks to query NotebookLM or "ask my notebook"

- - User shares NotebookLM notebook URLs

- - User wants to list/create notebooks or manage sources

- - User wants bulk folder sync, dedupe, or audit exports

+ ## Workflow

- ## Commands

+ 1. **Authenticate**: `python scripts/auth_manager.py setup --profile <name>`

+ 2. **Register notebook**: `python scripts/notebook_manager.py add --url <url> --name <name> --description <desc> --topics <topics>`

+ 3. **Ask questions**: `python scripts/ask_question.py --question "..." --notebook-id <id>`

+ 4. **Manage sources**: `python scripts/remote_manager.py add-source|sync-sources ...`

- Always run commands from this skill directory.

+ ## Key Behaviors

- ### Authentication

+ - Runs headless by default; use `--show-browser` for debugging only.

+ - Persistent Chrome profiles stored at `~/.config/claude/notebooklm-skill/` (override with `NOTEBOOKLM_DATA_DIR`).

+ - Hash-based dedupe: file uploads skip unchanged sources automatically.

+ - `--dry-run` available on all destructive/bulk operations (create, add-source, delete-source, sync-sources).

+ - `--retries N` retries transient browser failures with screenshot/HTML artifact capture.

+ - Batch mode (`--questions "q1||q2||q3"`) and multi-notebook comparison (`--compare-notebook-ids`) supported.

+ - Exports to JSON or Markdown via `--export-format markdown --save-notes`.

+ - Answers include a follow-up reminder prompting Claude to ask clarifying questions before replying.

+ ## Quick Reference

```bash

- python scripts/auth_manager.py status --profile default

+ # Auth

python scripts/auth_manager.py setup --profile work

- python scripts/auth_manager.py reauth --profile work

- python scripts/auth_manager.py clear --profile work

- python scripts/auth_manager.py clear --all-profiles

- python scripts/auth_manager.py profiles

- ```

- ### Notebook Library

+ python scripts/auth_manager.py status --profile work

- ```bash

+ # Library

+ python scripts/notebook_manager.py add --url "..." --name "..." --description "..." --topics "..."

python scripts/notebook_manager.py list

- python scripts/notebook_manager.py add --url "https://notebooklm.google.com/notebook/..." --name "Notebook Name" --description "What this notebook contains" --topics "topic1,topic2"

- python scripts/notebook_manager.py activate --id notebook-id

- python scripts/notebook_manager.py search --query "keyword"

- python scripts/notebook_manager.py remove --id notebook-id

- python scripts/notebook_manager.py stats

- ```

- ### Ask NotebookLM

- ```bash

- # Single ask (active notebook)

- python scripts/ask_question.py --question "What are the key implementation details?"

- # Ask by notebook ID / URL

- python scripts/ask_question.py --question "Summarize auth flow" --notebook-id notebook-id

- python scripts/ask_question.py --question "What is covered here?" --notebook-url "https://notebooklm.google.com/notebook/..."

- # Batch ask

- python scripts/ask_question.py --questions "q1||q2||q3" --notebook-id notebook-id

- python scripts/ask_question.py --questions-file ./questions.txt --notebook-id notebook-id

- # Compare one question across notebooks

- python scripts/ask_question.py --question "What changed this week?" --compare-notebook-ids "notebook-a,notebook-b"

- # Save structured export

- python scripts/ask_question.py --question "Summarize" --notebook-id notebook-id --export-format markdown --save-notes

- ```

- ### Remote NotebookLM operations

- ```bash

- # List account notebooks

- python scripts/remote_manager.py list-remote --profile work

- # Create notebook remotely

- python scripts/remote_manager.py create-remote --name "My Notebook" --description "What this notebook contains" --topics "topic1,topic2"

- python scripts/remote_manager.py create-remote --name "My Notebook" --skip-library

- python scripts/remote_manager.py create-remote --name "My Notebook" --dry-run

- # List sources

- python scripts/remote_manager.py list-sources --notebook-id notebook-id

- # Add sources

- python scripts/remote_manager.py add-source --notebook-id notebook-id --text "Some source text"

- python scripts/remote_manager.py add-source --notebook-id notebook-id --url "https://example.com"

- python scripts/remote_manager.py add-source --notebook-id notebook-id --file "/path/to/file.pdf"

- python scripts/remote_manager.py add-source --notebook-id notebook-id --dir "/path/to/source-folder" --recursive

- python scripts/remote_manager.py add-source --notebook-id notebook-id --dir "/path/to/source-folder" --include-ext "md,txt" --exclude "*.tmp" --max-size "10MB" --modified-since "7d"

- python scripts/remote_manager.py add-source --notebook-id notebook-id --dir "/path/to/source-folder" --copy-to-temp

- python scripts/remote_manager.py add-source --notebook-id notebook-id --dir "/path/to/source-folder" --dry-run

- # Delete sources

- python scripts/remote_manager.py delete-source --notebook-id notebook-id --source-title "source title"

- python scripts/remote_manager.py delete-source --notebook-id notebook-id --source-title "temp" --contains --all-matches

- python scripts/remote_manager.py delete-source --notebook-id notebook-id --source-title "temp" --contains --all-matches --dry-run

- # Sync local desired state to notebook

- python scripts/remote_manager.py sync-sources --notebook-id notebook-id --dir "/path/to/source-folder" --recursive

- python scripts/remote_manager.py sync-sources --notebook-id notebook-id --dir "/path/to/source-folder" --recursive --delete-missing

- python scripts/remote_manager.py sync-sources --notebook-id notebook-id --manifest ./source-manifest.json --dry-run

- ```

- ### Reliability/debug options

- Use with `ask_question.py` and `remote_manager.py`:

+ # Ask

+ python scripts/ask_question.py --question "..." --notebook-id <id>

+ python scripts/ask_question.py --questions "q1||q2" --notebook-id <id>

- ```bash

- --profile work

- --retries 3

- --artifacts-dir /tmp/notebooklm-artifacts

- --show-browser

+ # Sources

+ python scripts/remote_manager.py add-source --notebook-id <id> --dir ./docs --recursive

+ python scripts/remote_manager.py sync-sources --notebook-id <id> --dir ./docs --recursive --delete-missing --dry-run

```

- ## Expected behavior

- - Runs headless by default unless `--show-browser` is set.

- - Uses persistent auth profile data for reusable login.

- - `add-source` and `sync-sources` support hash dedupe and file filters.

- - Batch and multi query modes return structured JSON (and optional markdown exports).

- - Failures can emit screenshot/HTML diagnostics for debugging.

- - If auth is required, commands tell you to run `auth_manager.py setup`.

+ For full command reference with all flags and examples, see [references/commands.md](references/commands.md).