Agent skill · software engineering · tiangong-ai
notebooklm
NotebookLM CLI wrapper via `python3 {baseDir}/scripts/notebooklm.py` (backed by notebooklm-py). Use for auth, notebooks, chat, sources, notes, sharing, research, and artifact generation/download.
Why this skill is useful
Adds specific commands and workflows for using the NotebookLM CLI that the AI wouldn't reliably generate on its own.
What it needs
Requires notebooklm-py installed locally. Requires notebooklm account access. About 3k tokens when loaded. Last updated 2026-08-06. 7 stars on the source repository.
What this skill does
NotebookLM CLI Wrapper (Python) Required parameters python3 available. notebooklm-py installed (CLI binary: notebooklm). NotebookLM authenticated (login). Quick start Wrapper script: scripts/notebooklm.py. Command form: python3 {baseDir}/scripts/notebooklm.py <command> [args...]. Output guidance Prefer --json for machine-readable output where supported. Long-running waits are handled by native commands like: source wait artifact wait research wait ⚡ Sub-Agent Delegation (Anti-Blocking) Problem NotebookLM operations like source wait, artifact wait, research wait, generate slide-deck, and source add-research can take minutes to complete. Running them in the main session blocks the conversation. Strategy For any operation expected to take >30 seconds, delegate to a sub-agent via sessionsspawn: 1. Main session: Acknowledge the user's request, then spawn a sub-agent with a clear task description. 2. Sub-agent: Executes the long-running NotebookLM commands, waits for completion, and reports back. 3. Main session: Remains responsive. The sub-agent auto-announces completion. Which operations to delegate Operation Delegate? Reason ----------- ----------- -------- login, status, list, use, clear ❌ No Fast (<5s) ask (chat) ❌ No Usually fast (~10s) source list, source get, note list ❌ No Fast reads source add (URL/text) ⚠️ Maybe Fast to submit, but source wait after is slow source add-research ✅ Yes Deep research can take 2-5 min source wait ✅ Yes Polling wait, unpredictable duration generate slide-deck + artifact wait ✅ Yes Generation takes 1-5 min research wait ✅ Yes Can take several minutes download slide-deck ⚠️ Maybe Usually fast, but can be slow for large files Multi-step workflows (add sources → wait → generate → wait → download) ✅ Yes Compound long tasks How to spawn Example: Generate slide deck User: "帮我用 notebook X 生成一个 PPT" Main session response: 好的，我派了一个后台任务去生成 PPT，完成后会通知你 ✧ Spawn: Example: Add research source User: "在 notebook Y 里加一个关于碳足迹的深度研究" Spawn: Guidelines Al …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills tiangong-ai/notebooklm-Invoke