How do I install the GCP Cloudbuild skill?

Run npx skillmds@latest add thomashartm/gcp-cloudbuild in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is GCP Cloudbuild safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with GCP Cloudbuild?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is GCP Cloudbuild free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published GCP Cloudbuild?

thomashartm (@thomashartm) published this skill. Their other Agent Skills are listed on their SkillMD profile.

GCP Cloudbuild by thomashartm — Agent Skill

Name: GCP Cloudbuild
Author: thomashartm

GCP Cloudbuild

Manage Google Cloud Build jobs and triggers. Use when the user wants to list Cloud Build triggers/jobs, view trigger details and configurations, check build history, monitor running builds, or start new builds. Handles authentication verification and project context. Triggers on phrases like "list cloud build jobs", "show build triggers", "build history", "running builds", "start build", "deploy with cloud build", "cloudbuild status".

thomashartm 0a0f9a8 2 files · 26.2 KB Updated Sep 17, 2026

File contents

GCP Cloud Build Management

Manage Cloud Build triggers, view build history, monitor running builds, and start new builds.

Prerequisites

Requires authenticated gcloud CLI and jq. Use the unified gcp-build-tool script for all operations.

Quick Reference

gcp-build-tool auth                    # Verify auth & show project
gcp-build-tool list                    # List all triggers
gcp-build-tool details <trigger>       # Show trigger configuration
gcp-build-tool history [trigger]       # Show build history
gcp-build-tool running                 # Show active builds
gcp-build-tool start <trigger> [opts]  # Start a build

Workflow

1. Always Verify Authentication First

gcp-build-tool auth

If authentication fails, tell user to run:

gcloud auth login
gcloud config set project PROJECT_ID

If targeting a different project: User must authenticate to that project first. Tell user the command above.

2. Operations

List triggers:

gcp-build-tool list

View trigger details (name or ID):

gcp-build-tool details my-deploy-trigger

View build history:

gcp-build-tool history                     # All builds
gcp-build-tool history my-deploy-trigger   # Filter by trigger

Check running builds:

gcp-build-tool running

Start a build:

gcp-build-tool start my-trigger
gcp-build-tool start my-trigger --branch main
gcp-build-tool start my-trigger --sub _ENV=prod --sub _VERSION=1.2.3
gcp-build-tool start my-trigger --dry-run  # Preview only

Error Handling

Error	User Action
Not authenticated	`gcloud auth login`
No project set	`gcloud config set project PROJECT_ID`
API not enabled	`gcloud services enable cloudbuild.googleapis.com`
Permission denied	Need `cloudbuild.builds.viewer` or `cloudbuild.builds.editor` role

Build Statuses

---name: gcp-cloudbuilddescription: Manage Google Cloud Build jobs and triggers. Use when the user wants to list Cloud Build triggers/jobs, view trigger details and configurations, check build history, monitor running builds, or start new builds. Handles authentication verification and project context. Triggers on phrases like "list cloud build jobs", "show build triggers", "build history", "running builds", "start build", "deploy with cloud build", "cloudbuild status".---# GCP Cloud Build ManagementManage Cloud Build triggers, view build history, monitor running builds, and start new builds.## PrerequisitesRequires authenticated `gcloud` CLI and `jq`. Use the unified `gcp-build-tool` script for all operations.## Quick Reference```bashgcp-build-tool auth # Verify auth & show projectgcp-build-tool list # List all triggersgcp-build-tool details <trigger> # Show trigger configurationgcp-build-tool history [trigger] # Show build historygcp-build-tool running # Show active buildsgcp-build-tool start <trigger> [opts] # Start a build```## Workflow### 1. Always Verify Authentication First```bashgcp-build-tool auth```**If authentication fails**, tell user to run:```bashgcloud auth logingcloud config set project PROJECT_ID```**If targeting a different project**: User must authenticate to that project first. Tell user the command above.### 2. Operations**List triggers:**```bashgcp-build-tool list```**View trigger details** (name or ID):```bashgcp-build-tool details my-deploy-trigger```**View build history:**```bashgcp-build-tool history # All buildsgcp-build-tool history my-deploy-trigger # Filter by trigger```**Check running builds:**```bashgcp-build-tool running```**Start a build:**```bashgcp-build-tool start my-triggergcp-build-tool start my-trigger --branch maingcp-build-tool start my-trigger --sub _ENV=prod --sub _VERSION=1.2.3gcp-build-tool start my-trigger --dry-run # Preview only```## Error Handling| Error | User Action ||-------|-------------|| Not authenticated | `gcloud auth login` || No project set | `gcloud config set project PROJECT_ID` || API not enabled | `gcloud services enable cloudbuild.googleapis.com` || Permission denied | Need `cloudbuild.builds.viewer` or `cloudbuild.builds.editor` role |## Build Statuses`SUCCESS` ✅ | `FAILURE` ❌ | `WORKING` 🔄 | `QUEUED` ⏳ | `TIMEOUT` ⏱️ | `CANCELLED` 🚫

Frequently asked questions