Agent skill · Security

notebooklm

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.

guanyanggithub.com/guanyangGitHub ↗
claude-codeships scriptsMIT
Install
npx skills add guanyang/open-agent-hub --skill notebooklm --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 21
SKILL.md size: 9 KB
Bundled scripts: yes
Path: skills/notebooklm/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 940
Language: TypeScript

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# NotebookLM Research Assistant Skill Interact with Google NotebookLM to query documentation with Gemini's source-grounded answers. Each question opens a fresh browser session, retrieves the answer exclusively from your uploaded documents, and closes. ## 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 When user wants to add a notebook without providing details: **SMART ADD (Recommended)**: Query the notebook first to discover its content: ```bash # Step 1: Query the notebook about its content python scripts/run.py ask_question.py --question "What is the content of this notebook? What topics are covered? Provide a complete overview briefly and concisely" --notebook-url "[URL]" # Step 2: Use the discovered information to add it python scripts/run.py notebook_manager.py add --url "[URL]" --name "[Based on content]" --description "[Based on content]" --topics "[Based on co

What's inside
Steps it walks through
  1. When to Use This Skill
  2. ⚠️ CRITICAL: Add Command - Smart Discovery
  3. Critical: Always Use run.py Wrapper
  4. Core Workflow
  5. Step 1: Check Authentication Status
  6. Step 2: Authenticate (One-Time Setup)
  7. Step 3: Manage Notebook Library
  8. Quick Workflow
  9. Step 4: Ask Questions
  10. Follow-Up Mechanism (CRITICAL)
  11. Script Reference
  12. Authentication Management (authmanager.py)
  13. Notebook Management (notebookmanager.py)
  14. Question Interface (askquestion.py)
Ships with 20 files
  • .gitignore
  • AUTHENTICATION.md
  • CHANGELOG.md
  • LICENSE
  • README.md
  • images/example_notebookchat.png
  • references/api_reference.md
  • references/troubleshooting.md
  • references/usage_patterns.md
  • requirements.txt
  • scripts/__init__.py
  • scripts/ask_question.py
  • scripts/auth_manager.py
  • scripts/browser_session.py
  • scripts/browser_utils.py
  • scripts/cleanup_manager.py
  • scripts/config.py
  • scripts/notebook_manager.py
  • scripts/run.py
  • scripts/setup_environment.py
Commands it runs
Step 1: Query the notebook about its content
Step 2: Use the discovered information to add it
python scripts/run.py notebook_manager.py add --url "[URL]" --name "[Based on content]" --description "[Based on content]" --topics "[Based on content]"
python scripts/run.py auth_manager.py status
python scripts/run.py notebook_manager.py list
python scripts/run.py ask_question.py --question "..."
python scripts/auth_manager.py status  # Fails without venv!
Browser MUST be visible for manual Google login
python scripts/run.py auth_manager.py setup
List all notebooks
More from open-agent-hub
All skills →
About this skill
What does the notebooklm skill do?

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.

How do I install it?

Run `npx skills add guanyang/open-agent-hub --skill notebooklm --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From guanyang/open-agent-hub, a repository with 940 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going