Agent-Skills.md

Agent Skills: notebooklm-cli

When the user needs NotebookLM operations → unified CLI (command/op) returning structured results.

UncategorizedID: cklxx/elephant.ai/notebooklm-cli

Repository

cklxx/elephant.ai
cklxxLicense: MIT
111

Install this agent skill to your local

pnpm dlx add-skill https://github.com/cklxx/elephant.ai/tree/HEAD/skills/notebooklm-cli

Skill Files

Browse the full folder contents for notebooklm-cli.

Download Skill

Loading file tree…

skills/notebooklm-cli/SKILL.md

Skill Metadata

Name
notebooklm-cli
Description
When the user needs NotebookLM operations → unified CLI (command/op) returning structured results.

notebooklm-cli

独立本地运行，不依赖任何 channel 注册。 统一入口：

python3 skills/notebooklm-cli/run.py <command> [op] [--flag value ...]

渐进式 help（给 LLM 先学契约）

  • overview：入口、环境变量、命令总览
  • schema：全部命令契约（推荐机器读取）
  • <command>：单命令契约
  • progressive：overview + 各命令契约链路
python3 skills/notebooklm-cli/run.py help --topic overview
python3 skills/notebooklm-cli/run.py help --topic schema
python3 skills/notebooklm-cli/run.py help --topic progressive

如果需要底层原生命令帮助，可加：

python3 skills/notebooklm-cli/run.py help --topic source --include_cli true

输入契约（统一）

  • command: help | auth | notebook | source | query | report | studio | raw
  • op: 命令内操作；不填走默认 op（见 help/schema）
  • 兼容旧别名：action, *_action，新代码统一用 command/op
  • 统一返回字段：success, command, exit_code, stdout, stderr, hints, error?

命令总览（精简）

  • auth: 登录与 profile 管理（profile_delete 强制 confirm=true）
  • notebook: list/create/get/describe/rename/query/delete（delete 强制确认）
  • source: list/add_*/get/describe/content/rename/delete（delete 强制确认）
  • query: notebook query 快捷入口
  • report: create（默认），强制确认，支持 format/prompt/language/source_ids
  • studio: status/rename/delete（delete 强制确认）
  • raw: 透传 argv；禁止 nlm chat start；delete 需 confirm=true

最小 E2E 示例

python3 skills/notebooklm-cli/run.py auth check
python3 skills/notebooklm-cli/run.py notebook create --title 'NLM E2E'
python3 skills/notebooklm-cli/run.py source add_url --notebook_id '<nb-id>' --url https://example.com/article
python3 skills/notebooklm-cli/run.py query --notebook_id '<nb-id>' --question '总结 3 个关键结论'
python3 skills/notebooklm-cli/run.py report --notebook_id '<nb-id>' --confirm true
python3 skills/notebooklm-cli/run.py studio status --notebook_id '<nb-id>'

规则

  • 删除前必须显式确认：confirm=true。
  • 禁止交互式 nlm chat start。
  • 鉴权失败先执行 auth/login 再重试业务命令。