CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

notebooklm

Install, authenticate, troubleshoot, and operate Gemini Notebook through the notebooklm-py CLI or typed async Python API. Use for notebook and source management, grounded chat and research, and artifact generation or download when the user mentions Gemini Notebook, notebooklm-py, the notebooklm CLI, or its Python API. Do not use for the generic Gemini API or unrelated content creation.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Failed to scan

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An operationally excellent skill body: copy-paste-ready commands, ID-pinned workflows with real validation gates, and failure-handling feedback loops, with no filler. Its main weakness is organization across files — everything is inlined in one long SKILL.md while the bundled scripts/ files are entirely unreferenced.

Suggestions

Move stable reference material (auth/headless setup detail, Generation Notes by type, the Python API baseline) into references/ files (e.g. references/auth.md, references/generators.md, references/python-api.md) and keep SKILL.md as a lean overview with clearly signaled one-level-deep links.

Either reference the relevant bundled scripts/ files from the body (e.g. in the failure-handling or CI sections) or remove them from the skill bundle, since ~55 shipped files are currently undiscoverable.

Tighten the longest sections (Authorization Boundaries, Operating Invariants) into terse rules and trim the marginal "Skill Installation" section to lift conciseness from good to lean.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious operational specifics (exit codes, JSON envelope fields, concurrency invariants, auth edge cases) and explains nothing Claude already knows, matching the "efficient; minor instances of over-explanation" anchor. It does not reach 5 because some heavily qualified sentences and the peripheral "Skill Installation" section could be trimmed without losing operational value.

4 / 5

Actionability

Guidance is fully executable: exact commands with flags ("notebooklm source wait {source_id} -n {notebook_id} --timeout 600"), JSON paths to capture (".notebook.id", ".source.id", ".task_id"), exit-code semantics, and a complete runnable Python example covering the common create-add-ask-generate-download case. This matches the copy-paste-ready anchor.

5 / 5

Workflow Clarity

The canonical workflow is a clearly sequenced 6-step process with explicit validation gates ("Require .status == \"ok\" and .checks.token_fetch == true", "Require wait exit 0 and status == \"ready\"", "download only after the wait exits 0") and a failure-handling section with feedback loops (branch on exit code, revalidate token_fetch, inspect before retry). This matches the anchor for explicit validation steps and error-recovery loops.

5 / 5

Progressive Disclosure

Sections are well-organized and external docs are clearly signaled ("when available, consult the [installation guide]"), but all 316 lines live in one file — the auth troubleshooting, Generation Notes, and Python API material are natural candidates for separate reference files. Additionally, the bundle ships ~55 files under scripts/ that SKILL.md never references, so content that should be separate is inline while provided bundle content goes unmentioned. This fits anchor 3 (some structure, content that should be separate is inline) better than anchor 4.

3 / 5

Total

17

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete lifecycle capabilities, explicit use/don't-use triggers in third person, and a clear product niche. The only weakness is that trigger coverage omits a few natural variations such as "NotebookLM" alone or "Google NotebookLM".

Suggestions

Add "NotebookLM" and "Google NotebookLM" as trigger terms alongside "Gemini Notebook" to catch the most common ways users name the product.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions spanning the tool's full lifecycle — "Install, authenticate, troubleshoot, and operate" plus "notebook and source management, grounded chat and research, and artifact generation or download" — which matches the anchor for comprehensive coverage of specific concrete actions. It exceeds anchor 4 because there are no minor gaps: setup, operations, and troubleshooting are all enumerated with the two interfaces (CLI and Python API).

5 / 5

Completeness

It explicitly answers "what" (first sentence enumerating capabilities) and "when" ("Use for ... when the user mentions Gemini Notebook, notebooklm-py, the notebooklm CLI, or its Python API"), plus an explicit when-not ("Do not use for the generic Gemini API or unrelated content creation"). This clearly matches the anchor requiring both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Triggers "Gemini Notebook, notebooklm-py, the notebooklm CLI, or its Python API" are natural phrases a user would say, giving good keyword coverage across product-name variants. It falls short of anchor 5 because common variations like "NotebookLM" alone or "Google NotebookLM" are absent, but it is clearly above anchor 3 since multiple natural terms and synonyms of the product name are present.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (the NotebookLM product via a specific package) with distinct product-name triggers and an explicit negative boundary against the generic Gemini API and unrelated content creation, giving minimal conflict risk with other skills.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

teng-lin/notebooklm-py

Path

SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.