CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

73

Quality

90%

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

88%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.

A high-quality, operational skill body with executable examples, a well-sequenced validated workflow, and clear failure-handling feedback loops. Slight trimming in a few dense sections and tighter organization would reach the top anchors.

Suggestions

Tighten the Authorization Boundaries bullet list and Generation Notes where guidance overlaps, to push conciseness toward the leanest anchor.

Consider splitting the long CLI reference table and deep-research timing detail into a referenced doc to improve progressive-disclosure navigation.

Add a one-line per-section purpose lead-in so the dense operational invariants are easier to scan.

DimensionReasoningScore

Conciseness

Dense and operational with no concept over-explanation, assuming Claude's competence throughout; a few sections (authorization enumeration, generation notes) could be trimmed slightly to hit the leanest anchor.

4 / 5

Actionability

Provides copy-paste-ready bash and Python examples with exact flags and ID capture semantics ('notebooklm auth check --test --json', the full NotebookLMClient async example), covering the common cases concretely.

5 / 5

Workflow Clarity

The Canonical Source-to-Artifact Workflow is explicitly sequenced with authorization gates, source/artifact waits, and status validation; the Failure Handling section adds a diagnose-then-branch-on-exit-code feedback loop for recovery.

5 / 5

Progressive Disclosure

Well-sectioned single file with one-level-deep, clearly signaled external references (installation guide, CLI reference, Python API guide) and inline baselines when those are unavailable; most content is appropriately placed with minor organization gaps.

4 / 5

Total

18

/

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, third-person description that concretely enumerates capabilities, supplies explicit trigger conditions, and adds a negative boundary to avoid mis-routing. Minor additional synonyms could push trigger-term coverage to the top anchor.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Install, authenticate, troubleshoot, and operate', 'notebook and source management, grounded chat and research, and artifact generation or download' — giving comprehensive coverage of capabilities rather than vague language.

5 / 5

Completeness

Explicitly answers both what (install/authenticate/troubleshoot/operate via CLI or Python API) and when ('Use for ... when the user mentions ...') with concrete trigger phrases, plus a negative boundary.

5 / 5

Trigger Term Quality

Includes natural terms users would say — 'Gemini Notebook, notebooklm-py, the notebooklm CLI, or its Python API' — with good coverage, though a few synonyms/variations are not enumerated.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (Gemini Notebook via notebooklm-py) with distinct triggers and an explicit exclusion ('Do not use for the generic Gemini API or unrelated content creation'), minimizing conflict risk.

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
teng-lin/notebooklm-py
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.