Agent skill

Nblm

by LeoYeAI in LeoYeAI/openclaw-master-skills

A skill your agent uses to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini.

MITAuto-check: notesKnowledge Management

Install Nblm

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill nblm -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills nblm --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nblm .claude/skills/nblm && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "nblm" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/nblm into .claude/skills/nblm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nblm", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/nblm

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill nblm -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills nblm --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/nblm .agents/skills/nblm && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "nblm" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/nblm into .agents/skills/nblm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nblm", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill nblm -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills nblm --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/nblm .cursor/skills/nblm && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "nblm" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/nblm into .cursor/skills/nblm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nblm", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/LeoYeAI/openclaw-master-skills.git --path skills/nblm

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill nblm -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills nblm --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/nblm .gemini/skills/nblm && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "nblm" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/nblm into .gemini/skills/nblm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nblm", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills nblm

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill nblm -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/nblm .github/skills/nblm && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "nblm" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/nblm into .github/skills/nblm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nblm", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill nblm -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills nblm --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/nblm .opencode/skills/nblm && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "nblm" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/nblm into .opencode/skills/nblm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nblm", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: nblm
GitHub stars: 2.2k
Token cost: ~5.9k tokens
SKILL.md length: 1,683 words
Files: 32 (incl. scripts, references)
Skills in repo: 972
Repo updated: Jul 20, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

A skill your agent uses to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini.

Works in 4 steps: Check Authentication Status → Authenticate (One-Time Setup) → Manage Notebook Library → …
Query your Google NotebookLM notebooks directly from Claude Code for source-grounded
SKILL.md covers Environment, Usage, Commands and Command Routing, plus 11 more sections
Runs Python scripts from its folder; calls python, npm and pip; reaches notebooklm.google.com and zh.zlib.li

What it does

Nblm is an agent skill from LeoYeAI/openclaw-master-skills. Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.

Its SKILL.md is about 5.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 33 other files, including scripts and reference files (for example `AUTHENTICATION.md`, `CHANGELOG.md` and `README.md`).

It sits in Knowledge Management, covering Source-grounded notebooks, Browser automation and Citation management. It works with NotebookLM. The repository describes itself as: 🧠 Curated collection of 1209+ best OpenClaw skills — weekly updated by MyClaw.ai. The licence is MIT.

When your agent uses it

Query your Google NotebookLM notebooks directly from Claude Code for source-grounded
Citation-backed answers from Gemini

Example prompts

“/nblm”

Requirements

Python 3
Node.js

Workflow steps

4 steps, taken from the step headings in SKILL.md.

Check Authentication Status
Authenticate (One-Time Setup)
Manage Notebook Library
Ask Questions

What it can do on your machine

