# BigQuery Troubleshooting (agent skill)

> BigQuery Troubleshooting is an agent skill (a SKILL.md file) from google/skills. It provides diagnostic workflows and step-by-step root-cause analysis procedures for actively broken, failing, or slow BigQuery jobs, execution graph and query plan stage bottlenecks, system. It works with Claude Code, Codex and Gemini CLI and has 20,994 GitHub stars across a repository of 6 listed skills.

Provides diagnostic workflows and step-by-step root-cause analysis procedures for actively broken, failing, or slow BigQuery jobs, execution graph and query plan stage bottlenecks, system performance issues, or unexpectedly expensive workloads. Use when interpreting symptoms, isolating bottlenecks, diagnosing cost spikes (on-demand query spend, capacity slot autoscaling, storage growth), execution graph stages or substep variables, identifying root causes, and determining remediation steps.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/google/skills |
| Skill path | skills/cloud/bigquery-troubleshooting/SKILL.md |
| Skill name | bigquery-troubleshooting |
| GitHub stars | 20,994 |
| Installs on skills.sh | not listed |
| License | Apache-2.0 |
| Skills in repo | 6 |
| Plugin marketplace | google-plugins |
| Official | yes |
| Works with | Claude Code, Codex, Gemini CLI |
| Category | Data & analysis |
| Last commit | Oct 6, 2026 |

## When it triggers

- use analysis procedures for actively broken, failing, or slow BigQuery jobs, execution graph and query plan stage bottlenecks, system performance issues, or unexpectedly expensive workloads.
- Use when interpreting symptoms, isolating bottlenecks, diagnosing cost spikes (on-demand query spend, capacity slot autoscaling, storage growth), execution graph stages or substep variables, identifying root causes, and determining remediat
- use for writing or optimizing SQL, proactive capacity planning, or storage layout design (use bigquery-optimization), or when the user already knows which telemetry they want and just needs the query (use bigquery-observability).

## Add this skill

### Claude Code

```sh
/plugin marketplace add google/skills
/plugin   # browse google-plugins and install the plugin that contains bigquery-troubleshooting
```

In the Claude apps, zip the skill folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

### ChatGPT / Codex

```sh
git clone --depth 1 https://github.com/google/skills.git
cp -r skills/skills/cloud/bigquery-troubleshooting .agents/skills/bigquery-troubleshooting   # repo; ~/.agents/skills for all projects
```

### Cursor

```sh
git clone --depth 1 https://github.com/google/skills.git
cp -r skills/skills/cloud/bigquery-troubleshooting .cursor/skills/bigquery-troubleshooting   # project; ~/.cursor/skills for all projects
```

Sources (checked 2026-10-07): https://code.claude.com/docs/en/skills, https://support.claude.com/en/articles/12512180-using-skills-in-claude, https://learn.chatgpt.com/docs/build-skills, https://cursor.com/docs/context/skills

---

Canonical page: https://appsgit.com/skills/google-bigquery-troubleshooting
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.