chendongqi/OPB-Skills

Executable file

Playwright/Patchright has a known bug ([#36139](https://github.com/microsoft/playwright/issues/36139)) where **session cookies** (cookies without an `Expires` attribute) do not persist correctly when using `launch_persistent_context()` with

But **Python's Playwright API doesn't support this** ([#14949](https://github.com/microsoft/playwright/issues/14949)):

[Credential-related source omitted]

- [microsoft/playwright#36139](https://github.com/microsoft/playwright/issues/36139) - Session cookies not persisting

- [microsoft/playwright#14949](https://github.com/microsoft/playwright/issues/14949) - Storage state with persistent context

- [StackOverflow Question](https://stackoverflow.com/questions/79641481/) - Session cookie persistence issue

Executable file

**Let [Claude Code](https://github.com/anthropics/claude-code) chat directly with NotebookLM for source-grounded answers based exclusively on your uploaded documents**

[![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://www.python.org/)

[![Claude Code Skill](https://img.shields.io/badge/Claude%20Code-Skill-purple.svg)](https://www.anthropic.com/news/skills)

[![Based on](https://img.shields.io/badge/Based%20on-NotebookLM%20MCP-green.svg)](https://github.com/PleasePrompto/notebooklm-mcp)

[![GitHub](https://img.shields.io/github/stars/PleasePrompto/notebooklm-skill?style=social)](https://github.com/PleasePrompto/notebooklm-skill)

[Installation](#installation) • [Quick Start](#quick-start) • [Why NotebookLM](#why-notebooklm-not-local-rag) • [How It Works](#how-it-works) • [MCP Alternative](https://github.com/PleasePrompto/notebooklm-mcp)

**This skill works ONLY with local [Claude Code](https://github.com/anthropics/claude-code) installations, NOT in the web UI.**

The web UI runs skills in a sandbox without network access, which this skill requires for browser automation. You must use [Claude Code](https://github.com/anthropics/claude-code) locally on your machine.

When you tell [Claude Code](https://github.com/anthropics/claude-code) to "search through my local documentation", here's what happens:

This Claude Code Skill lets [Claude Code](https://github.com/anthropics/claude-code) chat directly with [**NotebookLM**](https://notebooklm.google/) — Google's **source-grounded knowledge base** powered by Gemini 2.5 that provides intellige

# 2. Clone this repository cd ~/.claude/skills git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm

git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm

Go to [notebooklm.google.com](https://notebooklm.google.com) → Create notebook → Upload your docs:

This is a **Claude Code Skill** - a local folder containing instructions and scripts that Claude Code can use when needed. Unlike the [MCP server version](https://github.com/PleasePrompto/notebooklm-mcp), this runs directly in Claude Code w

[Credential-related source omitted]

rm -rf .venv

This skill is inspired by my [**NotebookLM MCP Server**](https://github.com/PleasePrompto/notebooklm-mcp) and provides an alternative implementation as a Claude Code Skill:

If you need: - **Persistent sessions** → Use the [MCP Server](https://github.com/PleasePrompto/notebooklm-mcp)

- **Persistent sessions** → Use the [MCP Server](https://github.com/PleasePrompto/notebooklm-mcp)

- **Multiple tool support** (Codex, Cursor) → Use the [MCP Server](https://github.com/PleasePrompto/notebooklm-mcp)

# Get started in 30 seconds cd ~/.claude/skills git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm

cd ~/.claude/skills git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm # Open Claude Code: "What are my skills?"

git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm

Built as a Claude Code Skill adaptation of my [NotebookLM MCP Server](https://github.com/PleasePrompto/notebooklm-mcp)

Executable file

Trigger when user: - Mentions NotebookLM explicitly - Shares NotebookLM URL (`https://notebooklm.google.com/notebook/...`)

- Mentions NotebookLM explicitly - Shares NotebookLM URL (`https://notebooklm.google.com/notebook/...`) - Asks to query their notebooks/documentation

- Shares NotebookLM URL (`https://notebooklm.google.com/notebook/...`)

# Add notebook to library (ALL parameters are REQUIRED!) python scripts/run.py notebook_manager.py add \   --url "https://notebooklm.google.com/notebook/..." \

python scripts/run.py notebook_manager.py add    --url "https://notebooklm.google.com/notebook/..."

--url "https://notebooklm.google.com/notebook/..." \

# Query with notebook URL directly python scripts/run.py ask_question.py --question "..." --notebook-url "https://..."

python scripts/run.py ask_question.py --question "..." --notebook-url "https://..."

[Credential-related source omitted]

Executable file

# With direct URL python scripts/run.py ask_question.py --question "..." --notebook-url "https://..."

python scripts/run.py ask_question.py --question "..." --notebook-url "https://..."

# Then add with discovered info python scripts/run.py notebook_manager.py add \   --url "https://notebooklm.google.com/notebook/..." \

python scripts/run.py notebook_manager.py add    --url "https://notebooklm.google.com/notebook/..."

--url "https://notebooklm.google.com/notebook/..." \

# Direct add (when you know the content) python scripts/run.py notebook_manager.py add \   --url "https://notebooklm.google.com/notebook/..." \

python scripts/run.py notebook_manager.py add    --url "https://notebooklm.google.com/notebook/..."

--url "https://notebooklm.google.com/notebook/..." \

[Credential-related source omitted]

Executable file

# Add notebook if missing python scripts/run.py notebook_manager.py add \   --url "https://notebooklm.google.com/..." \

python scripts/run.py notebook_manager.py add    --url "https://notebooklm.google.com/..."

--url "https://notebooklm.google.com/..." \

# Use proxy if needed export HTTP_PROXY=http://proxy:port

export HTTP_PROXY=http://proxy:port

export HTTPS_PROXY=http://proxy:port

rm ~/.claude/skills/notebooklm/data/library.json

rm -rf .venv

rm -rf .venv

Executable file

# Ask: "What topics should I tag it with?" python scripts/run.py notebook_manager.py add \   --url "https://notebooklm.google.com/notebook/..." \

python scripts/run.py notebook_manager.py add    --url "https://notebooklm.google.com/notebook/..."

--url "https://notebooklm.google.com/notebook/..." \

Executable file

#!/usr/bin/env python3

#!/usr/bin/env python3

- Persistent browser profile (user_data_dir) for fingerprint consistency - Manual cookie injection from state.json for session cookies (Playwright bug workaround) See: https://github.com/microsoft/playwright/issues/36139

- Manual cookie injection from state.json for session cookies (Playwright bug workaround) See: https://github.com/microsoft/playwright/issues/36139 """

See: https://github.com/microsoft/playwright/issues/36139

page.wait_for_url(re.compile(r"^https://notebooklm\.google\.com/"), timeout=10000)

#!/usr/bin/env python3

- Persistent browser profile (user_data_dir) for fingerprint consistency - Manual cookie injection from state.json for session cookies (Playwright bug workaround) See: https://github.com/microsoft/playwright/issues/36139

- Manual cookie injection from state.json for session cookies (Playwright bug workaround) See: https://github.com/microsoft/playwright/issues/36139 """

See: https://github.com/microsoft/playwright/issues/36139

page = context.new_page()             page.goto("https://notebooklm.google.com", wait_until="domcontentloaded")

page.goto("https://notebooklm.google.com", wait_until="domcontentloaded")

timeout_ms = int(timeout_minutes * 60 * 1000)                 page.wait_for_url(re.compile(r"^https://notebooklm\.google\.com/"), timeout=timeout_ms)

page.wait_for_url(re.compile(r"^https://notebooklm\.google\.com/"), timeout=timeout_ms)

page = context.new_page()             page.goto("https://notebooklm.google.com", wait_until="domcontentloaded", timeout=30000)

page.goto("https://notebooklm.google.com", wait_until="domcontentloaded", timeout=30000)

#!/usr/bin/env python3

Executable file

[Credential-related source omitted]

#!/usr/bin/env python3

'--force',         action='store_true',         help='Skip confirmation prompt'

action='store_true',         help='Skip confirmation prompt'     )

help='Skip confirmation prompt'

Executable file

#!/usr/bin/env python3

#!/usr/bin/env python3

#!/usr/bin/env python3

# Install Chrome for Patchright (not Chromium!)                 # Using real Chrome ensures cross-platform reliability and consistent browser fingerprinting                 # See: https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python#an

# See: https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python#anti-detection

*欢迎来我中的[个人主页](https://home.wonlab.top)找到更多有用的知识和有趣的产品*

<Img src="https://example.com/image.png" />

<Video src="https://remotion.media/video.mp4" />

Executable file

Executable file

Executable file

<Audio src="https://remotion.media/audio.mp3" />

<Composition id="MyComp" component={MyComponent} durationInFrames={300} fps={30} width={1920} height={1080} defaultProps={{videoSrc: 'https://remotion.media/video.mp4'}} calculateMetadata={calculateMetadata} />

const calculateMetadata: CalculateMetadataFunction<Props> = async ({props, abortSignal}) => {   const response = await fetch(props.dataUrl, {signal: abortSignal});

const response = await fetch(props.dataUrl, {signal: abortSignal});

const src = "https://remotion.media/video.mp4";

const calculateMetadata: CalculateMetadataFunction<MyCompositionProps> = async ({props, abortSignal}) => {   const data = await fetch(`https://api.example.com/video/${props.videoId}`, {

const data = await fetch(`https://api.example.com/video/${props.videoId}`, {

await extractFrames({   src: "https://remotion.media/video.mp4",

src: "https://remotion.media/video.mp4",

await extractFrames({   src: "https://remotion.media/video.mp4",

src: "https://remotion.media/video.mp4",

try {   await extractFrames({     src: "https://remotion.media/video.mp4",

await extractFrames({     src: "https://remotion.media/video.mp4",     timestampsInSeconds: [0, 1, 2, 3, 4],

src: "https://remotion.media/video.mp4",

await Promise.race([     extractFrames({       src: "https://remotion.media/video.mp4",

extractFrames({       src: "https://remotion.media/video.mp4",       timestampsInSeconds: [0, 1, 2, 3, 4],

src: "https://remotion.media/video.mp4",

const duration = await getAudioDuration("https://remotion.media/audio.mp3");

const dimensions = await getVideoDimensions("https://remotion.media/video.mp4");

const duration = await getVideoDuration("https://remotion.media/video.mp4");

<AnimatedImage src="https://example.com/animation.gif" width={500} height={500} />

<Img src="https://example.com/image.png" />

const fetchCaptions = useCallback(async () => {     try {       const response = await fetch(staticFile('subtitles.srt'));

try {       const response = await fetch(staticFile('subtitles.srt'));       const text = await response.text();

const response = await fetch(staticFile('subtitles.srt'));

Remote URLs are also supported - you can `fetch()` a remote file via URL instead of using `staticFile()`.

useEffect(() => {     fetch('https://assets4.lottiefiles.com/packages/lf20_zyquagfl.json')

fetch('https://assets4.lottiefiles.com/packages/lf20_zyquagfl.json')

Maps can be added to a Remotion video with Mapbox.   The [Mapbox documentation](https://docs.mapbox.com/mapbox-gl-js/api/) has the API reference.

The [Mapbox documentation](https://docs.mapbox.com/mapbox-gl-js/api/) has the API reference.

The user needs to create a free Mapbox account and create an access token by visiting https://console.mapbox.com/account/access-tokens/.

[Credential-related source omitted]

[Credential-related source omitted]

style: '<U+2060>mapbox://styles/mapbox/standard',

Tailwind must be installed and enabled first in a Remotion project - fetch  https://www.remotion.dev/docs/tailwind using WebFetch for instructions.

- `@remotion/install-whisper-cpp` - Transcribe locally on a server using Whisper.cpp. Fast and free, but requires server infrastructure.   https://remotion.dev/docs/install-whisper-cpp

https://remotion.dev/docs/install-whisper-cpp

- `@remotion/whisper-web` - Transcribe in the browser using WebAssembly. No server needed and free, but slower due to WASM overhead.   https://remotion.dev/docs/whisper-web

https://remotion.dev/docs/whisper-web

- `@remotion/openai-whisper` - Use OpenAI Whisper API for cloud-based transcription. Fast and no server needed, but requires payment.   https://remotion.dev/docs/openai-whisper/openai-whisper-api-to-captions

https://remotion.dev/docs/openai-whisper/openai-whisper-api-to-captions

<Video src="https://remotion.media/video.mp4" />

sudo apt update && sudo apt install python3

No,Category,Issue,Keywords,Platform,Description,Do,Don't,Code Example Good,Code Example Bad,Severity 1,Async Waterfall,Defer Await,async await defer branch,React/Next.js,Move await into branches where actually used to avoid blocking unused 

1,Async Waterfall,Defer Await,async await defer branch,React/Next.js,Move await into branches where actually used to avoid blocking unused code paths,Move await operations into branches where they're needed,Await at top of function blocking

2,Async Waterfall,Promise.all Parallel,promise all parallel concurrent,React/Next.js,Execute independent async operations concurrently using Promise.all(),Use Promise.all() for independent operations,Sequential await for independent operati

3,Async Waterfall,Dependency Parallelization,better-all dependency parallel,React/Next.js,Use better-all for operations with partial dependencies to maximize parallelism,Use better-all to start each task at earliest possible moment,Wait for

14,Server,Parallel Fetching,parallel fetch component composition,React/Next.js,Restructure components to parallelize data fetching in RSC,Use component composition for parallel fetches,Sequential fetches in parent component,"<Header /><Side

15,Server,After Non-blocking,after non-blocking logging,React/Next.js,Use Next.js after() to schedule work after response is sent,Use after() for logging/analytics,Block response for non-critical operations,"after(async () => { await logAct

16,Client,SWR Deduplication,swr dedup cache revalidate,React/Next.js,Use SWR for automatic request deduplication and caching,Use useSWR for client data fetching,Manual fetch in useEffect,"const { data } = useSWR('/api/users', fetcher)","use

No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL 1,Widgets,Use StatelessWidget when possible,Immutable widgets are simpler,StatelessWidget for static UI,StatefulWidget for everything,class MyWidget extends Sta

1,Widgets,Use StatelessWidget when possible,Immutable widgets are simpler,StatelessWidget for static UI,StatefulWidget for everything,class MyWidget extends StatelessWidget,class MyWidget extends StatefulWidget (static),Medium,https://api.f

2,Widgets,Keep widgets small,Single responsibility principle,Extract widgets into smaller pieces,Large build methods,Column(children: [Header() Content()]),500+ line build method,Medium, 3,Widgets,Use const constructors,Compile-time constan

3,Widgets,Use const constructors,Compile-time constants for performance,const MyWidget() when possible,Non-const for static widgets,const Text('Hello'),Text('Hello') for literals,High,https://dart.dev/guides/language/language-tour#constant-

4,Widgets,Prefer composition over inheritance,Combine widgets using children,Compose widgets,Extend widget classes,Container(child: MyContent()),class MyContainer extends Container,Medium, 5,State,Use setState correctly,Minimal state in Sta

5,State,Use setState correctly,Minimal state in StatefulWidget,setState for UI state changes,setState for business logic,setState(() { _counter++; }),Complex logic in setState,Medium,https://api.flutter.dev/flutter/widgets/State/setState.ht

6,State,Avoid setState in build,Never call setState during build,setState in callbacks only,setState in build method,onPressed: () => setState(() {}),build() { setState(); },High, 7,State,Use state management for complex apps,Provider River

7,State,Use state management for complex apps,Provider Riverpod BLoC,State management for shared state,setState for global state,Provider.of<MyState>(context),Global setState calls,Medium, 8,State,Prefer Riverpod or Provider,Recommended sta

8,State,Prefer Riverpod or Provider,Recommended state solutions,Riverpod for new projects,InheritedWidget manually,ref.watch(myProvider),Custom InheritedWidget,Medium,https://riverpod.dev/

9,State,Dispose resources,Clean up controllers and subscriptions,dispose() for cleanup,Memory leaks from subscriptions,@override void dispose() { controller.dispose(); },No dispose implementation,High, 10,Layout,Use Column and Row,Basic lay

10,Layout,Use Column and Row,Basic layout widgets,Column Row for linear layouts,Stack for simple layouts,"Column(children: [Text(), Button()])",Stack for vertical list,Medium,https://api.flutter.dev/flutter/widgets/Column-class.html

11,Layout,Use Expanded and Flexible,Control flex behavior,Expanded to fill space,Fixed sizes in flex containers,Expanded(child: Container()),Container(width: 200) in Row,Medium, 12,Layout,Use SizedBox for spacing,Consistent spacing,SizedBox

12,Layout,Use SizedBox for spacing,Consistent spacing,SizedBox for gaps,Container for spacing only,SizedBox(height: 16),Container(height: 16),Low, 13,Layout,Use LayoutBuilder for responsive,Respond to constraints,LayoutBuilder for adaptive 

13,Layout,Use LayoutBuilder for responsive,Respond to constraints,LayoutBuilder for adaptive layouts,Fixed sizes for responsive,LayoutBuilder(builder: (context constraints) {}),Container(width: 375),Medium,https://api.flutter.dev/flutter/wi

14,Layout,Avoid deep nesting,Keep widget tree shallow,Extract deeply nested widgets,10+ levels of nesting,Extract widget to method or class,Column(Row(Column(Row(...)))),Medium, 15,Lists,Use ListView.builder,Lazy list building,ListView.buil

15,Lists,Use ListView.builder,Lazy list building,ListView.builder for long lists,ListView with children for large lists,"ListView.builder(itemCount: 100, itemBuilder: ...)",ListView(children: items.map(...).toList()),High,https://api.flutte

16,Lists,Provide itemExtent when known,Skip measurement,itemExtent for fixed height items,No itemExtent for uniform lists,ListView.builder(itemExtent: 50),ListView.builder without itemExtent,Medium, 17,Lists,Use keys for stateful items,Pres

17,Lists,Use keys for stateful items,Preserve widget state,Key for stateful list items,No key for dynamic lists,ListTile(key: ValueKey(item.id)),ListTile without key,High, 18,Lists,Use SliverList for custom scroll,Custom scroll effects,Cust

18,Lists,Use SliverList for custom scroll,Custom scroll effects,CustomScrollView with Slivers,Nested ListViews,CustomScrollView(slivers: [SliverList()]),ListView inside ListView,Medium,https://api.flutter.dev/flutter/widgets/SliverList-clas

19,Navigation,Use Navigator 2.0 or GoRouter,Declarative routing,go_router for navigation,Navigator.push for complex apps,GoRouter(routes: [...]),Navigator.push everywhere,Medium,https://pub.dev/packages/go_router

20,Navigation,Use named routes,Organized navigation,Named routes for clarity,Anonymous routes,Navigator.pushNamed(context '/home'),Navigator.push(context MaterialPageRoute()),Low, 21,Navigation,Handle back button (PopScope),Android back beh

21,Navigation,Handle back button (PopScope),Android back behavior and predictive back (Android 14+),Use PopScope widget (WillPopScope is deprecated),Use WillPopScope,"PopScope(canPop: false, onPopInvoked: (didPop) => ...)",WillPopScope(onWi

22,Navigation,Pass typed arguments,Type-safe route arguments,Typed route arguments,Dynamic arguments,MyRoute(id: '123'),arguments: {'id': '123'},Medium, 23,Async,Use FutureBuilder,Async UI building,FutureBuilder for async data,setState for 

23,Async,Use FutureBuilder,Async UI building,FutureBuilder for async data,setState for async,FutureBuilder(future: fetchData()),fetchData().then((d) => setState()),Medium,https://api.flutter.dev/flutter/widgets/FutureBuilder-class.html

24,Async,Use StreamBuilder,Stream UI building,StreamBuilder for streams,Manual stream subscription,StreamBuilder(stream: myStream),stream.listen in initState,Medium,https://api.flutter.dev/flutter/widgets/StreamBuilder-class.html

25,Async,Handle loading and error states,Complete async UI states,ConnectionState checks,Only success state,if (snapshot.connectionState == ConnectionState.waiting),No loading indicator,High, 26,Async,Cancel subscriptions,Clean up stream su

26,Async,Cancel subscriptions,Clean up stream subscriptions,Cancel in dispose,Memory leaks,subscription.cancel() in dispose,No subscription cleanup,High, 27,Theming,Use ThemeData,Consistent theming,ThemeData for app theme,Hardcoded colors,T

27,Theming,Use ThemeData,Consistent theming,ThemeData for app theme,Hardcoded colors,Theme.of(context).primaryColor,Color(0xFF123456) everywhere,Medium,https://api.flutter.dev/flutter/material/ThemeData-class.html

29,Theming,Access theme via context,Dynamic theme access,Theme.of(context),Static theme reference,Theme.of(context).textTheme.bodyLarge,TextStyle(fontSize: 16),Medium, 30,Theming,Support dark mode,Respect system theme,darkTheme in MaterialA

30,Theming,Support dark mode,Respect system theme,darkTheme in MaterialApp,Light theme only,"MaterialApp(theme: light, darkTheme: dark)",MaterialApp(theme: light),Medium, 31,Animation,Use implicit animations,Simple animations,AnimatedContai

31,Animation,Use implicit animations,Simple animations,AnimatedContainer AnimatedOpacity,Explicit for simple transitions,AnimatedContainer(duration: Duration()),AnimationController for fade,Low,https://api.flutter.dev/flutter/widgets/Animat

32,Animation,Use AnimationController for complex,Fine-grained control,AnimationController with Ticker,Implicit for complex sequences,AnimationController(vsync: this),AnimatedContainer for staggered,Medium, 33,Animation,Dispose AnimationCont

33,Animation,Dispose AnimationControllers,Clean up animation resources,dispose() for controllers,Memory leaks,controller.dispose() in dispose,No controller disposal,High, 34,Animation,Use Hero for transitions,Shared element transitions,Hero

34,Animation,Use Hero for transitions,Shared element transitions,Hero for navigation animations,Manual shared element,Hero(tag: 'image' child: Image()),Custom shared element animation,Low,https://api.flutter.dev/flutter/widgets/Hero-class.h

35,Forms,Use Form widget,Form validation,Form with GlobalKey,Individual validation,Form(key: _formKey child: ...),TextField without Form,Medium,https://api.flutter.dev/flutter/widgets/Form-class.html

39,Performance,Use const widgets,Reduce rebuilds,const for static widgets,No const for literals,const Icon(Icons.add),Icon(Icons.add),High, 40,Performance,Avoid rebuilding entire tree,Minimal rebuild scope,Isolate changing widgets,setState 

40,Performance,Avoid rebuilding entire tree,Minimal rebuild scope,Isolate changing widgets,setState on parent,Consumer only around changing widget,setState on root widget,High, 41,Performance,Use RepaintBoundary,Isolate repaints,RepaintBoun

41,Performance,Use RepaintBoundary,Isolate repaints,RepaintBoundary for animations,Full screen repaints,RepaintBoundary(child: AnimatedWidget()),Animation without boundary,Medium,https://api.flutter.dev/flutter/widgets/RepaintBoundary-class

42,Performance,Profile with DevTools,Measure before optimizing,Flutter DevTools profiling,Guess at performance,DevTools performance tab,Optimize without measuring,Medium,https://docs.flutter.dev/tools/devtools

43,Accessibility,Use Semantics widget,Screen reader support,Semantics for accessibility,Missing accessibility info,Semantics(label: 'Submit button'),GestureDetector without semantics,High,https://api.flutter.dev/flutter/widgets/Semantics-cl