safe-sre-investigator — скилл для Claude Code: read-only GCP и K8s
Скилл safe-sre-investigator заводит отдельные read-only сервисные аккаунты для GCP и Kubernetes и подсказывает команды gcloud/kubectl вместе с оценкой риска.
Apache-2.0 ★ 151 обновлён 2026-10-12
/plugin marketplace add gemini-cli-extensions/sre
/plugin install sre-extension@sreЧто делает safe-sre-investigator
Скилл готовит доступ, при котором агент смотрит ресурсы GCP и кластера Kubernetes, не держа на руках прав на запись. На выходе две обёртки: safe_gcloud и safe_kubectl. Любую предложенную команду он сопровождает блоком оценки риска.
Для GCP один раз на проект запускается bash ./scripts/setup_safe_sre_investigator.sh PROJECT_ID. Скрипт идемпотентный, кладёт ~/bin/safe_gcloud, после чего оболочку может понадобиться перечитать. Kubernetes настраивается отдельно: bash ./scripts/setup_safe_kubectl.sh CLUSTER_NAME CLUSTER_LOCATION выполняется для каждого кластера, создаёт в нём read-only ServiceAccount и отдельный kubeconfig в ~/.kube/safe-investigator-configs/.
Второму скрипту нужны права на создание ServiceAccount и ClusterRoleBinding в целевом кластере, у обычной read-only учётки он остановится на этом шаге. Для операций записи скилл отдаёт обычную команду gcloud или kubectl и предупреждает, что запускать её надо под своими учётными данными. Роли, которые он выдаёт, лежат в references/iam_roles.md и references/k8s_readonly_role.yaml.
Какие задачи решает
- выдать агенту доступ к GCP-проекту только на чтение
- посмотреть состояние GKE-кластера, не трогая прод
- вывести поды в namespace через отдельный kubeconfig
- получить оценку риска до запуска команды
- развести доступ по нескольким кластерам по отдельности
Примеры запросов агенту
- Настрой
safe_gcloudдля проектаmy-project - Покажи поды в
defaultкомандойsafe_kubectl my-cluster - Дай команду gcloud для списка кластеров GKE и оценку риска к ней
Как установить safe-sre-investigator
1Через маркетплейс плагинов
/plugin marketplace add gemini-cli-extensions/sre/plugin install sre-extension@sreКоманда ставит плагин sre-extension целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add gemini-cli-extensions/sre --skill safe-sre-investigator -a claude-code3Вручную: положить файлы
~/.claude/skills/safe-sre-investigator/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/safe-sre-investigator/
1Через Skills CLI (Vercel)
npx skills add gemini-cli-extensions/sre --skill safe-sre-investigator -a codex2Вручную: положить файлы
.agents/skills/safe-sre-investigator/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add gemini-cli-extensions/sre --skill safe-sre-investigator -a cursor2Вручную: положить файлы
.cursor/skills/safe-sre-investigator/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install gemini-cli-extensions/sre skills/safe-sre-investigator2Вручную: положить файлы
.github/skills/safe-sre-investigator/SKILL.md1Через Skills CLI (Vercel)
npx skills add gemini-cli-extensions/sre --skill safe-sre-investigator -a gemini-cli2Командой платформы
gemini skills install https://github.com/gemini-cli-extensions/sre --path skills/safe-sre-investigatorВручную: положить файлы
.devin/skills/safe-sre-investigator/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о safe-sre-investigator
Как установить safe-sre-investigator в Claude Code?
Подключите маркетплейс: /plugin marketplace add gemini-cli-extensions/sre, затем поставьте плагин: /plugin install sre-extension@sre.
Что делает safe-sre-investigator?
Создаёт read-only сервисные аккаунты для GCP и Kubernetes, оборачивает вызовы в safe_gcloud и safe_kubectl и добавляет к предлагаемым командам оценку риска.
Kubernetes нужно настраивать заново для каждого кластера?
Да. bash ./scripts/setup_safe_kubectl.sh CLUSTER_NAME CLUSTER_LOCATION запускается отдельно по каждому кластеру: ServiceAccount и kubeconfig создаются именно в нём.
Исходный текст
SKILL.md · Apache-2.0
---
name: safe-sre-investigator
description: 🐉 Sets up and uses read-only Service Accounts for GCP and Kubernetes investigations using the principle of least privilege, and provides risk assessments for suggested commands. Use when asked to investigate GCP/GKE resources or suggest gcloud/kubectl commands.
metadata:
author: Riccardo Carlesso
version: 1.0.8
status: draft
# See CHANGELOG.md for version history
---
# Safe SRE Investigator
This skill helps set up and use dedicated read-only Service Accounts for investigating GCP and Kubernetes resources.
It provides wrapper scripts `safe_gcloud` and `safe_kubectl` to ensure commands are run with these limited-privilege accounts.
When suggesting commands, it includes a risk assessment.
## Core Tasks
1. **Setup GCP:** Initialize the GCP service account and `safe_gcloud` script.
2. **Setup Kubernetes:** Initialize the Kubernetes service account and `safe_kubectl` script for a specific cluster.
3. **Suggest Commands:** Provide `gcloud` or `kubectl` commands with risk assessments.
## 1. Setup GCP (`safe_gcloud`)
When first using this skill for a project, or if the user asks for setup, guide them through the one-time setup process for GCP access.
**Action:** Ask the user for the Project ID.
**Script:** Run the setup script:
```bash
bash ./scripts/setup_safe_sre_investigator.sh PROJECT_ID
```
* This script is idempotent.
* It creates `~/bin/safe_gcloud`.
* The user might need to re-source their shell profile.
* IAM roles are in `references/iam_roles.md`.
## 2. Setup Kubernetes (`safe_kubectl`)
This setup must be run for EACH Kubernetes cluster you want to investigate.
**Action:** Ask the user for the Cluster Name and Cluster Location (Zone or Region).
**Script:** Run the setup script:
```bash
bash ./scripts/setup_safe_kubectl.sh CLUSTER_NAME CLUSTER_LOCATION
```
* This script needs to be run with user credentials that have permissions to create ServiceAccounts and ClusterRoleBindings in the target cluster.
* It creates a read-only ServiceAccount in the cluster and generates a dedicated kubeconfig in `~/.kube/safe-investigator-configs/`.
* It also creates `~/bin/safe_kubectl`.
* The K8s roles are in `references/k8s_readonly_role.yaml`.
## 3. Suggesting Commands
When the user asks for a command:
* **GCP:** Use `safe_gcloud PROJECT_ID <gcloud commands>`.
* **Kubernetes:** Use `safe_kubectl CLUSTER_NAME -- <kubectl commands>`.
* **Risk Assessment:** ALWAYS include a risk assessment block. See `references/risk_assessment.md`.
* **Write Operations:** For commands requiring write access, provide the standard `gcloud` or `kubectl` command and warn the user to run it with their own credentials, noting the risks.
**Example `safe_gcloud`:**
```bash
# 🎬 Check GKE cluster status
# ⚠️ Risk: ⚪ NONE: This is a read-only operation.
safe_gcloud my-project container clusters list
```
**Example `safe_kubectl`:**
```bash
# 🎬 List pods in the default namespace
# ⚠️ Risk: ⚪ NONE: This is a read-only operation.
safe_kubectl my-cluster -- get pods -n default
```
## Bundled Resources
* `scripts/setup_safe_sre_investigator.sh`: GCP setup.
* `scripts/safe_gcloud_wrapper.sh`: Template for `~/bin/safe_gcloud`.
* `scripts/setup_safe_kubectl.sh`: Kubernetes setup.
* `scripts/safe_kubectl_wrapper.sh`: Template for `~/bin/safe_kubectl`.
* `references/iam_roles.md`: GCP IAM roles.
* `references/k8s_readonly_role.yaml`: Kubernetes ClusterRole definition.
* `references/risk_assessment.md`: Risk assessment format.
© Riccardo Carlesso · Apache-2.0 · gemini-cli-extensions/sre