How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/sanjay3290/ai-skills --skill notebooklmBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
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-browserfor debugging only. - Persistent Chrome profiles stored at
~/.config/claude/notebooklm-skill/(override withNOTEBOOKLM_DATA_DIR). - Hash-based dedupe: file uploads skip unchanged sources automatically.
--dry-runavailable on all destructive/bulk operations (create, add-source, delete-source, sync-sources).--retries Nretries 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-runFor full command reference with all flags and examples, see references/commands.md.