v1.4.0: Major Skills Expansion - 75 Total Skills

skills/claude-codex-settings/plugins/gcloud-tools/commands/setup.md

@@ -0,0 +1,104 @@
+---
+description: Configure GCloud CLI authentication
+---
+
+# GCloud Tools Setup
+
+**Source:** [googleapis/gcloud-mcp](https://github.com/googleapis/gcloud-mcp)
+
+Check GCloud MCP status and configure CLI authentication if needed.
+
+## Step 1: Check gcloud CLI
+
+Run: `gcloud --version`
+
+If not installed: Continue to Step 2.
+If installed: Skip to Step 3.
+
+## Step 2: Install gcloud CLI
+
+Tell the user:
+
+```
+Install Google Cloud SDK:
+
+macOS (Homebrew):
+  brew install google-cloud-sdk
+
+macOS/Linux (Manual):
+  curl https://sdk.cloud.google.com | bash
+  exec -l $SHELL
+
+Windows:
+  Download from: https://cloud.google.com/sdk/docs/install
+
+After install, restart your terminal.
+```
+
+## Step 3: Authenticate
+
+Run these commands:
+
+```bash
+# Login with your Google account
+gcloud auth login
+
+# Set up Application Default Credentials (required for MCP)
+gcloud auth application-default login
+```
+
+Both commands will open a browser for authentication.
+
+## Step 4: Set Default Project
+
+```bash
+# List available projects
+gcloud projects list
+
+# Set default project
+gcloud config set project YOUR_PROJECT_ID
+```
+
+## Step 5: Verify Setup
+
+Run: `gcloud auth list`
+
+Should show your authenticated account with asterisk (\*).
+
+## Step 6: Restart Claude Code
+
+Tell the user:
+
+```
+After authentication:
+1. Exit Claude Code
+2. Run `claude` again
+
+The MCP will use your gcloud credentials.
+```
+
+## Troubleshooting
+
+If GCloud MCP fails:
+
+```
+Common fixes:
+1. ADC not found - Run gcloud auth application-default login
+2. Project not set - Run gcloud config set project PROJECT_ID
+3. Permission denied - Check IAM roles in Cloud Console
+4. Quota exceeded - Check quotas in Cloud Console
+5. Token expired - Run gcloud auth application-default login again
+```
+
+## Alternative: Disable Plugin
+
+If user doesn't need GCloud integration:
+
+```
+To disable this plugin:
+1. Run /mcp command
+2. Find the gcloud-observability server
+3. Disable it
+
+This prevents errors from missing authentication.
+```