notebook-guidance

Guides creation and execution of Jupyter notebooks for BigQuery data analysis and visualization.

1|Updated Aug 30, 2026
One-click install
npx skills add https://github.com/FeexSystems/3WM-SONIK-LABS --skill notebook-guidance-feexsystems
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notebook-guidance
Source: https://github.com/FeexSystems/3WM-SONIK-LABS/tree/main/.gemini/skills/notebook-guidance
Command: npx skills add https://github.com/FeexSystems/3WM-SONIK-LABS --skill notebook-guidance-feexsystems

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bigframes, ipykernel.

What problem does it solve? Data analysis tasks often require multi-step queries, iterative exploration, and visualizations that are hard to manage in one-off scripts. This Skill provides structured rules for building, executing, and validating Jupyter notebooks, especially when querying BigQuery, so analyses are reproducible, readable, and error-free. ## Core Features & Use Cases - Conditional Execution Workflow: Enforces a generate-cell, execute-cell, validate-output loop when an execution tool is available, or full-notebook generation with user-run verification when it is not. - BigQuery Integration Rules: Mandates the use of bigframes %%bqsql magics instead of the Python BigQuery client, with required dataframe export and BigFrames-based manipulation and ML. - Notebook Structure & Visualization Standards: Defines a story-like layout with markdown sections, plotting rules, data cleaning constraints, and a mandatory grounded summary. - Use Case: A user asks to explore user retention trends stored in BigQuery. The Skill guides kernel setup, incremental %%bqsql query cells, BigFrames transformations, charts, and a final summary of findings. ## Quick Start Create a Jupyter notebook that queries my BigQuery table and visualizes the key trends in the data.

Frequently Asked Questions about notebook-guidance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query BigQuery from a Jupyter notebook?▼

Use the bigframes %%bqsql cell magic instead of the Python BigQuery client library. Load it with %load_ext bigframes, then write %%bqsql df_name followed by your SQL to export results directly into a BigFrames dataframe.

When should I use a notebook for data analysis?▼

Use a notebook when the task involves insights, trends, visualizations, or iterative multi-step exploration. Skip it for simple single-value lookups like row counts or schema previews, which do not benefit from a notebook format.

Can I use pandas or scikit-learn with BigQuery dataframes?▼

No, BigFrames dataframes should be manipulated with BigFrames methods, and machine learning must use BQML SQL or bigframes.ml. Avoid to_pandas() except for small visualization-ready subsets.

Why does my notebook cell fail with no active kernel?▼

This error means no execution backend is attached to the notebook. Stop generating cells, select or start the appropriate kernel such as local Python or Dataproc Serverless Spark, and confirm it is active before continuing.

How do I install Python packages in a remote Spark or Colab kernel?▼

First run %pip list or try importing the package, since managed runtimes pre-install many common libraries. Only use %pip install for packages confirmed missing, as these environments are often ephemeral.