Skip to content

Add notebooklm skill#73

Closed
apcg2001 wants to merge 1 commit into
kepano:mainfrom
apcg2001:add/notebooklm-skill
Closed

Add notebooklm skill#73
apcg2001 wants to merge 1 commit into
kepano:mainfrom
apcg2001:add/notebooklm-skill

Conversation

@apcg2001
Copy link
Copy Markdown

Summary

  • Adds a notebooklm skill that connects Claude Code to Google NotebookLM for cited Q&A against large source corpora
  • Converts [N] citation markers in NotebookLM answers to clickable [[Source#^anchor|[N]]] Obsidian wikilinks pointing to exact transcript passages (~96% resolution accuracy)
  • Includes scripts for bulk-loading YouTube channels (200 videos in ~75s, no API key needed), importing sources as vault notes with AI-generated guides, and backfilling transcripts

What changed

New skill: skills/notebooklm/

File Purpose
SKILL.md Skill definition and workflow routing
scripts/load_channel.py Scrape YouTube channel + async bulk-load into NotebookLM
scripts/import_sources.py Import NotebookLM sources as Obsidian vault notes
scripts/resolve_citations.py Resolve [N] citations to [[Source#^anchor]] wikilinks
scripts/extract_passages.py Extract cited passages from Q&A into source files
scripts/backfill_fulltext.py Backfill transcripts for existing source files
workflows/ask.md Q&A with citation resolution
workflows/import.md Import notebook sources to vault
workflows/youtube-channel.md Bulk YouTube channel loader
workflows/auth.md Google authentication guide

Prerequisites

uv tool install notebooklm-py --python 3.11   # requires Python 3.10+
uv tool install notebooklm-mcp-cli
playwright install chromium
notebooklm login   # browser auth (Google)
nlm login          # browser auth (Google)

Obsidian Dataview plugin required for notebook dashboards.

Test plan

  • notebooklm list returns notebooks without errors after auth
  • nlm notebook list returns notebooks without errors after auth
  • load_channel.py scrape fetches video list from a YouTube channel URL
  • import_sources.py creates source .md files with correct frontmatter
  • resolve_citations.py converts [N] to wikilinks in Q&A output
  • Citation links in Obsidian jump to correct passage anchors

Credits

Original skill concept and implementation by @ArtemXTech. This PR ports it to the obsidian-skills format.

🤖 Generated with Claude Code

Integrates Google NotebookLM into the Claude Code skills system.

## What this does

Turns any expert content corpus (YouTube channels, PDFs, web pages) into
a cited knowledge base queryable from Claude Code, with answers linked back
to exact source passages as clickable Obsidian wikilinks.

## Workflow

1. **Load sources** — bulk-import YouTube channels or other content into a
   NotebookLM notebook via the `notebooklm` CLI (async, 200 videos in ~75s)
2. **Query with citations** — ask questions via `nlm notebook query`, get
   answers with `[N]` citation markers traced to exact transcript passages
3. **Resolve to wikilinks** — `resolve_citations.py` converts `[N]` to
   `[[Source#^anchor|[N]]]` clickable links that jump to cited passages
4. **Import to vault** — source files with transcripts, cited passages, and
   AI-generated guides land in `Notes/NotebookLM/{slug}/`

## Files

- `SKILL.md` — skill definition and routing table
- `scripts/load_channel.py` — YouTube channel scraper + async NotebookLM loader
- `scripts/import_sources.py` — imports NotebookLM sources as vault notes
- `scripts/resolve_citations.py` — resolves `[N]` to Obsidian block anchors (~96% accuracy)
- `scripts/extract_passages.py` — extracts cited passages into source files
- `scripts/backfill_fulltext.py` — backfills transcripts into existing source files
- `workflows/ask.md` — Q&A with citation resolution workflow
- `workflows/import.md` — import notebook sources to vault
- `workflows/youtube-channel.md` — bulk YouTube channel loader workflow
- `workflows/auth.md` — Google authentication via browser

## Prerequisites

```bash
uv tool install notebooklm-py --python 3.11
uv tool install notebooklm-mcp-cli
playwright install chromium
notebooklm login  # browser auth
nlm login         # browser auth
```

## Credits

Original skill by ArtemXTech (https://github.com/ArtemXTech/personal-os-skills)
@apcg2001 apcg2001 closed this May 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant