CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

notebooklm

Interact with Google NotebookLM to query documentation with Gemini's source-grounded answers. Each question opens a fresh browser session, retrieves the answer exclusively from your uploaded documents, and closes.

Quality

69%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/notebooklm/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 a well-structured, highly actionable operational guide with a clear sequenced workflow, explicit checkpoints, and a follow-up feedback loop. Its weaknesses are redundancy — the run.py rule, script command listings, and troubleshooting content are repeated both within SKILL.md and against the reference files — and a few non-executable comment placement errors in multi-line command examples.

Suggestions

Replace the inline 'Script Reference' and 'Troubleshooting' sections with pointers to references/api_reference.md and references/troubleshooting.md, keeping only the most common commands inline.

State the run.py wrapper rule once in a prominent early section and remove the repetitions in 'Environment Management', 'Best Practices', and 'Troubleshooting'.

Fix the multi-line 'notebook_manager.py add' example so comments are not placed after line-continuation backslashes, making it directly copy-paste executable.

DimensionReasoningScore

Conciseness

The body is mostly command listings rather than concept explanations, which is efficient, but it has clear redundancy: the 'Script Reference' section repeats commands already shown in 'Core Workflow', the run.py rule is stated in at least four places ('Critical: Always Use run.py Wrapper', 'Environment Management', 'Best Practices', 'Troubleshooting'), and the inline troubleshooting table duplicates references/troubleshooting.md. Not 4 because the duplicated script-reference and repeated warnings are more than minor trimmable instances; not 2 because the core content is executable commands, not padded prose.

3 / 5

Actionability

Nearly all guidance is copy-paste-ready bash with exact flags, placeholders, and expected behavior (e.g. 'python scripts/run.py auth_manager.py status', '--question "..." --notebook-id ID'). Not 5 because the multi-line 'notebook_manager.py add' example embeds comments after line-continuation backslashes ('--description "..." \ # REQUIRED - ASK USER IF UNKNOWN!'), which is not valid copy-paste bash, and the Smart Add workflow relies on '[Based on content]' placeholders without a concrete worked example.

4 / 5

Workflow Clarity

The core workflow is clearly sequenced (check auth → setup → manage library → ask questions) with an explicit decision-flow diagram, an auth checkpoint before operations, a preview-then-confirm pattern for the destructive cleanup, and an explicit follow-up feedback loop ('STOP / ANALYZE / IDENTIFY GAPS / ASK FOLLOW-UP / REPEAT / SYNTHESIZE'). Not 5 because the destructive 'notebook_manager.py remove' command has no verification step and error-recovery guidance lives only in a troubleshooting table rather than inline in the workflow.

4 / 5

Progressive Disclosure

The bundle structure is good: three real, one-level-deep reference files (api_reference.md, troubleshooting.md, usage_patterns.md) are clearly named with descriptions in the 'Resources' section, and the body is organized into scannable sections. Not 5 because substantial content that duplicates the reference files (the full 'Script Reference' and 'Troubleshooting' sections) is inlined in SKILL.md instead of being pointed to, and references are signaled only in a bottom-of-file section rather than at the point of need.

4 / 5

Total

15

/

20

Passed

Description

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

The description clearly communicates what the skill does and sits in a distinct, low-conflict niche anchored by the NotebookLM product name. Its main weaknesses are the missing 'Use when...' trigger clause (capping completeness) and thin synonym/trigger-term coverage, plus a second sentence spent on browser-session mechanics that would be better used on capabilities.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user mentions NotebookLM, shares a notebooklm.google.com link, or asks to query their uploaded docs/notebooks.'

Broaden natural trigger terms with synonyms users would actually say: 'notebooks', 'docs', 'ask my notebook', 'query my documentation'.

Replace the browser-session mechanics sentence with a sentence covering the other capabilities (add/list/search notebooks, one-time Google auth) for fuller coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Google NotebookLM') and one concrete capability ('query documentation with Gemini's source-grounded answers'), but the second sentence ('Each question opens a fresh browser session, retrieves the answer exclusively from your uploaded documents, and closes') describes implementation mechanics rather than user-facing capabilities. Coverage is not comprehensive — notebook library management, authentication, and adding notebooks are absent. Not 4 because only one real capability is listed; not 2 because the query action and grounding constraint are concretely stated.

3 / 5

Completeness

The 'what' is clear and concrete (interact with NotebookLM to query documentation with source-grounded answers), but the 'when' is entirely missing — there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps this dimension at 3 per the judging guidelines. Not 4 because 'your uploaded documents' weakly implies a precondition but provides no trigger guidance at all.

3 / 5

Trigger Term Quality

Relevant keywords are present ('NotebookLM', 'query documentation', 'Gemini', 'source-grounded answers', 'uploaded documents'), with 'NotebookLM' being the natural term a user would say. However, common variations and synonyms are missing — no 'notebooks', 'docs', 'ask my notebook', or trigger-adjacent phrases users would naturally use. Not 4 because keyword coverage stops at the product name and a couple of domain words with no synonyms.

3 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche: 'Google NotebookLM' and 'Gemini's source-grounded answers' name a specific product and mechanism, making it highly unlikely to trigger for the wrong skill. Not 4 because no closely related skill (e.g., a generic docs-search skill) shares these distinct triggers.

5 / 5

Total

14

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

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.