AgriciDaniel/claude-blog / skills/blog-notebooklm
blog-notebooklm
VerifiedQuery a user's Gemini Notebook (formerly NotebookLM) for source-grounded answers through a logged-in browser session on their Google account. Uses the account's usage limits and writes browser state. Runs only on an explicit request: /blog notebooklm, "ask my Gemini Notebook", "ask my NotebookLM notebook", or "query my notebook library". Also used by blog-write when the user named a notebook for research. Not for generic research or note-taking.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.3 KB |
| references/commands.md | markdown | 8.1 KB |
| references/troubleshooting.md | markdown | 6.6 KB |
| scripts/__init__.py | script | 605 B |
| scripts/ask_question.py | script | 11.1 KB |
| scripts/auth_manager.py | script | 14.0 KB |
| scripts/browser_session.py | script | 8.7 KB |
| scripts/browser_utils.py | script | 5.7 KB |
| scripts/cleanup_manager.py | script | 11.2 KB |
| scripts/config.py | script | 6.4 KB |
| scripts/notebook_manager.py | script | 15.9 KB |
| scripts/requirements.lock | other | 8.2 KB |
| scripts/requirements.txt | manifest | 609 B |
| scripts/run.py | script | 3.9 KB |
| scripts/runtime_paths.py | script | 2.6 KB |
| scripts/setup_environment.py | script | 12.1 KB |
scripts/run.py
View on GitHub#!/usr/bin/env python3
"""
Universal runner for NotebookLM skill scripts
Ensures all scripts run with the correct virtual environment
"""
import os
import sys
import subprocess
import hashlib
from pathlib import Path
# Load only the helper shipped beside this installed script, never from CWD.
sys.path.insert(0, str(Path(__file__).resolve().parent))
from runtime_paths import resolve_runtime_paths
def get_venv_python():
"""Get the virtual environment Python executable"""
skill_dir = Path(__file__).resolve().parent.parent
venv_dir = resolve_runtime_paths(skill_dir, "blog-notebooklm").venv
if os.name == 'nt': # Windows
venv_python = venv_dir / "Scripts" / "python.exe"
else: # Unix/Linux/Mac
venv_python = venv_dir / "bin" / "python"
return venv_python
def ensure_venv():
"""Return a ready interpreter without installing or updating anything."""
skill_dir = Path(__file__).resolve().parent.parent
venv_dir = resolve_runtime_paths(skill_dir, "blog-notebooklm").venv
lock_file = skill_dir / "scripts" / "requirements.lock"
requirements_file = skill_dir / "scripts" / "requirements.txt"
stamp_file = venv_dir / ".requirements.stamp"
source = lock_file if lock_file.exists() else requirements_file
expected_stamp = hashlib.sha256(source.read_bytes()).hexdigest() if source.exists() else None
current_stamp = stamp_file.read_text().strip() if stamp_file.exists() else None
venv_python = get_venv_python()
setup_script = skill_dir / "scripts" / "setup_environment.py"
if not venv_python.is_file():
print(f'❌ NotebookLM setup required. Run: python3 "{setup_script}"')
sys.exit(1)
if expected_stamp and current_stamp != expected_stamp:
print(f'❌ NotebookLM dependencies are missing or stale. Run: python3 "{setup_script}"')
sys.exit(1)
return venv_python
USAGE = """Usage: python run.py <script_name> [args...]
Available scripts:
ask_question.py - Query NotebookLM
notebook_manager.py - Manage notebook library
auth_manager.py - Handle authentication
cleanup_manager.py - Clean up skill data
Run "python run.py <script_name> --help" for a script's options."""
def main():
"""Main runner"""
if len(sys.argv) >= 2 and sys.argv[1] in ("-h", "--help", "help"):
print(USAGE)
sys.exit(0)
if len(sys.argv) < 2:
print(USAGE)
sys.exit(1)
script_name = sys.argv[1]
script_args = sys.argv[2:]
# Handle both "scripts/script.py" and "script.py" formats
if script_name.startswith('scripts/'):
# Remove the scripts/ prefix if provided
script_name = script_name[8:] # len('scripts/') = 8
# Ensure .py extension
if not script_name.endswith('.py'):
script_name += '.py'
# Get script path
skill_dir = Path(__file__).resolve().parent.parent
scripts_dir = (skill_dir / "scripts").resolve()
script_path = (scripts_dir / script_name).resolve()
try:
script_path.relative_to(scripts_dir)
except ValueError:
print(f"❌ Script path escapes scripts directory: {script_name}")
sys.exit(1)
if not script_path.is_file():
print(f"❌ Script not found: {script_name}")
print(f" Working directory: {Path.cwd()}")
print(f" Skill directory: {skill_dir}")
print(f" Looked for: {script_path}")
sys.exit(1)
# Ensure venv exists and get Python executable
try:
venv_python = ensure_venv()
except ValueError as exc:
print(f"ERROR: {exc}")
sys.exit(1)
# Build command
cmd = [str(venv_python), str(script_path)] + script_args
# Run the script
try:
result = subprocess.run(cmd)
sys.exit(result.returncode)
except KeyboardInterrupt:
print("\n⚠️ Interrupted by user")
sys.exit(130)
except Exception as e:
print(f"❌ Error: {e}")
sys.exit(1)
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |