notebooklm-superskill
ainergiz/notebooklm-superskillGenerate slide decks, audio podcasts, infographics, and video overviews from NotebookLM notebooks. Customizable by audience, format, language (80+), orientation, and visual themes. Use when asked to generate slides, create podcast, make infographic, video overview, or automate NotebookLM content creation.
SKILL.md
name: notebooklm-superskill description: Generate slide decks, audio podcasts, infographics, and video overviews from NotebookLM notebooks. Customizable by audience, format, language (80+), orientation, and visual themes. Use when asked to generate slides, create podcast, make infographic, video overview, or automate NotebookLM content creation. allowed-tools: Bash, Read, Glob, Grep
NotebookLM SuperSkill
Generate professional content from NotebookLM notebooks: slides, podcasts, infographics, and videos.
When to Use This Skill
Use this skill when the user wants to:
- Generate slide decks for different audiences (technical, investor, customer, executive, beginner)
- Create AI podcast-style audio overviews
- Make visual infographics from research
- Generate video overviews/explainers
- Automate NotebookLM content creation
Critical: Always Use run.py Wrapper
All scripts MUST be run through run.py to ensure proper virtual environment setup:
python scripts/run.py <script_name> [args...]
Authentication (One-Time Setup)
Before first use, authenticate with Google:
# Interactive login (browser opens)
python scripts/run.py auth_manager.py setup
# Check status
python scripts/run.py auth_manager.py status
# Validate credentials work
python scripts/run.py auth_manager.py validate
Quick Reference
1. Slide Decks
Generate presentation slides with audience-specific customization.
# Single slide deck
python scripts/run.py generate_slides.py \
--notebook-url "https://notebooklm.google.com/notebook/..." \
--audience technical \
--format detailed \
--length default
# Multiple audiences at once
python scripts/run.py generate_slides.py \
--notebook-url URL \
--audiences technical,investor,customer
Options:
| Option | Values | Description |
|---|---|---|
--audience |
technical, investor, customer, executive, beginner | Target audience |
--audiences |
comma-separated | Generate multiple decks |
--format |
detailed, presenter | Slide format |
--length |
short, default, long | Slide count |
--source |
path | Upload source file first |
--prompt |
text | Custom prompt (overrides audience) |
2. Audio Overviews (Podcasts)
Generate AI podcast-style deep dive discussions.
python scripts/run.py generate_audio.py \
--notebook-url URL \
--format deep-dive \
--language en-US
Options:
| Option | Values | Description |
|---|---|---|
--format |
deep-dive, brief, critique, debate | Podcast style |
--language |
en-US, es-ES, fr-FR, de-DE, ja-JP, etc. | 80+ languages |
--prompt |
text | Custom instructions |
Note: Audio generation takes 5-10 minutes.
3. Infographics
Generate visual infographics for different platforms.
python scripts/run.py generate_infographic.py \
--notebook-url URL \
--orientation landscape \
--detail standard
Options:
| Option | Values | Description |
|---|---|---|
--orientation |
square, portrait, landscape | Aspect ratio |
--detail |
concise, standard, detailed | Information density |
--prompt |
text | Custom instructions |
Orientations:
square- 1:1 for social media postsportrait- 9:16 for Instagram Stories, TikToklandscape- 16:9 for LinkedIn, presentations
4. Video Overviews
Generate video explainers with visual themes.
python scripts/run.py generate_video.py \
--notebook-url URL \
--format explainer \
--theme futuristic
Options:
| Option | Values | Description |
|---|---|---|
--format |
brief, explainer | Video length |
--theme |
retro-90s, futuristic, corporate, minimal | Visual style |
--custom-theme |
text | Custom theme description |
--prompt |
text | Custom instructions |
Note: Video generation takes 10-15 minutes.
Decision Flow
-
User wants slides? → Use
generate_slides.py- Multiple audiences? Use
--audiencesflag - Single audience? Use
--audienceflag
- Multiple audiences? Use
-
User wants podcast/audio? → Use
generate_audio.py- Non-English? Specify
--language - Quick summary? Use
--format brief
- Non-English? Specify
-
User wants visual summary? → Use
generate_infographic.py- Social media? Consider
--orientation portrait - Presentation? Use
--orientation landscape
- Social media? Consider
-
User wants video? → Use
generate_video.py- Quick overview? Use
--format brief - Training material? Use
--format explainer
- Quick overview? Use
Common Options
All scripts support:
--output DIR- Output directory (default: current)--headless- Run without visible browser--help- Show detailed help
Example Workflows
Investor Pitch Materials
# Generate investor slides
python scripts/run.py generate_slides.py --notebook-url URL --audience investor
# Create brief overview podcast
python scripts/run.py generate_audio.py --notebook-url URL --format brief
# Make landscape infographic for deck
python scripts/run.py generate_infographic.py --notebook-url URL --orientation landscape
Training Content
# Beginner-friendly slides
python scripts/run.py generate_slides.py --notebook-url URL --audience beginner --length long
# Deep dive podcast
python scripts/run.py generate_audio.py --notebook-url URL --format deep-dive
# Explainer video
python scripts/run.py generate_video.py --notebook-url URL --format explainer
Social Media Content
# Portrait infographic for stories
python scripts/run.py generate_infographic.py --notebook-url URL --orientation portrait --detail concise
# Brief video with trendy theme
python scripts/run.py generate_video.py --notebook-url URL --format brief --theme retro-90s
Troubleshooting
Authentication issues:
python scripts/run.py auth_manager.py reauth
Script not found:
- Ensure you're in the skill directory
- Use full path:
python /path/to/scripts/run.py ...
Timeout errors:
- Audio/video generation takes time (5-15 min)
- Use
--headlessfor faster execution - Check notebook has sufficient source content
Additional Resources
For detailed guides on each feature, see:
README
NotebookLM SuperSkill
Generate slides, podcasts, infographics, and videos from NotebookLM notebooks using browser automation.
Features
- Slide Decks - Generate presentations for different audiences (technical, investor, customer, executive, beginner)
- Audio Overviews - Create AI podcast-style discussions in 80+ languages
- Infographics - Visual summaries in multiple orientations
- Video Overviews - Explainer videos with customizable themes
Installation
As a Claude Code Skill
- Clone this repo to your skills directory:
git clone https://github.com/ainergiz/notebooklm-superskill.git ~/.claude/skills/notebooklm-superskill
- Restart Claude Code to load the skill.
Standalone Usage
- Clone the repository:
git clone https://github.com/ainergiz/notebooklm-superskill.git
cd notebooklm-superskill
- Run any script (virtual environment is set up automatically):
python scripts/run.py auth_manager.py setup
Quick Start
1. Authenticate (One-Time)
python scripts/run.py auth_manager.py setup
A browser window opens. Log in to your Google account. The session is saved for future use.
2. Generate Content
# Slides
python scripts/run.py generate_slides.py --notebook-url URL --audience technical
# Audio podcast
python scripts/run.py generate_audio.py --notebook-url URL --format deep-dive
# Infographic
python scripts/run.py generate_infographic.py --notebook-url URL --orientation landscape
# Video
python scripts/run.py generate_video.py --notebook-url URL --format explainer
Options Reference
Slide Generation
| Option | Values | Default |
|---|---|---|
--audience |
technical, investor, customer, executive, beginner | technical |
--audiences |
comma-separated list | - |
--format |
detailed, presenter | detailed |
--length |
short, default, long | default |
--source |
file path | - |
--prompt |
custom text | - |
Audio Generation
| Option | Values | Default |
|---|---|---|
--format |
deep-dive, brief, critique, debate | deep-dive |
--language |
en-US, es-ES, fr-FR, etc. | en-US |
--prompt |
custom text | - |
Infographic Generation
| Option | Values | Default |
|---|---|---|
--orientation |
square, portrait, landscape | landscape |
--detail |
concise, standard, detailed | standard |
--prompt |
custom text | - |
Video Generation
| Option | Values | Default |
|---|---|---|
--format |
brief, explainer | brief |
--theme |
retro-90s, futuristic, corporate, minimal | corporate |
--custom-theme |
custom description | - |
--prompt |
custom text | - |
Common Options
All scripts support:
--output DIR- Output directory--headless- Run without visible browser--help- Show help
Architecture
notebooklm-superskill/
├── SKILL.md # Claude Code skill file
├── scripts/
│ ├── run.py # Universal wrapper (handles venv)
│ ├── auth_manager.py # Authentication
│ ├── generate_slides.py
│ ├── generate_audio.py
│ ├── generate_infographic.py
│ └── generate_video.py
└── data/ # Runtime data (gitignored)
└── browser_state/ # Cookies, profile
How It Works
- Browser Automation - Uses Patchright (Playwright fork) with real Chrome for reliability
- Anti-Detection - Persistent browser profile, cookie injection, human-like interactions
- Artifact Monitoring - Detects generation completion via shimmer animation detection
- Download Handling - Captures downloads via Playwright's download handler
Requirements
- Python 3.8+
- Google account with NotebookLM access
- Chrome browser (installed automatically by Patchright)
Troubleshooting
Authentication Expired
python scripts/run.py auth_manager.py reauth
Timeout During Generation
Audio and video generation can take 5-15 minutes. The scripts have built-in timeouts:
- Slides/Infographics: 3 minutes
- Audio: 10 minutes
- Video: 15 minutes
Browser Issues
# Reinstall Chrome for Patchright
python -m patchright install chrome
License
MIT