CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

notebooklm

Browser automation skill for controlling Google's NotebookLM. Use when the user wants anything done in NotebookLM (e.g., 'open NotebookLM', 'check my [name] notebook', 'ask my notebook about X', 'add [source] to NotebookLM', 'generate a Video Overview from my notebook', 'use NotebookLM Studio'). Handles reading and querying notebooks, adding sources (URLs, text, files, YouTube links, synthesized content), generating Studio outputs (Audio/Video Overviews, Mind Maps, Reports incl. Briefing Doc/Study Guide/FAQ, Flashcards, Quiz, slide decks, infographics — discover the exact set from the live Studio panel; the UI evolves fast), and creating new notebooks. Requires browser automation environment — fails gracefully when unavailable.

66

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is notebooklm in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is operationally excellent — clearly sequenced per-action workflows, screenshot-based validation checkpoints, and an error-recovery table — but it is undermined by heavy internal repetition and a broken bundle contract: every referenced reference and script file is absent from the bundle, making the one code example non-executable and all 'See … for the canon' links dead.

Suggestions

Ship the referenced bundle files (references/browser_automation_canon.md, references/studio_output_custom_prompts.md, references/async_action_discipline.md, scripts/action_router.py, scripts/custom_prompt_template_generator.py, scripts/async_action_classifier.py) or remove the dead 'See … for the canon' links and tooling-table entries — every referenced path is currently absent from the bundle.

Consolidate the Studio output inventory (currently enumerated in Q1, Q3, the Action 3 'Discover, don't assume' paragraph, and the async table) and the fire-and-notify rule (stated in Action 3, Critical Async Behavior, and Anti-Patterns) into one authoritative section each, cutting roughly a third of the body's tokens with no loss of clarity.

Trim the duplicated 'default Studio prompts produce mediocre output' rationale, which appears in Q3, Q4, and the Anti-Patterns list, to a single statement.

DimensionReasoningScore

Conciseness

All content is product-specific operational knowledge Claude does not already know (UI flows, wait times, async behavior), so there is no concept-teaching padding — but the body carries substantial deliberate redundancy: the Studio output inventory is enumerated in Q1, Q3, Action 3, and the async table; the fire-and-notify rule is stated in Action 3, the Critical Async Behavior section, and the anti-patterns list; 'default prompts produce mediocre output' appears three times. Matches 'mostly efficient but could be tightened' rather than score 4 ('minor instances') or score 2 (no padded sections teaching known concepts).

3 / 5

Actionability

Concrete throughout: quoted halt messages, the exact URL, a per-source-type UI flow table, timed waits (3–5s, 5–10 min, <30s), verbatim copy-paste custom prompts, and a usage example for the async classifier. Not score 5: the example bash command (and the entire tooling table) references scripts that are absent from the bundle, so that one command is not actually executable — though the fully inlined async table compensates for the missing script's content. Not score 3: the guidance is otherwise complete and executable.

4 / 5

Workflow Clarity

Clear sequenced workflows with explicit validation checkpoints: mandatory Step 0 environment gate, screenshot validation before and after every meaningful interaction ('wait for ingestion spinner, screenshot to confirm success', 'confirm generation has started via screenshot'), and an error-handling table with feedback loops (retry once, disambiguate with screenshots, ask user). Matches the top anchor — sequence, explicit validation, and error recovery are all present.

5 / 5

Progressive Disclosure

The body itself is well-sectioned with clearly signaled one-level-deep references ('See references/studio_output_custom_prompts.md for the canon'), but all six referenced bundle files (3 references/*.md, 3 scripts/*.py) are missing from the bundle — navigation to every referenced path fails. Not score 4 ('references mostly clear' fails when every referenced file is absent); not score 2 (in-body structure is good and essential content is inlined, so the skill still functions without the missing files).

3 / 5

Total

15

/

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: it clearly states what the skill does across all four action paths, gives an explicit 'Use when…' clause with six concrete natural-language triggers, and carves out a distinct niche. The only weakness is minor missing synonyms (e.g., 'podcast' for Audio Overview) in the trigger examples.

DimensionReasoningScore

Specificity

Enumerates all four action paths with concrete sub-types: 'reading and querying notebooks, adding sources (URLs, text, files, YouTube links, synthesized content), generating Studio outputs (Audio/Video Overviews, Mind Maps, Reports incl. Briefing Doc/Study Guide/FAQ, Flashcards, Quiz, slide decks, infographics), and creating new notebooks.' Coverage is comprehensive across the skill's action space, matching the anchor for multiple specific concrete actions — not score 4, which requires 'minor gaps in coverage'.

5 / 5

Completeness

Explicitly answers both questions: a clear multi-action 'what' (Handles reading/querying, adding sources, generating Studio outputs, creating notebooks) and an explicit 'Use when the user wants anything done in NotebookLM' with concrete trigger phrases, plus an environment constraint ('Requires browser automation environment — fails gracefully when unavailable'). Matches the top anchor exactly.

5 / 5

Trigger Term Quality

Six natural example phrasings ('open NotebookLM', 'check my [name] notebook', 'ask my notebook about X', 'add [source] to NotebookLM', 'generate a Video Overview from my notebook', 'use NotebookLM Studio') are exactly what a user would say. Not score 5: common synonyms such as 'podcast' or 'Audio Overview' as a literal trigger phrase are absent, so coverage is good but not comprehensive.

4 / 5

Distinctiveness Conflict Risk

NotebookLM — a specific named Google product — appears in every trigger phrase, and the browser-automation framing further narrows the niche. Clear niche with distinct triggers and minimal conflict risk with other skills; nothing here would fire for the wrong skill.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 7 missing

Warning

referenced_paths_exist

Referenced path issues: 19 missing

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/notebooklm/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.