Files
our-claude-skills/custom-skills/50-notebooklm-agent/SKILL.md
Andrew Yim e519a49cc4 feat(skills): bulk-add root SKILL.md to 61 skills (native Agent Skills loadability)
Run the additive migration pass from SKILL-MIGRATION-GUIDE: generate a root SKILL.md
for every skill that lacked one, copied from its desktop/SKILL.md (or code/SKILL.md),
with name set to the directory name and description + body preserved verbatim.

- scripts/migrate_skill_root.py: the reusable, non-destructive migrator (dry-run default).
- 61 new root SKILL.md (desktop source for most; code/SKILL.md for 61/62/92).
- Untouched: 16/17/95 (already had root); desktop/ and code/ packaging left intact.
- All 64 root SKILL.md validate: frontmatter <=1024, kebab name, description present.

Still MANUAL (no SKILL.md source — commands/README only), need hand-authored root SKILL.md:
81-mac-optimizer, 90-reference-curator, 91-multi-agent-guide, 94-dintel-bootstrap.

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

2.9 KiB

name, description
name description
50-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