Claude Skill

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

LLM Mart · 0 points · 1 views 0 listing impressions 0 install-command copies
Download sanjay3290-ai-skills-skills_notebooklm-c842558.zip · 30 KB

Install

skills CLI npx skills add https://github.com/sanjay3290/ai-skills/tree/main/skills/notebooklm
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install sanjay3290-ai-skills@llmmart
Git git clone https://github.com/sanjay3290/ai-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole sanjay3290/ai-skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

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.

Files (ai-skills)
  • references
    • commands.md 4.1 KB
      Loading…
  • scripts
    • ask_question.py 27.2 KB
      Loading…
    • auth_manager.py 7.9 KB
      Loading…
    • common.py 8.1 KB
      Loading…
    • notebook_manager.py 7.3 KB
      Loading…
    • remote_manager.py 55.4 KB
      Loading…
  • tests
    • conftest.py 148 B
      Loading…
    • test_ask_question_modes.py 2 KB
      Loading…
    • test_remote_manager_filters.py 2.5 KB
      Loading…
    • test_smoke_playwright.py 2.8 KB
      Loading…
  • .gitignore 34 B · in bundle
  • requirements.txt 19 B
    Loading…
  • SKILL.md 2.6 KB
    ---
    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, 'ask my notebook', shares NotebookLM notebook URLs, wants to list/create notebooks, manage sources, do bulk folder sync, dedupe, or audit exports."
    license: Apache-2.0
    metadata:
      author: sanjay3290
      version: "1.0"
    ---
    
    # 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
    
    ```bash
    # 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](references/commands.md).
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.