Ai-skills notebooklm

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.

install

source · Clone the upstream repo

git clone https://github.com/sanjay3290/ai-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sanjay3290/ai-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/notebooklm" ~/.claude/skills/sanjay3290-ai-skills-notebooklm && rm -rf "$T"

manifest: skills/notebooklm/SKILL.md

source content

NotebookLM Skill

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

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.

Workflow

Authenticate:

python scripts/auth_manager.py setup --profile <name>

Register notebook:

python scripts/notebook_manager.py add --url <url> --name <name> --description <desc> --topics <topics>

Ask questions:

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

Manage sources:

python scripts/remote_manager.py add-source|sync-sources ...

Key Behaviors

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

# Auth
python scripts/auth_manager.py setup --profile work
python scripts/auth_manager.py status --profile work

# Library
python scripts/notebook_manager.py add --url "..." --name "..." --description "..." --topics "..."
python scripts/notebook_manager.py list

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

# 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

For full command reference with all flags and examples, see references/commands.md.