Files
our-claude-skills/custom-skills/50-notebooklm-agent/SKILL.md
Andrew Yim 6ac547e78f
Some checks failed
Verify Skills / verify-skills (push) Has been cancelled
refactor(skills): clean skill names (strip NN- prefix from name:) — convention change
Adopt: directory keeps its NN- ordering prefix; skill `name:` is the clean form
without it (dir 16-seo-schema-validator → name: seo-schema-validator). Nicer to
invoke, matches the original desktop/SKILL.md names, still globally unique.

- 71 root SKILL.md: name: NN-foo → name: foo (flat skills + reference-curator suite).
  Plugins (mac-optimizer/multi-agent-guide/dintel-bootstrap) already clean; 95 already clean.
- scripts/migrate_skill_root.py: derive name = dirname minus NN- prefix (skill_name()).
- CLAUDE.md + SKILL-MIGRATION-GUIDE.md: document the dir-prefix / clean-name convention.

verify_skills.py: 0 name collisions across all renamed skills. (The ~/.claude/skills
symlinks were re-pointed to the clean names separately — filesystem only.)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-28 02:11:01 +09:00

2.9 KiB

name, description
name description
notebooklm-agent Q&A agent for NotebookLM notebooks. Ask questions and get grounded, citation-backed answers from your sources. Triggers: ask NotebookLM, query notebook, research question, 노트북 질문, NotebookLM 에이전트.

NotebookLM Agent

Q&A agent that answers questions using NotebookLM's Gemini-powered analysis. Returns grounded responses with source citations.

Prerequisites

NotebookLM CLI must be installed and authenticated:

pip install notebooklm-py
playwright install chromium
notebooklm login

When This Skill Activates

  • User asks "ask NotebookLM about X"
  • User wants to "query my notebook"
  • User needs "research answers from sources"
  • Korean: "노트북LM에서 찾아줘", "노트북 질문"

Quick Reference

Task Command
List notebooks notebooklm list
Set active notebook notebooklm use <id>
Ask question notebooklm ask "question"
New conversation notebooklm ask "question" --new
With citations notebooklm ask "question" --json
Specific sources notebooklm ask "q" -s src1 -s src2

Workflow

1. Select Notebook

# List available notebooks
notebooklm list

# Set context (use partial ID)
notebooklm use abc123

2. Ask Questions

# Simple question
notebooklm ask "What are the main findings?"

# Follow-up (continues conversation)
notebooklm ask "Can you elaborate on point 2?"

# New conversation
notebooklm ask "Different topic" --new

# Query specific sources only
notebooklm ask "Compare these two" -s source1_id -s source2_id

3. Get Structured Output

For citations and references, use --json:

notebooklm ask "Summarize the methodology" --json

Returns:

{
  "answer": "The methodology involves... [1] [2]",
  "references": [
    {"source_id": "abc...", "citation_number": 1, "cited_text": "..."},
    {"source_id": "def...", "citation_number": 2, "cited_text": "..."}
  ]
}

Autonomy Rules

Run automatically:

  • notebooklm list - view notebooks
  • notebooklm status - check context
  • notebooklm source list - view sources
  • notebooklm ask "..." - answer questions

Ask before running:

  • notebooklm delete - destructive operations
  • notebooklm source add - modifies notebook

Tips

  1. Set context first: Always use a notebook before asking
  2. Use --json for citations: Get structured references for research
  3. Continue conversations: Omit --new for follow-up questions
  4. Filter sources: Use -s to query specific documents only

Error Handling

Error Solution
"No notebook context" Run notebooklm use <id>
Auth error Run notebooklm login
Source not found Check notebooklm source list
  • notebooklm-automation: Full notebook management
  • notebooklm-studio: Generate podcasts, videos, quizzes
  • notebooklm-research: Add sources and research workflows