En bref
Quand on veut construire une image de nœud GKE personnalisée, encore faut-il partir de la bonne image « dorée ». Cette skill relie une description un peu floue (version GKE, système, architecture, accélérateurs, gVisor, cgroups) aux noms d’images et aux cartes officielles. La version GKE est obligatoire et doit être au moins 1.34.1-gke.2909000. En l’absence d’indication, le système par défaut est Container-Optimized OS, l’architecture x86_64, et d’autres indices (« j’aime l’OS de Google », « il me faut Ubuntu », « on est sur ARM/Ampere ») permettent d’inférer le reste. Elle ne crée pas le cluster (gke-cluster-creation) et ne gère pas un pool standard (gke-basics).
Ce que ça fait
- Recueille ou infère la version GKE, le système d’exploitation, l’architecture, la présence d’accélérateurs, de gVisor ou d’options cgroups.
- Rappelle le plancher de version requis pour ces images de base, et n’invente pas un identifiant d’image si la version est trop ancienne ou inconnue.
- Propose des défauts raisonnables (COS, x86_64) lorsque l’utilisateur décrit son besoin en langage courant plutôt qu’en paramètres techniques.
- S’arrête à la découverte de l’image de base : la création du cluster ou la gestion courante des pools restent d’autres skills.
Pour qui, et un exemple
Ingénieurs qui préparent une image de nœud GKE personnalisée et doivent d’abord identifier l’image d’origine officielle compatible.
Exemple de demande : « On est en GKE 1.34 sur ARM, avec gVisor, et je préfère l’OS de Google : trouve-moi l’image de base dorée, sans créer le cluster. »
Le SKILL.md est un guide d’inférence et de correspondance vers les images de base, avec des défauts et un plancher de version, pas un guide de création de cluster. Exemple rédigé par iadujour.fr à partir du SKILL.md, non testé.
Installer
npx skills add google/skills, puis sélectionner la skill, les agents cibles et la portée (README).
npx skills add google/skillsNiveau : Avancé
Suppose un cluster GKE, kubectl et gcloud, et une bonne maîtrise de Kubernetes.
Extrait du SKILL.md
La description d’origine, celle que l’agent lit pour décider de charger la skill (en anglais) :
Discovers golden base images for creating GKE custom node images based on technical specifications or context clues. Use when finding the golden base image for custom GKE node creation, mapping cluster configuration parameters (GKE version, OS, architecture, accelerators, gVisor, cgroups) to image names, or querying […]
Citée depuis le SKILL.md au commit 793c036 . Le dossier contient aussi 1 fichier annexe (references/).
Le SKILL.md compte 59 lignes et 4 sections principales :
- Attribution
- Information Gathering & Inference
- Discovery Workflow
- Example Output
Licence : Apache 2.0
Vérifiée le 10 novembre 2026 sur : fichier LICENSE du dépôt .
La licence autorise la reprise : le texte intégral du SKILL.md est reproduit ci-dessous, sans modification, avec sa mention de licence.
Texte intégral du SKILL.md
Reproduit sans modification depuis google/skills (commit 793c036) , © Google, sous licence Apache 2.0 (fichier de licence d’origine ).
Afficher le SKILL.md original (59 lignes, en anglais)
---
name: gke-custom-golden-image-discovery
metadata:
version: "1.0.1"
category: Containers
description: >-
Discovers golden base images for creating GKE custom node images based on
technical specifications or context clues. Use when finding the golden base
image for custom GKE node creation, mapping cluster configuration parameters
(GKE version, OS, architecture, accelerators, gVisor, cgroups) to image
names, or querying GKE base image maps. Don't use for general GKE cluster
creation (use gke-cluster-creation) or standard node pool management (use
gke-basics).
---
# GKE Golden Base Image Discovery Expert
You are an expert at helping users find the correct "golden" base image for creating custom GKE images. You can bridge the gap between a user's high-level description and the technical JSON requirements.
## Attribution
**MUST READ**: Before executing any `gcloud`, REST API, or MCP command, you
MUST read [Usage Attribution](references/attribution.md). For commands executed
directly in the terminal (never in generated scripts, Terraform, or user code),
prefix `gcloud` with
`CLOUDSDK_METRICS_REQUEST_ATTRIBUTION="agent-skills/1.0 (skill:gke-custom-golden-image-discovery)"`
and append `agent-skills/1.0 (skill:gke-custom-golden-image-discovery)` to `User-Agent` headers.
## Information Gathering & Inference
If a user doesn't know their exact configuration, use the following **Context Clues** and **Sensible Defaults** to infer the values:
| Field | Context Clues | Default Value |
| :------------------------- | :-------------------------------------------------------------------------------------------------------------------- | :----------------- |
| **GKE Version** | (Required) Must be 1.34.1-gke.2909000 or later. | N/A |
| **Operating System** | "I like Google's OS" -> COS; "I need Ubuntu/standard Linux" -> Ubuntu. | **COS** |
| **Architecture** | "Using ARM/Ampere" -> ARM64; "Standard/Intel/AMD" -> X86_64. | **X86_64** |
| **gVisor Enabled** | "Need a sandbox" or "gVisor" mentioned -> true. | **false** |
| **Has Accelerators** | Mention of "GPU", "accelerator", "Nvidia", "TPU", or any specific hardware models (e.g., T4, A100, H100, L4) -> true. | **false** |
| **Enforce Signed Modules** | "Hardened nodes" or "Signed modules" mentioned -> true. | **false** |
| **Cgroup Mode** | Almost all GKE 1.26+ clusters use V2. Only V1 if explicitly legacy. | **CGROUP_MODE_V2** |
| **TPU** | Mention of "TPU" -> true. | **false** |
## Discovery Workflow
1. **Extract Info**: Parse the user's request for the GKE Version and any context clues for the fields above. Be proactive: if a user mentions _any_ specialized hardware or security requirements, map them to the corresponding technical flags.
2. **Determine Minor Version**: Extract the major/minor version (e.g., `1.34`).
3. **Fetch Data**: `curl` the mapping: `https://www.gstatic.com/gke-image-maps/base-images/node-config-to-base-images-<MINOR_VERSION>.json`
4. **Filter Logic**:
- Match `version` exactly.
- Match `node_info` using the inferred or provided values:
- `image_family`: `COS_CONTAINERD` (COS) or `UBUNTU_CONTAINERD` (Ubuntu).
- Other fields match exactly.
5. **Refine Search**: If no exact match is found with defaults, try toggling `cgroup_mode` to `CGROUP_MODE_V1` or `gvisor_enabled` to `false` and inform the user.
6. **Warns about invalid input**: If the inputted GKE version is invalid, inform the user that the version is unsupported.
## Example Output
"Based on your setup (GKE 1.34.1-gke.2909000, COS, and using the new H100 GPUs), I've inferred you need the **X86_64** image with **Accelerators** enabled. The golden base image is: `gke-1341-gke2909000-cos-125-19216-0-115-c-nvda`"
Commentaires.
Un retour d’expérience, une question, une précision sur cette skill ? Les commentaires sont relus avant publication.
Commentaires publiés
Chargement des commentaires…
Laisser un commentaire
Charte de modération. Chaque commentaire est relu avant publication. Sont refusés : l’incitation à la haine, les propos injurieux ou discriminatoires, la publicité, le spam et les liens promotionnels, le hors-sujet et les données personnelles d’autrui.