Query Google NotebookLM notebooks directly from Claude for source-grounded, citation-backed answers.
Works with
Manages multi-account Google authentication with automatic browser login and persistent session handling
Supports 20+ commands across notebook management, source uploads (files, URLs, YouTube, Z-Library, text), and queries with automatic follow-up detection
Generates media artifacts including podcasts, briefings, debates, slide decks, and infographics with customizable length, format,
AI-first code editor with Composer
Before installing skills in Cursor, ensure your development environment meets these requirements:
node --versionnblmExecute the skills CLI command in your project's root directory to begin installation:
Fetches nblm from magicseek/nblm and configures it for Cursor.
The CLI shows a list of agents. Use arrow keys and space to select Cursor:
Confirm successful installation by checking the skill directory location:
Restart Cursor to activate nblm. Access via /nblm in your agent's command palette.
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.
Submit your Claude Code skill and start earning
Create detailed user stories, acceptance criteria, and feature specs
Example
Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios
Reduce spec writing time by 50%, ensure comprehensive coverage
Research competitors, compare features, identify gaps
Example
Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities
Complete competitive research in 2 hours instead of 2 days
Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs
Example
Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale
0
total installs
0
this week
28
GitHub stars
0
upvotes
Run in your terminal
0
installs
0
this week
28
stars
Query Google NotebookLM for source-grounded, citation-backed answers.
All dependencies and authentication are handled automatically by run.py:
.venv and installs Python/Node.js dependencies/nblm <command> [args]
| 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 a Google account |
accounts use <id> |
Set agent-specific active account (OpenClaw isolation) |
accounts clear |
Clear agent-specific account override |
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 |
| 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-activeor--create-new).
| 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 |
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 → python scripts/run.py auth_manager.py accounts switch "<id>"
accounts remove → python scripts/run.py auth_manager.py accounts remove "<id>"
accounts use → python scripts/run.py auth_manager.py accounts use "<id>"
accounts clear → python scripts/run.py auth_manager.py accounts clear
status → Run both:
python scripts/run.py auth_manager.py statuspython scripts/run.py notebook_manager.py listlocal → python scripts/run.py notebook_manager.py list
remote → python scripts/run.py nblm_cli.py notebooks
create → python scripts/run.py nblm_cli.py create "<name>"
delete [--id ID] → python scripts/run.py nblm_cli.py delete <args>
rename [--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 → Smart add workflow (auto-detects URL vs notebook ID)
activate → python scripts/run.py notebook_manager.py activate --id "<id>"
sources [--id ID] → python scripts/run.py nblm_cli.py sources <args>
upload → 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 → 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 → 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 → python scripts/run.py nblm_cli.py upload-url "<url>"
upload-youtube → python scripts/run.py nblm_cli.py upload-youtube "<url>"
upload-text → python scripts/run.py nblm_cli.py upload-text "<title>" <args>
source-text → python scripts/run.py nblm_cli.py source-text "<id>"
source-guide → python scripts/run.py nblm_cli.py source-guide "<id>"
source-rename → python scripts/run.py nblm_cli.py source-rename "<id>" "<name>"
source-refresh → python scripts/run.py nblm_cli.py source-refresh "<id>"
source-delete → python scripts/run.py nblm_cli.py source-delete "<id>"
ask → python scripts/run.py nblm_cli.py ask "<question>"
podcast → python scripts/run.py artifact_manager.py generate --format DEEP_DIVE <args>
podcast-status → 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 → python scripts/run.py artifact_manager.py delete "<id>"
If command not recognized, show usage help.,
Show available commands with /nblm (no arguments)
)
/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) |
/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) |
/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) |
| 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 | |
/nblm infographic |
Visual infographic | PNG |
/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
/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
Trigger when user:
https://notebooklm.google.com/notebook/...)The add command now automatically discovers metadata from the notebook:
# 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:
Supported input formats:
5fd9f36b-8000-401d-a7a0-7aa3f7832644https://notebooklm.google.com/notebook/5fd9f36b-8000-401d-a7a0-7aa3f7832644NEVER manually specify --name, --description, or --topics unless the user explicitly provides them.
NEVER call scripts directly. ALWAYS use python scripts/run.py [script]:
# ✅ 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:
.venv if neededpython scripts/run.py auth_manager.py status
If not authenticated, proceed to setup.
# Browser MUST be visible for manual Google login
python scripts/run.py auth_manager.py setup
Important:
# 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
python scripts/run.py notebook_manager.py listpython scripts/run.py ask_question.py --question "..." --notebook-id ID# 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 Make data-driven prioritization decisions faster
Draft PRDs, status updates, and stakeholder presentations
Example
Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement
Save 3-5 hours/week on communication overhead
Prerequisites
Time Estimate
30-60 minutes to see productivity improvements
Steps
Common Pitfalls
✓ Do
✗ Don't
💡 Pro Tips
✓ Use when
Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.
✗ Avoid when
Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.
mattpocock/skills
parcadei/continuous-claude-v3
cursor/plugins
ailabs-393/ai-labs-claude-skills
ailabs-393/ai-labs-claude-skills
pproenca/dot-skills
We added nblm from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
nblm is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
We added nblm from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
Keeps context tight: nblm is the kind of skill you can hand to a new teammate without a long onboarding doc.
Useful defaults in nblm — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
Registry listing for nblm matched our evaluation — installs cleanly and behaves as described in the markdown.
Useful defaults in nblm — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
I recommend nblm for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
nblm fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
nblm reduced setup friction for our internal harness; good balance of opinion and flexibility.
showing 1-10 of 74