Skip to content
Skill

Gke workload identity

Configures and diagnoses Workload Identity Federation for GKE authentication failures for Pods (403 "iam.serviceAccounts.getAccessToken" / p

Install
Scripts
None
Platforms
Claude Code, Codex, Cursor
GitHub stars
24.4K
Last commit
today
License
Apache-2.0
Listing updated
today

When your agent uses it

Configures and diagnoses Workload Identity Federation for GKE authentication failures for Pods (403 "iam.serviceAccounts.getAccessToken" / permission denied, "could not find default credentials", or GKE metadata server unreachable) by verifying cluster and node-pool Workload Identity configuration, the Kubernetes ServiceAccount (KSA) to IAM binding (direct principal binding and legacy Google ServiceAccount impersonation), target-resource IAM roles, and gke-metadata-server health. Use when setting up KSA/GSA bindings (`roles/iam.workloadIdentityUser`, `iam.gke.io/gcp-service-account`) or when a Pod cannot authenticate to Google Cloud APIs. Don't use for in-cluster Kubernetes RBAC errors (API-server authorization), general workload crashes (use gke-workload-troubleshooting), or Pod Security Standards and NetworkPolicies (use gke-workload-security).

From the skill's SKILL.md. Your agent reads this description to decide when to load the skill.

What it can access

From a static check of its 2 files (20 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.

Install

Copy the skill folder to ~/.claude/skills/gke-workload-identity to use it in all your projects:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/gke-workload-identity &&
cp -R "$tmp/skills/cloud/gke-workload-identity" ~/.claude/skills/gke-workload-identity &&
rm -rf "$tmp"

For one project only, put the folder in .claude/skills/gke-workload-identity inside it instead.

Claude Code docs on skills

Copy the skill folder to ~/.agents/skills/gke-workload-identity to use it in every repository:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/gke-workload-identity &&
cp -R "$tmp/skills/cloud/gke-workload-identity" ~/.agents/skills/gke-workload-identity &&
rm -rf "$tmp"

For one repository only, put the folder in .agents/skills/gke-workload-identity inside it instead.

Codex docs on skills

Copy the skill folder to ~/.cursor/skills/gke-workload-identity to use it in every project:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/gke-workload-identity &&
cp -R "$tmp/skills/cloud/gke-workload-identity" ~/.cursor/skills/gke-workload-identity &&
rm -rf "$tmp"

For one project only, put the folder in .cursor/skills/gke-workload-identity inside it instead.

Cursor docs on skills

Run in a terminal (add --scope workspace to install it for the current workspace only):

gemini skills install https://github.com/google/skills.git --path skills/cloud/gke-workload-identity

Or copy the folder to ~/.gemini/skills/gke-workload-identity yourself.

Gemini CLI docs on skills

For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/gke-workload-identity:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/gke-workload-identity &&
cp -R "$tmp/skills/cloud/gke-workload-identity" ~/.copilot/skills/gke-workload-identity &&
rm -rf "$tmp"

For one project only, put the folder in .github/skills/gke-workload-identity inside it instead.

VS Code docs on skills

Get the folder:

git clone --depth 1 https://github.com/google/skills.git

Then copy skills/skills/cloud/gke-workload-identity into your agent's skills folder as gke-workload-identity. Agents that support SKILL.md read one folder per skill.

The SKILL.md format

Gke workload identity FAQ

How do I install Gke workload identity in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/gke-workload-identity to use it in all your projects, or to .claude/skills/gke-workload-identity in one project.

Does Gke workload identity run scripts?

No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

Which AI agents can use Gke workload identity?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

What are the best alternatives to Gke workload identity?

The closest alternatives to Gke workload identity are Gem devops guidelines, Azure logic apps standard CLI, Azure container registry CLI, Azure devops CLI and Terraform azurerm set diff analyzer.

More from google/skills

  1. Google platform decision and setup guidance, loaded on demand from Google's skill catalog

    • Open source
    • 24.4K GitHub stars
  2. Provides safety-critical validation, guardrails, and data reduction for gcloud CLI operations across Google Cloud Platform (GCP) services an

    • Open source
    • 24.4K GitHub stars
    • Cloud and infrastructure
  3. Provides expert guidance on Identity and Access Management (IAM) and authenticating and authorizing to Google Cloud services and APIs, cover

    • Open source
    • 24.4K GitHub stars
    • Cloud and infrastructure
  4. Guides a developer's first steps on Google Cloud, covering account creation, billing setup, project management, and deploying a first resour

    • Open source
    • 24.4K GitHub stars
    • Cloud and infrastructure
  5. Searches, retrieves, and synthesizes official Google developer documentation across Google Cloud, AI/Gemini, Android, Chrome, Web, Flutter,

    • Open source
    • 24.4K GitHub stars
  6. Guides developers through managing (adding, removing, and clearing) audience members for Google products using the Data Manager API and its

    • Open source
    • 24.4K GitHub stars

Alternatives to Gke workload identity

  1. Design or review infrastructure, deployment, CI/CD, Docker, Kubernetes, health checks, rollback, feature flags, production readiness, and mo

    • Open source
    • 41.3K GitHub stars
    • Cloud and infrastructure
  2. Create, inspect, validate, test, run, debug, package, and deploy Azure Logic Apps Standard projects using the Azure CLI logicapp extension

    • Open source
    • 41.3K GitHub stars
    • Cloud and infrastructure
  3. Manage Azure Container Registry via the az acr CLI including registries, images, cloud builds, ACR Tasks, authentication, tokens, geo-replic

    • Open source
    • 41.3K GitHub stars
    • Cloud and infrastructure
  4. Manage Azure DevOps resources via CLI including projects, repos, pipelines, builds, pull requests, work items, artifacts, and service endpoi

    • Open source
    • 41.3K GitHub stars
    • Cloud and infrastructure
  5. Analyze Terraform plan JSON output for AzureRM Provider to distinguish between false-positive diffs (order-only changes in Set-type attribut

    • Open source
    • 41.3K GitHub stars
    • Cloud and infrastructure
  6. Performs comprehensive preflight validation of Bicep deployments to Azure, including template syntax validation, what-if analysis, and permi

    • Open source
    • 41.3K GitHub stars
    • Cloud and infrastructure