Read from SKILL.md and the folder at commit e5199b5. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 9 files in scripts/ (Python, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
- python
- npm
- pip
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- notebooklm.google.com
- zh.zlib.li
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nblm loads about 5.9k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 68 tokens; SKILL.md has 1,683 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~68
When it runs · the whole SKILL.md, loaded when a task matches: ~5.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~13k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteMentions a .env fileSKILL.md:545

Optional `.env` file in skill directory:

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from LeoYeAI/openclaw-master-skills at commit e5199b5, republished under its MIT licence (© LeoYeAI). 1,683 words, ~5,901 tokens.

Download SKILL.mdSave it as .claude/skills/nblm/SKILL.md (or your agent's skills folder). This skill also uses 31 other files; get the full folder from GitHub.

name: nblm
description: Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.

NotebookLM Quick Commands

Query Google NotebookLM for source-grounded, citation-backed answers.

Environment

All dependencies and authentication are handled automatically by run.py:

First run creates .venv and installs Python/Node.js dependencies
If Google auth is missing or expired, a browser window opens automatically
No manual pre-flight steps required

Usage

/nblm <command> [args]

Commands

Notebook Management

Command	Description
`login`	Authenticate with Google
`status`	Show auth and library status
`accounts`	List all Google accounts
`accounts add`	Add a new Google account
`accounts switch <id>`	Switch active account (by index or email)
`accounts remove <id>`	Remove an account
`local`	List notebooks in local library
`remote`	List all notebooks from NotebookLM API
`create <name>`	Create a new notebook
`delete [--id ID]`	Delete a notebook
`rename <name> [--id ID]`	Rename a notebook
`summary [--id ID]`	Get AI-generated summary
`describe [--id ID]`	Get description and suggested topics
`add <url-or-id>`	Add notebook to local library (auto-detects URL vs notebook ID)
`activate <id>`	Set active notebook

Source Management

Command	Description
`sources [--id ID]`	List sources in notebook
`upload <file>`	Upload a single file
`upload <folder>`	Sync a folder of files to NotebookLM
`upload-zlib <url>`	Download from Z-Library and upload
`upload-url <url>`	Add URL as source
`upload-youtube <url>`	Add YouTube video as source
`upload-text <title> [--content TEXT]`	Add text as source
`source-text <source-id>`	Get full indexed text
`source-guide <source-id>`	Get AI summary and keywords
`source-rename <source-id> <name>`	Rename a source
`source-refresh <source-id>`	Re-fetch URL content
`source-delete <source-id>`	Delete a source

Upload options:

--use-active - Upload to the currently active notebook
--create-new - Create a new notebook named after the file/folder
--notebook-id <id> - Upload to a specific notebook
--dry-run - Show sync plan without executing (folder sync)
--rebuild - Force rebuild tracking file (folder sync)

Important: When user runs upload without specifying a target, ASK them first:

"Would you like to upload to the active notebook, or create a new notebook?" Then pass the appropriate flag (--use-active or --create-new).

Chat & Audio/Media

Command	Description
`ask <question>`	Query NotebookLM
`podcast [--instructions TEXT]`	Generate audio podcast
`podcast-status <task-id>`	Check podcast generation status
`podcast-download [output-path]`	Download latest podcast
`briefing [--instructions TEXT]`	Generate brief audio summary
`debate [--instructions TEXT]`	Generate debate-style audio
`slides [--instructions TEXT]`	Generate slide deck
`slides-download [output-path]`	Download slide deck as PDF
`infographic [--instructions TEXT]`	Generate infographic
`infographic-download [output-path]`	Download infographic
`media-list [--type TYPE]`	List generated media (audio/video/slides/infographic)
`media-delete <id>`	Delete a generated media item

Command Routing

Based on $ARGUMENTS, execute the appropriate command:

$IF($ARGUMENTS, Parse the command from: "$ARGUMENTS"

login → python scripts/run.py auth_manager.py setup --service google

accounts → python scripts/run.py auth_manager.py accounts list

accounts add → python scripts/run.py auth_manager.py accounts add

accounts switch <id> → python scripts/run.py auth_manager.py accounts switch "<id>"

accounts remove <id> → python scripts/run.py auth_manager.py accounts remove "<id>"

status → Run both:

python scripts/run.py auth_manager.py status
python scripts/run.py notebook_manager.py list

local → python scripts/run.py notebook_manager.py list

remote → python scripts/run.py nblm_cli.py notebooks

create <name> → python scripts/run.py nblm_cli.py create "<name>"

delete [--id ID] → python scripts/run.py nblm_cli.py delete <args>

rename <name> [--id ID] → python scripts/run.py nblm_cli.py rename "<name>" <args>

summary [--id ID] → python scripts/run.py nblm_cli.py summary <args>

describe [--id ID] → python scripts/run.py nblm_cli.py describe <args>

add <url-or-id> → Smart add workflow (auto-detects URL vs notebook ID)

activate <id> → python scripts/run.py notebook_manager.py activate --id "<id>"

sources [--id ID] → python scripts/run.py nblm_cli.py sources <args>

upload <file> → First ASK user: "Upload to active notebook or create new?" Then: - Active: python scripts/run.py source_manager.py add --file "<file>" --use-active - New: python scripts/run.py source_manager.py add --file "<file>" --create-new

upload <folder> → Sync a folder: - First ASK user: "Sync to active notebook, create new, or specify notebook?" - Active: python scripts/run.py source_manager.py sync "<folder>" --use-active - New: python scripts/run.py source_manager.py sync "<folder>" --create-new - Specific: python scripts/run.py source_manager.py sync "<folder>" --notebook-id ID - Dry-run: python scripts/run.py source_manager.py sync "<folder>" --dry-run - Rebuild: python scripts/run.py source_manager.py sync "<folder>" --rebuild

upload-zlib <url> → First ASK user: "Upload to active notebook or create new?" Then: - Active: python scripts/run.py source_manager.py add --url "<url>" --use-active - New: python scripts/run.py source_manager.py add --url "<url>" --create-new

upload-url <url> → python scripts/run.py nblm_cli.py upload-url "<url>"

upload-youtube <url> → python scripts/run.py nblm_cli.py upload-youtube "<url>"

upload-text <title> → python scripts/run.py nblm_cli.py upload-text "<title>" <args>

source-text <id> → python scripts/run.py nblm_cli.py source-text "<id>"

source-guide <id> → python scripts/run.py nblm_cli.py source-guide "<id>"

source-rename <id> <name> → python scripts/run.py nblm_cli.py source-rename "<id>" "<name>"

source-refresh <id> → python scripts/run.py nblm_cli.py source-refresh "<id>"

source-delete <id> → python scripts/run.py nblm_cli.py source-delete "<id>"

ask <question> → python scripts/run.py nblm_cli.py ask "<question>"

podcast → python scripts/run.py artifact_manager.py generate --format DEEP_DIVE <args>

podcast-status <task-id> → python scripts/run.py artifact_manager.py status --task-id "<task-id>"

podcast-download [output-path] → python scripts/run.py artifact_manager.py download "<output-path>"

briefing → python scripts/run.py artifact_manager.py generate --format BRIEF <args>

debate → python scripts/run.py artifact_manager.py generate --format DEBATE <args>

slides → python scripts/run.py artifact_manager.py generate-slides <args>

slides-download [output-path] → python scripts/run.py artifact_manager.py download "<output-path>" --type slide-deck

infographic → python scripts/run.py artifact_manager.py generate-infographic <args>

infographic-download [output-path] → python scripts/run.py artifact_manager.py download "<output-path>" --type infographic

media-list [--type TYPE] → python scripts/run.py artifact_manager.py list <args>

media-delete <id> → python scripts/run.py artifact_manager.py delete "<id>"

If command not recognized, show usage help.,

Show available commands with /nblm (no arguments) )

Podcast Options

/nblm podcast --length DEFAULT --wait --output ./podcast.mp3
/nblm podcast --instructions "Focus on the key findings"
/nblm briefing --wait --output ./summary.mp3
/nblm debate --instructions "Compare the two approaches"

Option	Values
`--length`	`SHORT`, `DEFAULT`, `LONG`
`--instructions`	Custom instructions for the content
`--wait`	Wait for generation to complete
`--output`	Download path (requires `--wait`)

Slide Deck Options

/nblm slides --format DETAILED_DECK --wait --output ./presentation.pdf
/nblm slides --instructions "Focus on key diagrams" --format PRESENTER_SLIDES

Option	Values
`--format`	`DETAILED_DECK`, `PRESENTER_SLIDES`
`--length`	`SHORT`, `DEFAULT`
`--instructions`	Custom instructions for the content
`--wait`	Wait for generation to complete
`--output`	Download path (requires `--wait`)

Infographic Options

/nblm infographic --orientation LANDSCAPE --wait --output ./visual.png
/nblm infographic --instructions "Highlight comparison" --detail-level DETAILED

Option	Values
`--orientation`	`LANDSCAPE`, `PORTRAIT`, `SQUARE`
`--detail-level`	`CONCISE`, `STANDARD`, `DETAILED`
`--instructions`	Custom instructions for the content
`--wait`	Wait for generation to complete
`--output`	Download path (requires `--wait`)

Media Generation

Command	Description	Output
`/nblm podcast`	Deep-dive audio discussion	MP3
`/nblm briefing`	Brief audio summary	MP3
`/nblm debate`	Debate-style audio	MP3
`/nblm slides`	Slide deck presentation	PDF
`/nblm infographic`	Visual infographic	PNG

Examples

/nblm podcast --wait --output ./deep-dive.mp3
/nblm briefing --instructions "Focus on chapter 3" --wait
/nblm debate --length LONG --wait --output ./debate.mp3
/nblm slides --instructions "Include key diagrams" --format DETAILED_DECK --wait --output ./presentation.pdf
/nblm infographic --orientation LANDSCAPE --detail-level DETAILED --wait --output ./summary.png

Download & Manage

/nblm podcast-download ./my-podcast.mp3
/nblm slides-download ./presentation.pdf
/nblm infographic-download ./visual.png
/nblm media-list                     # List all generated media
/nblm media-list --type audio        # List only audio
/nblm media-delete <id>              # Delete a media item

Extended Documentation

When to Use This Skill

Trigger when user:

Mentions NotebookLM explicitly
Shares NotebookLM URL (https://notebooklm.google.com/notebook/...)
Asks to query their notebooks/documentation
Wants to add documentation to NotebookLM library
Uses phrases like "ask my NotebookLM", "check my docs", "query my notebook"

⚠️ CRITICAL: Add Command - Smart Discovery

The add command now automatically discovers metadata from the notebook:

bash

# Smart Add (auto-discovers name, description, topics)
python scripts/run.py notebook_manager.py add <notebook-id-or-url>

# With optional overrides
python scripts/run.py notebook_manager.py add <id> --name "Custom Name" --topics "custom,topics"

What Smart Add does:

Fetches notebook title from NotebookLM API
Queries the notebook content to generate description and topics
Adds to local library with discovered metadata

Supported input formats:

Notebook ID: 5fd9f36b-8000-401d-a7a0-7aa3f7832644
Full URL: https://notebooklm.google.com/notebook/5fd9f36b-8000-401d-a7a0-7aa3f7832644

NEVER manually specify --name, --description, or --topics unless the user explicitly provides them.

Show full SKILL.md (664 more words)Show less

Critical: Always Use run.py Wrapper

NEVER call scripts directly. ALWAYS use python scripts/run.py [script]:

bash

# ✅ CORRECT - Always use run.py:
python scripts/run.py auth_manager.py status
python scripts/run.py notebook_manager.py list
python scripts/run.py ask_question.py --question "..."

# ❌ WRONG - Never call directly:
python scripts/auth_manager.py status  # Fails without venv!

The run.py wrapper automatically:

Creates .venv if needed
Installs all dependencies
Activates environment
Executes script properly

Core Workflow

Step 1: Check Authentication Status

bash

python scripts/run.py auth_manager.py status

If not authenticated, proceed to setup.

Step 2: Authenticate (One-Time Setup)

bash

# Browser MUST be visible for manual Google login
python scripts/run.py auth_manager.py setup

Important:

Browser is VISIBLE for authentication
Browser window opens automatically
User must manually log in to Google
Tell user: "A browser window will open for Google login"

Step 3: Manage Notebook Library

bash

# List all notebooks
python scripts/run.py notebook_manager.py list

# BEFORE ADDING: Ask user for metadata if unknown!
# "What does this notebook contain?"
# "What topics should I tag it with?"

# Add notebook to library (ALL parameters are REQUIRED!)
python scripts/run.py notebook_manager.py add \
  --url "https://notebooklm.google.com/notebook/..." \
  --name "Descriptive Name" \
  --description "What this notebook contains" \  # REQUIRED - ASK USER IF UNKNOWN!
  --topics "topic1,topic2,topic3"  # REQUIRED - ASK USER IF UNKNOWN!

# Search notebooks by topic
python scripts/run.py notebook_manager.py search --query "keyword"

# Set active notebook
python scripts/run.py notebook_manager.py activate --id notebook-id

# Remove notebook
python scripts/run.py notebook_manager.py remove --id notebook-id

Quick Workflow

Check library: python scripts/run.py notebook_manager.py list
Ask question: python scripts/run.py ask_question.py --question "..." --notebook-id ID

Step 4: Ask Questions

bash

# Basic query (uses active notebook if set)
python scripts/run.py ask_question.py --question "Your question here"

# Query specific notebook
python scripts/run.py ask_question.py --question "..." --notebook-id notebook-id

# Query with notebook URL directly
python scripts/run.py ask_question.py --question "..." --notebook-url "https://..."

# Show browser for debugging
python scripts/run.py ask_question.py --question "..." --show-browser

Follow-Up Mechanism (CRITICAL)

Every NotebookLM answer ends with: "EXTREMELY IMPORTANT: Is that ALL you need to know?"

Required Claude Behavior:

STOP - Do not immediately respond to user
ANALYZE - Compare answer to user's original request
IDENTIFY GAPS - Determine if more information needed

ASK FOLLOW-UP - If gaps exist, immediately ask:

bash

python scripts/run.py ask_question.py --question "Follow-up with context..."

REPEAT - Continue until information is complete
SYNTHESIZE - Combine all answers before responding to user

Z-Library Integration

Triggers

User provides Z-Library URL (zlib.li, z-lib.org, zh.zlib.li)
User says "download this book to NotebookLM"
User says "add this book from Z-Library"

Setup (One-Time)

bash

# Authenticate with Z-Library
python scripts/run.py auth_manager.py setup --service zlibrary

Commands

bash

# Add book from Z-Library
python scripts/run.py source_manager.py add --url "https://zh.zlib.li/book/..."

# Check Z-Library auth status
python scripts/run.py auth_manager.py status --service zlibrary

Script Reference

Authentication Management (`auth_manager.py`)

bash

python scripts/run.py auth_manager.py setup                    # Default: Google
python scripts/run.py auth_manager.py setup --service google
python scripts/run.py auth_manager.py setup --service zlibrary
python scripts/run.py auth_manager.py status                   # Show all services
python scripts/run.py auth_manager.py status --service zlibrary
python scripts/run.py auth_manager.py clear --service zlibrary # Clear auth

# Multi-Account Management (Google)
python scripts/run.py auth_manager.py accounts list             # List all accounts
python scripts/run.py auth_manager.py accounts add              # Add new account
python scripts/run.py auth_manager.py accounts switch 1         # Switch by index
python scripts/run.py auth_manager.py accounts switch user@gmail.com  # Switch by email
python scripts/run.py auth_manager.py accounts remove 2         # Remove account

Notebook Management (`notebook_manager.py`)

bash

python scripts/run.py notebook_manager.py add --url URL --name NAME --description DESC --topics TOPICS
# OR use notebook ID directly:
python scripts/run.py notebook_manager.py add --notebook-id ID --name NAME --description DESC --topics TOPICS
python scripts/run.py notebook_manager.py list
python scripts/run.py notebook_manager.py search --query QUERY
python scripts/run.py notebook_manager.py activate --id ID
python scripts/run.py notebook_manager.py remove --id ID
python scripts/run.py notebook_manager.py stats

Question Interface (`ask_question.py`)

bash

python scripts/run.py ask_question.py --question "..." [--notebook-id ID] [--notebook-url URL] [--show-browser]

Source Manager (`source_manager.py`)

bash

# Upload to active notebook
python scripts/run.py source_manager.py add --file "/path/to/book.pdf" --use-active

# Create new notebook for upload
python scripts/run.py source_manager.py add --file "/path/to/book.pdf" --create-new

# Upload to specific notebook
python scripts/run.py source_manager.py add --file "/path/to/book.pdf" --notebook-id NOTEBOOK_ID

# Z-Library download and upload
python scripts/run.py source_manager.py add --url "https://zh.zlib.li/book/..." --use-active
python scripts/run.py source_manager.py add --url "https://zh.zlib.li/book/..." --create-new

# Sync a folder (new!)
python scripts/run.py source_manager.py sync "/path/to/docs" --use-active
python scripts/run.py source_manager.py sync "/path/to/docs" --create-new
python scripts/run.py source_manager.py sync "/path/to/docs" --notebook-id NOTEBOOK_ID

# Sync options (new!)
python scripts/run.py source_manager.py sync "/path/to/docs" --dry-run    # Preview only
python scripts/run.py source_manager.py sync "/path/to/docs" --rebuild   # Force re-hash all files

Folder Sync:

Scans folder for supported types: PDF, TXT, MD, DOCX, HTML, EPUB
Tracks sync state internally (no per-folder tracking file to manage)
Sync strategy: add new, update modified (delete + re-upload), skip unchanged
Multi-account aware (tracks which Google account was used) Note: One of --use-active, --create-new, or --notebook-id is REQUIRED. Uploads wait for NotebookLM processing and print progress as Ready: N/T. Press Ctrl+C to stop waiting. Local file uploads use browser automation and require Google authentication. If browser automation is unavailable, set NOTEBOOKLM_UPLOAD_MODE=text to upload extracted text instead (PDFs require pypdf).

Data Cleanup (`cleanup_manager.py`)

bash

python scripts/run.py cleanup_manager.py                    # Preview cleanup
python scripts/run.py cleanup_manager.py --confirm          # Execute cleanup
python scripts/run.py cleanup_manager.py --preserve-library # Keep notebooks

Watchdog Status (`auth_manager.py`)

bash

python scripts/run.py auth_manager.py watchdog-status

Environment Management

The virtual environment is automatically managed:

First run creates .venv automatically
Dependencies install automatically
Node.js dependencies install automatically
agent-browser daemon starts on demand and keeps browser state in memory
daemon stops after 10 minutes of inactivity (any agent-browser command resets the timer)
set AGENT_BROWSER_OWNER_PID to auto-stop when the agent process exits
scripts/run.py sets AGENT_BROWSER_OWNER_PID to its parent PID by default
Everything isolated in skill directory

Manual setup (only if automatic fails):

bash

python -m venv .venv
source .venv/bin/activate  # Linux/Mac
pip install -r requirements.txt
npm install
npm run install-browsers

Data Storage

All data stored in ~/.claude/skills/notebooklm/data/:

library.json - Notebook metadata (with account associations)
auth/google/ - Multi-account Google auth
- index.json - Account index (active account, list)
- <n>-<email>.json - Per-account credentials
auth/zlibrary.json - Z-Library auth state
agent_browser/session_id - Current daemon session ID
agent_browser/last_activity.json - Last activity timestamp for idle shutdown
agent_browser/watchdog.pid - Idle watchdog process ID

Security: Protected by .gitignore, never commit to git.

Configuration

Optional .env file in skill directory:

env

HEADLESS=false           # Browser visibility
SHOW_BROWSER=false       # Default browser display
STEALTH_ENABLED=true     # Human-like behavior
TYPING_WPM_MIN=160       # Typing speed
TYPING_WPM_MAX=240
DEFAULT_NOTEBOOK_ID=     # Default notebook

Decision Flow

User mentions NotebookLM
    ↓
Check auth → python scripts/run.py auth_manager.py status
    ↓
If not authenticated → python scripts/run.py auth_manager.py setup
    ↓
Check/Add notebook → python scripts/run.py notebook_manager.py list/add (with --description)
    ↓
Activate notebook → python scripts/run.py notebook_manager.py activate --id ID
    ↓
Ask question → python scripts/run.py ask_question.py --question "..."
    ↓
See "Is that ALL you need?" → Ask follow-ups until complete
    ↓
Synthesize and respond to user

Troubleshooting

Problem	Solution
ModuleNotFoundError	Use `run.py` wrapper
Authentication fails	Browser must be visible for setup! --show-browser
DAEMON_UNAVAILABLE	Ensure Node.js/npm installed, run `npm install`, retry
AUTH_REQUIRED	Run `python scripts/run.py auth_manager.py setup`
ELEMENT_NOT_FOUND	Verify notebook URL and re-run with fresh page load
Rate limit (50/day)	Wait or add another Google account with `accounts add`
Browser crashes	`python scripts/run.py cleanup_manager.py --preserve-library`
Notebook not found	Check with `notebook_manager.py list`

Best Practices

Always use run.py - Handles environment automatically
Check auth first - Before any operations
Follow-up questions - Don't stop at first answer
Browser visible for auth - Required for manual login
Include context - Each question is independent
Synthesize answers - Combine multiple responses

Limitations

No session persistence (each question = new browser)
Rate limits on free Google accounts (50 queries/day per account; use multiple accounts to increase)
Manual upload required (user must add docs to NotebookLM)
Browser overhead (few seconds per question)

Resources (Skill Structure)

Important directories and files:

scripts/ - All automation scripts (ask_question.py, notebook_manager.py, etc.)
data/ - Local storage for authentication and notebook library
references/ - Extended documentation:
- api_reference.md - Detailed API documentation for all scripts
- troubleshooting.md - Common issues and solutions
- usage_patterns.md - Best practices and workflow examples
.venv/ - Isolated Python environment (auto-created on first run)
.gitignore - Protects sensitive data from being committed

Files

SKILL.md and 31 other files (scripts, references) in skills/nblm of LeoYeAI/openclaw-master-skills.

SKILL.md
AUTHENTICATION.md
CHANGELOG.md
README.md
README.zh-CN.md
_meta.json
references/api_reference.md
references/troubleshooting.md
references/usage_patterns.md
requirements.txt
scripts/__init__.py
scripts/account_manager.py
scripts/agent_browser_client.py
scripts/artifact_manager.py
scripts/ask_question.py
scripts/auth_manager.py
scripts/cleanup_manager.py
scripts/config.py
scripts/daemon_watchdog.py
… and 13 more

Open the folder on GitHubat commit e5199b5

Compare with similar skills

Nblm next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nblm compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Nblm this skillLeoYeAI/openclaw-master-skills	2.2k	—	~5.9k	Automated safety check: Notes	MIT	2 mo ago
NotebookLM Research AssistantPleasePrompto/notebooklm-skill	7.8k	14 repos	~2.4k	Automated safety check: Notes	MIT	28 days ago
Notebooklmalirezarezvani/claude-skills	28k	—	~4k	Automated safety check: Pass	MIT	1 mo ago
Notebooklm Grounded ResearchAnastasiyaW/codex-claude-code-config	154	—	~2.4k	Automated safety check: Warn	MIT	yesterday
Notebooklm Connectormohitagw15856/pm-claude-skills	1.4k	—	~2.3k	Automated safety check: Pass	MIT	yesterday
Zlibrary To Notebooklmzstmfhy/zlibrary-to-notebooklm	1.7k	1 repos	~968	Automated safety check: Pass	MIT	8 mo ago

Similar skills

NotebookLM Research Assistant
PleasePrompto/notebooklm-skill
Lets Claude Code ask questions of your Google NotebookLM notebooks through browser automation and return answers grounded in your uploaded sources.
7.8k GitHub starsUsed in 14 repos~2.4k tokens
Knowledge ManagementAuto-check: notes
Notebooklm
alirezarezvani/claude-skills
Browser automation skill for controlling Google's NotebookLM.
28k GitHub stars~4k tokensUpdated 1 mo ago
Knowledge ManagementAuto-check passed
Notebooklm Grounded Research
AnastasiyaW/codex-claude-code-config
A skill your agent uses when: NotebookLM, notebooklm MCP, large documentation sets, courses, books, papers, or citation-backed research are mentioned.
154 GitHub stars~2.4k tokensUpdated yesterday
Knowledge ManagementAuto-check: warnings
Notebooklm Connector
mohitagw15856/pm-claude-skills
Automates NotebookLM from Claude Code using browser automation via the Claude Chrome extension — creating notebooks, adding sources, and triggering outputs without manual clicking.
1.4k GitHub stars~2.3k tokensUpdated yesterday
Knowledge ManagementAuto-check passed
Zlibrary To Notebooklm
zstmfhy/zlibrary-to-notebooklm
自动从 Z-Library 下载书籍并上传到 Google NotebookLM。支持 PDF/EPUB 格式，自动转换，一键创建知识库。
1.7k GitHub starsUsed in 1 repo~968 tokens
Knowledge ManagementAuto-check passed
Multi-Source to NotebookLM Processor
joeseesun/qiaomu-anything-to-notebooklm
Collects content from WeChat articles, web pages, YouTube, podcasts, documents and more, uploads it to NotebookLM and generates podcasts, slides or mind maps.
6.2k GitHub stars~3.6k tokensUpdated 3 days ago
Knowledge ManagementAuto-check passed

Questions about Nblm

What does Nblm do?

A skill your agent uses to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Nblm is an agent skill from LeoYeAI/openclaw-master-skills. Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini.

When should I use Nblm?

Nblm fits situations like: query your Google NotebookLM notebooks directly from Claude Code for source-grounded; citation-backed answers from Gemini.

How do I install Nblm in Claude Code?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill nblm -a claude-code`. Or copy the skill folder (skills/nblm in LeoYeAI/openclaw-master-skills) into .claude/skills/nblm in your project. Claude Code loads it when a task matches its description.

How do I install Nblm in Codex?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill nblm -a codex`. Or copy the skill folder (skills/nblm in LeoYeAI/openclaw-master-skills) into .agents/skills/nblm in your project. Codex loads it when a task matches its description.

Can I use Nblm in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add LeoYeAI/openclaw-master-skills --skill nblm -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nblm, .gemini/skills/nblm, .github/skills/nblm and .opencode/skills/nblm in your project.

What does Nblm need to run?

Going by SKILL.md and its folder, Nblm needs Python for the scripts in its folder and the command-line tools its instructions call (python, npm and pip). Our summary lists: Python 3; Node.js.

Does Nblm access the network?

SKILL.md names 2 domains. In commands or code: notebooklm.google.com and zh.zlib.li; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Nblm safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Nblm use?

Nblm is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nblm use?

About 5.9k tokens (SKILL.md is roughly 24k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.1k tokens, read only when the agent opens those files.

What are the alternatives to Nblm?

Skills that share tags, products or a category with Nblm: NotebookLM Research Assistant (PleasePrompto/notebooklm-skill, 7.8k stars), Notebooklm (alirezarezvani/claude-skills, 28k stars), Notebooklm Grounded Research (AnastasiyaW/codex-claude-code-config, 154 stars) and Notebooklm Connector (mohitagw15856/pm-claude-skills, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nblm?

LeoYeAI (a GitHub user) maintains it in LeoYeAI/openclaw-master-skills, which has 2,159 GitHub stars. The repository holds 972 skills in this directory. The repository was last updated on July 20, 2026.

Source: LeoYeAI/openclaw-master-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Nblm

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

NotebookLM Quick Commands

Environment

Usage

Commands

Notebook Management

Source Management

Chat & Audio/Media

Command Routing

Podcast Options

Slide Deck Options

Infographic Options

Media Generation

Examples

Download & Manage

Extended Documentation

When to Use This Skill

⚠️ CRITICAL: Add Command - Smart Discovery

Critical: Always Use run.py Wrapper

Core Workflow

Step 1: Check Authentication Status

Step 2: Authenticate (One-Time Setup)

Step 3: Manage Notebook Library

Quick Workflow

Step 4: Ask Questions

Follow-Up Mechanism (CRITICAL)

Z-Library Integration

Triggers

Setup (One-Time)

Commands

Script Reference

Authentication Management (auth_manager.py)

Notebook Management (notebook_manager.py)

Question Interface (ask_question.py)

Source Manager (source_manager.py)

Data Cleanup (cleanup_manager.py)

Watchdog Status (auth_manager.py)

Environment Management

Data Storage

Configuration

Decision Flow

Troubleshooting

Best Practices

Limitations

Resources (Skill Structure)

Files

Compare with similar skills

Similar skills

More from LeoYeAI/openclaw-master-skills

Related

Questions about Nblm

Authentication Management (`auth_manager.py`)

Notebook Management (`notebook_manager.py`)

Question Interface (`ask_question.py`)

Source Manager (`source_manager.py`)

Data Cleanup (`cleanup_manager.py`)

Watchdog Status (`auth_manager.py`)