CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

76

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

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

  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 ...

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.

Repository
sanjay3290/ai-skills
Path

skills/notebooklm/SKILL.md

Commit

281d88d

Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.

Claim skill