bigquery

Query BigQuery for customer usage and health metrics into structured JSON.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/al-stev/field-eng-skills --skill bigquery-al-stev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bigquery
Source: https://github.com/al-stev/field-eng-skills/tree/main/.claude/skills/bigquery
Command: npx skills add https://github.com/al-stev/field-eng-skills --skill bigquery-al-stev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandas, pyyaml, google-cloud-bigquery, and includes scripts (resource) components.

What problem does it solve?

Provide a reliable, automated way to fetch and aggregate customer usage and health metrics from W&B's BigQuery so engineers and CS teams avoid manual queries and multi-tab copy-paste when preparing dashboards, QBRs, and adoption analyses. The skill centralizes seat utilization, Weave ingestion, tracked hours, account health, product-area adoption, power-user identification, and support ticket summaries into a single structured output. It handles missing sections gracefully and enriches results with SFDC entitlement data when available.

Core Features & Use Cases

  • Aggregated Usage Pipeline: Runs parameterized BigQuery queries to produce a JSON payload matching the INTELLIGENCE_DATA.usage schema for dashboards and reports.
  • Multiple Metric Categories: Seat utilization (weekly history), Weave ingestion (monthly), tracked hours, product-area breakdowns, power users, account health, and support tickets.
  • Operational Safety & Enrichment: Uses Application Default Credentials for auth, enforces query cost guardrails, falls back when data is missing, and can enrich BQ snapshots with SFDC fields for accurate headlines.

Quick Start

Run the bigquery skill to produce usage JSON for a customer, for example: uv run --project .claude/skills/bigquery python .claude/skills/bigquery/scripts/usage.py --customer GResearch

Frequently Asked Questions about bigquery

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

FAQPage Schema
How do I pull customer usage metrics from BigQuery for account analytics?

Query BigQuery for customer usage metrics by running parameterized queries against the wandb-production dataset to extract seat utilization, Weave ingestion, and tracked hours. The process returns structured JSON matching the INTELLIGENCE_DATA.usage schema for direct use in dashboards and reports.

What BigQuery customer health metrics can I aggregate for QBR preparation?

Aggregated customer health metrics include seat utilization history, Weave ingestion volumes, product-area adoption breakdowns, power user lists, account health scores, and support ticket summaries. These categories are consolidated into a single structured JSON payload to streamline QBR and adoption analysis.

Do I need Application Default Credentials to query BigQuery usage data?

Application Default Credentials are required to authenticate and run parameterized BigQuery queries for usage reporting. The skill enforces this authentication method to securely access the wandb-production BigQuery project and retrieve customer analytics data.

How do I automate seat utilization and Weave ingestion reporting without manual SQL?

Automate seat utilization and Weave ingestion reporting by executing a Python script that runs parameterized BigQuery queries and outputs structured JSON. This centralizes multi-tab copy-paste workflows into a single command, producing dashboard-ready data without manual SQL.

What happens if BigQuery usage data is missing for certain metric categories?

When BigQuery usage data is missing for certain sections, the query pipeline applies graceful degradation to return partial results without failing. It also enriches available BigQuery snapshots with SFDC entitlement fields to maintain accurate headline metrics.

Does BigQuery reporting work with pandas for customer analytics workflows?

BigQuery reporting integrates with pandas as a core dependency to process and structure customer analytics data. The workflow queries BigQuery, returns structured JSON, and leverages pandas alongside pyyaml and google-cloud-bigquery to support usage reporting pipelines.