CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

nlm-skill

Expert guide for the Gemini Notebook (formerly Google NotebookLM) CLI (`nlm`) and MCP server - interfaces for Gemini Notebook. Use this skill when users want to interact with Gemini Notebook programmatically, including: creating/managing notebooks, checking plan usage and quota windows, adding sources (URLs, YouTube, text, Google Drive), generating content (podcasts, reports, interactive reports, quizzes, flashcards, mind maps, slides, infographics, videos, data tables), conducting research, chatting with sources, or automating Gemini Notebook workflows. Triggers on mentions of "nlm", "notebooklm", "Gemini Notebook", "plan usage", "quota", "podcast generation", "audio overview", "interactive report", "lesson report", "refactor document", "critique draft", or any Gemini Notebook-related automation task.

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

73%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 exceptionally actionable — every command family has executable syntax, flags, and validation gates for destructive operations, and workflows are clearly sequenced with error-recovery loops. Its weakness is token efficiency: a 1160-line body carries duplicated sections, inline version-history paragraphs, and server-operator detail that the existing reference files were created to hold.

Suggestions

Move the version-specific paragraphs (v0.15.3 login completion, v0.15.4 headless refresh, v0.15.5 refresh safety, the 0.6.14 conversation-cache bounds and startup-flags material) into references/troubleshooting.md and references/remote-mcp.md, leaving one-line pointers in SKILL.md.

Delete the duplicated "Renaming Resources" section — the source-rename commands already appear in Section 3 (Source Management) — and consolidate the MCP-vs-CLI surface guidance that currently appears in both "Tool Detection" and "Critical Rules".

Trim the inline per-command listings to the most common commands and defer full signatures to references/command_reference.md, which already exists for exactly that purpose.

DimensionReasoningScore

Conciseness

The 1160-line body is noticeably verbose with several padded or duplicated sections: the "Renaming Resources" section repeats `nlm source rename`/`nlm rename source` commands already shown in Section 3; inline version changelogs ("Login completion (v0.15.3+)", "Headless refresh & CDP port fallback (v0.15.4+)", "Refresh safety (v0.15.5+)", the 0.16.0 experimental and 0.6.14 cache sections) embed time-sensitive version detail outside any deprecation section; and server-operator material (conversation-cache bounds tables, cache-stats JSON, startup flags, the full 43-extension list) is inlined. This matches the score-2 anchor ("several unnecessary explanations or padded sections") rather than 3 (only some tightening needed); it avoids a 1 because it never explains concepts Claude already knows — nearly all lines are tool-specific commands and behavior notes.

2 / 5

Actionability

Commands are copy-paste ready with exact flags for every family (e.g. `nlm audio create <id> --format deep_dive --length default --confirm`, `nlm research start "query" --notebook-id <id> --mode deep`), MCP signatures include parameter names and allowed values (e.g. `studio_create` options table, `source_sync_drive(source_ids=[...], confirm=True)`), and env vars, status values, and error remediations are all concrete. This fully matches the score-5 anchor: specific executable examples cover the common cases.

5 / 5

Workflow Clarity

Multi-step processes are explicitly sequenced with validation checkpoints: a surface-selection decision tree, a Workflow Decision Tree mapping user intent to command sequences, end-to-end Common Patterns, and an Error Recovery table giving fix-retry feedback loops. Destructive and batch operations carry explicit gates ("⚠️ ALWAYS ASK USER BEFORE DELETE", `--confirm`/`confirm=True` requirements, "Check aliases before creating", "Check plan usage before quota-limited work"), so the destructive/batch cap of 3 does not apply — validation is present, matching the score-5 anchor.

5 / 5

Progressive Disclosure

All six bundle files (studio-prompting-guide.md, studio-prompt-examples.md, command_reference.md, troubleshooting.md, workflows.md, remote-mcp.md) exist, are one level deep, and are clearly signaled in an "Advanced Reference" section with per-file descriptions plus working inline links (Workflows 15/16/17 in workflows.md and the troubleshooting anchor all resolve). However, the body inlines large blocks that belong in those references — near-complete command listings duplicating command_reference.md and auth-recovery internals overlapping troubleshooting.md — which is more than the "minor organization gaps" of the score-5 anchor but better than the muddled structure of 3.

4 / 5

Total

16

/

20

Passed

Description

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

An exemplary description: it names the niche and both product names, enumerates concrete capabilities comprehensively, and gives an explicit 'Use this skill when...' clause backed by a rich trigger-term list. The only weakness is a handful of context-free trigger terms (quota, podcast generation, refactor document) that create minor overlap risk with unrelated skills.

DimensionReasoningScore

Specificity

Quotes: "creating/managing notebooks, checking plan usage and quota windows, adding sources (URLs, YouTube, text, Google Drive), generating content (podcasts, reports, interactive reports, quizzes, flashcards, mind maps, slides, infographics, videos, data tables), conducting research, chatting with sources". This lists many specific concrete actions with comprehensive coverage across the CLI/MCP surface, matching the score-5 anchor; it is not merely 1-2 actions (3) nor has minor gaps (4).

5 / 5

Completeness

Quotes: "Expert guide for the Gemini Notebook... CLI (`nlm`) and MCP server" (what) and "Use this skill when users want to interact with Gemini Notebook programmatically... Triggers on mentions of..." (when). Both what and when are answered explicitly with concrete trigger phrases, matching the score-5 anchor exactly; the when-clause is present and specific, so the missing-when cap at 3 does not apply.

5 / 5

Trigger Term Quality

Quotes: "Triggers on mentions of \"nlm\", \"notebooklm\", \"Gemini Notebook\", \"plan usage\", \"quota\", \"podcast generation\", \"audio overview\", \"interactive report\", \"lesson report\", \"refactor document\", \"critique draft\"". Comprehensive natural-term coverage including both product names (old and new) and task phrasings users would actually say; file extensions are not applicable to a CLI skill, so coverage is effectively complete.

5 / 5

Distinctiveness Conflict Risk

Quotes: "Gemini Notebook (formerly Google NotebookLM) CLI (`nlm`)" establishes a clear niche, but bare trigger terms like "quota", "plan usage", "podcast generation", "refactor document", and "critique draft" can fire outside a NotebookLM context and overlap with podcast/audio or document-editing skills. This fits the score-4 anchor ("mostly distinct; minor overlap risk with closely related skills") better than 5 ("minimal conflict risk") because of those generic trigger terms, and better than 3 since the product-named niche is unmistakable. Third-person voice is used throughout, so no voice penalty applies.

4 / 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

skill_md_line_count

SKILL.md is long (1161 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

jacob-bd/gemini-notebook-mcp-cli

Path

src/notebooklm_tools/data/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.