borghei/gcp-cloud-architect
> Design, review, and validate Google Cloud (GCP) architectures. Use when choosing GCP compute, storage, networking, or identity services, or applying the Google Cloud Architecture Framework (reliability, security, cost, performance).
npx skills add https://github.com/borghei/Claude-Skills --skill gcp-cloud-architect
End-to-end GCP-specific architecture: service selection, Google Cloud Architecture Framework assessment, identity and networking patterns, cost optimization, operational defaults. Provider-specific complement to our generic senior-cloud-architect skill — that one covers cross-cloud patterns; this one knows when to pick Spanner over Cloud SQL, how Workload Identity Federation differs from Service Account keys, and the right Cloud Run vs GKE call.
| Situation | Skill applies |
|-----------|---------------|
| Designing a GCP architecture from scratch | Yes — start with compute decision tree |
| Reviewing an existing GCP architecture | Yes — run CAF assessment via scripts/gcp_caf_scorer.py |
| Validating a Terraform / Deployment Manager plan | Yes — scripts/gcp_architecture_validator.py |
| Estimating GCP cost for a workload | Yes — scripts/gcp_cost_estimator.py |
| Picking between GKE / Cloud Run / Functions / Cloud Run Jobs | Yes — see compute decision tree |
| Setting up IAM / Workload Identity correctly | Yes — see identity reference |
| Designing multi-region / multi-zone resilience | Yes — see reliability reference |
| Picking Cloud SQL vs Spanner vs Firestore vs BigQuery | Yes — see data store decision tree |
| Going to production without CAF review | Don't — run the CAF scorer first |
Before designing or assessing, confirm these inputs. If any is unknown or vague, ASK — do not assume:
gcp_architecture_validator.py vs gcp_cost_estimator.py vs gcp_caf_scorer.py)Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
| Tool | Purpose | Command |
|------|---------|---------|
| gcp_architecture_validator.py | Validate a Terraform plan or YAML workload spec for anti-patterns | python scripts/gcp_architecture_validator.py --terraform ./infra/*.tf |
| gcp_cost_estimator.py | Estimate monthly GCP cost from a workload spec, with optimization opportunities | python scripts/gcp_cost_estimator.py --workload-config workload.yaml |
| gcp_caf_scorer.py | Score a workload against the five Cloud Architecture Framework pillars | python scripts/gcp_caf_scorer.py --workload-config workload.yaml |
Load the reference that matches the task — keep this file lean and pull detail on demand:
engineering/senior-cloud-architect — generic multi-cloud architecture patternsengineering/aws-solution-architect — AWS counterpartengineering/azure-cloud-architect — Azure counterpartengineering/kubernetes-operator — for GKE operator-pattern workloadsra-qm-team/information-security-manager-iso27001 — compliance-mapped controls (GCP has Security Command Center)ra-qm-team/soc2-compliance-expert — GCP-specific SOC 2 evidence collectionTake borghei/gcp-cloud-architect from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.