Gke AI Troubleshooting Tpu Vbar Oom
google/skills
Diagnoses and prevents vbarcontrolagent segfaults, out-of-memory (OOM) errors, and TPU device initialization failures on TPU v6e nodes in GKE caused by race conditions during TPU device resets or…
Explains the Race Condition architecture, the design decisions behind it, and where to read code first.
Install Exploring The Codebase
$ npx skills add GoogleCloudPlatform/race-condition --skill exploring-the-codebase -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install GoogleCloudPlatform/race-condition exploring-the-codebase --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/GoogleCloudPlatform/race-condition.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/exploring-the-codebase .claude/skills/exploring-the-codebase && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "exploring-the-codebase" agent skill from https://github.com/GoogleCloudPlatform/race-condition/tree/main/.claude/skills/exploring-the-codebase into .claude/skills/exploring-the-codebase/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "exploring-the-codebase", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/GoogleCloudPlatform/race-condition/tree/main/.claude/skills/exploring-the-codebaseType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add GoogleCloudPlatform/race-condition --skill exploring-the-codebase -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install GoogleCloudPlatform/race-condition exploring-the-codebase --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GoogleCloudPlatform/race-condition.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/exploring-the-codebase .agents/skills/exploring-the-codebase && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "exploring-the-codebase" agent skill from https://github.com/GoogleCloudPlatform/race-condition/tree/main/.claude/skills/exploring-the-codebase into .agents/skills/exploring-the-codebase/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "exploring-the-codebase", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add GoogleCloudPlatform/race-condition --skill exploring-the-codebase -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install GoogleCloudPlatform/race-condition exploring-the-codebase --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GoogleCloudPlatform/race-condition.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/exploring-the-codebase .cursor/skills/exploring-the-codebase && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "exploring-the-codebase" agent skill from https://github.com/GoogleCloudPlatform/race-condition/tree/main/.claude/skills/exploring-the-codebase into .cursor/skills/exploring-the-codebase/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "exploring-the-codebase", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/GoogleCloudPlatform/race-condition.git --path .claude/skills/exploring-the-codebase--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add GoogleCloudPlatform/race-condition --skill exploring-the-codebase -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install GoogleCloudPlatform/race-condition exploring-the-codebase --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GoogleCloudPlatform/race-condition.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/exploring-the-codebase .gemini/skills/exploring-the-codebase && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "exploring-the-codebase" agent skill from https://github.com/GoogleCloudPlatform/race-condition/tree/main/.claude/skills/exploring-the-codebase into .gemini/skills/exploring-the-codebase/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "exploring-the-codebase", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install GoogleCloudPlatform/race-condition exploring-the-codebaseInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add GoogleCloudPlatform/race-condition --skill exploring-the-codebase -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/GoogleCloudPlatform/race-condition.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/exploring-the-codebase .github/skills/exploring-the-codebase && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "exploring-the-codebase" agent skill from https://github.com/GoogleCloudPlatform/race-condition/tree/main/.claude/skills/exploring-the-codebase into .github/skills/exploring-the-codebase/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "exploring-the-codebase", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add GoogleCloudPlatform/race-condition --skill exploring-the-codebase -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install GoogleCloudPlatform/race-condition exploring-the-codebase --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GoogleCloudPlatform/race-condition.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/exploring-the-codebase .opencode/skills/exploring-the-codebase && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "exploring-the-codebase" agent skill from https://github.com/GoogleCloudPlatform/race-condition/tree/main/.claude/skills/exploring-the-codebase into .opencode/skills/exploring-the-codebase/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "exploring-the-codebase", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
exploring-the-codebase- GitHub stars
- 234
- Token cost
- ~2.6k tokens
- SKILL.md length
- 1,161 words
- Files
- 1
- Skills in repo
- 16
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Explains the Race Condition architecture, the design decisions behind it, and where to read code first.
- Works in 6 steps: Multiple agent variants instead of… → Cached vs live replay → Hub session routing with broadcast… → …
- The developer asks how something works
- SKILL.md covers Where to start (by intent), High-level topology, Patterns worth understanding and Pragmatic shortcuts to be…, plus 2 more sections
- Calls make; needs GOOGLE_MAPS_API_KEY
What it does
Exploring The Codebase is an agent skill from GoogleCloudPlatform/race-condition. Explains the Race Condition architecture, the design decisions behind it, and where to read code first. Use when the developer asks how something works, wants a tour, or wants to understand the system before changing it.
Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Async programming and Architecture decision records. It works with Google Cloud. The repository describes itself as: The open source multi-agent simulation from the Developer Keynote at Google Cloud Next '26. A deployable reference architecture for autonomous AI agents using Gemini and ADK.
When your agent uses it
- The developer asks how something works
- Wants to understand the system before changing it
Example prompts
- “Use the exploring-the-codebase skill to explain the Race Condition architecture, the design decisions behind it, and where to read code first”
- “/exploring-the-codebase”
Requirements
- Python 3
- Docker
- A credential in GOOGLE_MAPS_API_KEY
Workflow steps
6 steps, taken from the step headings in SKILL.md.
- Multiple agent variants instead of feature flags
- Cached vs live replay
- Hub session routing with broadcast batching
- Tick-based simulator as an ADK pipeline
- A2UI for backend-driven UI
- A2A for agent-to-agent communication
What it can do on your machine
Read from SKILL.md and the folder at commit 26efc1b. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
make
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
GOOGLE_MAPS_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Exploring The Codebase loads about 2.6k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 1,161 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,161 words (~2,599 tokens).
“This is a multi-agent marathon simulation built for the Google Cloud Next '26 Developer Keynote. It also doubles as a reference architecture, so the layout is meant to be readable on its own. Pick a question from "Where to start"…”
- name
- exploring-the-codebase
Files
Just SKILL.md in .claude/skills/exploring-the-codebase of GoogleCloudPlatform/race-condition.
Open the folder on GitHubat commit 26efc1b
Compare with similar skills
Exploring The Codebase next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Exploring The Codebase this skillGoogleCloudPlatform/race-condition | 234 | — | ~2.6k | Automated safety check: Pass | Custom licence | |
| Gke AI Troubleshooting Tpu Vbar Oomgoogle/skills | 21k | — | ~1.6k | Automated safety check: Pass | Apache-2.0 | |
| PR Design DocOpenHands/OpenHands | 90k | — | ~2.4k | Automated safety check: Pass | MIT | |
| Cto AdvisorIbrahim-3d/orchestrator-supaconductor | 380 | 4 repos | ~2.4k | Automated safety check: Pass | MIT | |
| Improve Codebase Architectureywwynm/EverythingDone | 144 | 15 repos | ~1.3k | Automated safety check: Pass | GPL-3.0 | |
| YugabyteDB ASH Instrumentationyugabyte/yugabyte-db | 11k | — | ~4.5k | Automated safety check: Pass | Custom licence |
Similar skills
- Official
PR Design Doc
OpenHands/OpenHands
For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…
Cto Advisor
Ibrahim-3d/orchestrator-supaconductor
Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.
Improve Codebase Architecture
ywwynm/EverythingDone
Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/.
YugabyteDB ASH Instrumentation
yugabyte/yugabyte-db
Procedure for adding or changing YugabyteDB Active Session History wait states in TServer and DocDB C++ code, including the macro to use for sync and async paths.
Mirage VFS Adapter Authoring
strukto-ai/mirage
Builds or extends a custom Mirage virtual filesystem adapter for an API, database, object store or app data, with a working mount configuration and filesystem tests.
More from GoogleCloudPlatform/race-condition
All 16 skills in this repoGis Spatial Engineering
GoogleCloudPlatform/race-condition
A skill your agent uses when the marathon plan needs a 26.2-mile physical route generated from road-network GeoJSON, or when the request mentions traffic impact, route variety via seed, finishing…
A2ui Rendering
GoogleCloudPlatform/race-condition
A skill your agent uses when an agent renders rich UI back to a client surface (cards, dashboards, forms, modals) using the A2UI v0.8.0 declarative protocol.
Contributing
GoogleCloudPlatform/race-condition
Guides the developer workflow for contributing to Race Condition.
Deploying
GoogleCloudPlatform/race-condition
Guides deployment of Race Condition to a GCP project. An agent skill from GoogleCloudPlatform/race-condition.
Getting Started
GoogleCloudPlatform/race-condition
Guides setup of the Race Condition project from clone to running simulation.
Preparing The Race
GoogleCloudPlatform/race-condition
A skill your agent uses when the simulator receives a validated plan from the planner and must initialize the race: parsing the plan, spawning runner agents, starting the telemetry collector, and…
Related
Works with
Categories
Questions about Exploring The Codebase
What does Exploring The Codebase do?
Explains the Race Condition architecture, the design decisions behind it, and where to read code first. Exploring The Codebase is an agent skill from GoogleCloudPlatform/race-condition. Explains the Race Condition architecture, the design decisions behind it, and where to read code first.
When should I use Exploring The Codebase?
Exploring The Codebase fits situations like: the developer asks how something works; wants to understand the system before changing it.
How do I install Exploring The Codebase in Claude Code?
Run `npx skills add GoogleCloudPlatform/race-condition --skill exploring-the-codebase -a claude-code`. Or copy the skill folder (.claude/skills/exploring-the-codebase in GoogleCloudPlatform/race-condition) into .claude/skills/exploring-the-codebase in your project. Claude Code loads it when a task matches its description.
How do I install Exploring The Codebase in Codex?
Run `npx skills add GoogleCloudPlatform/race-condition --skill exploring-the-codebase -a codex`. Or copy the skill folder (.claude/skills/exploring-the-codebase in GoogleCloudPlatform/race-condition) into .agents/skills/exploring-the-codebase in your project. Codex loads it when a task matches its description.
Can I use Exploring The Codebase in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add GoogleCloudPlatform/race-condition --skill exploring-the-codebase -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/exploring-the-codebase, .gemini/skills/exploring-the-codebase, .github/skills/exploring-the-codebase and .opencode/skills/exploring-the-codebase in your project.
What does Exploring The Codebase need to run?
Going by SKILL.md and its folder, Exploring The Codebase needs the command-line tools its instructions call (make) and credentials named GOOGLE_MAPS_API_KEY. Our summary lists: Python 3; Docker; A credential in GOOGLE_MAPS_API_KEY.
Does Exploring The Codebase access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Exploring The Codebase safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Exploring The Codebase use?
Exploring The Codebase has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Exploring The Codebase use?
About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Exploring The Codebase?
Skills that share tags, products or a category with Exploring The Codebase: Gke AI Troubleshooting Tpu Vbar Oom (google/skills, 21k stars), PR Design Doc (OpenHands/OpenHands, 90k stars), Cto Advisor (Ibrahim-3d/orchestrator-supaconductor, 380 stars) and Improve Codebase Architecture (ywwynm/EverythingDone, 144 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Exploring The Codebase?
GoogleCloudPlatform (a GitHub organization) maintains it in GoogleCloudPlatform/race-condition, which has 234 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 5, 2026.
Source: GoogleCloudPlatform/race-condition on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.