v1.4.0: Major Skills Expansion - 75 Total Skills

skills/claude-codex-settings/plugins/gcloud-tools/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "gcloud-tools",
+  "version": "2.0.2",
+  "description": "Google Cloud Observability MCP for logs, metrics, and traces with best practices skill.",
+  "author": {
+    "name": "Fatih Akyon"
+  },
+  "homepage": "https://github.com/fcakyon/claude-codex-settings#plugins",
+  "repository": "https://github.com/fcakyon/claude-codex-settings",
+  "license": "Apache-2.0"
+}

skills/claude-codex-settings/plugins/gcloud-tools/.mcp.json

@@ -0,0 +1,6 @@
+{
+  "gcloud-observability": {
+    "command": "npx",
+    "args": ["-y", "@google-cloud/observability-mcp"]
+  }
+}

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.
+```

skills/claude-codex-settings/plugins/gcloud-tools/skills/gcloud-usage/SKILL.md

@@ -0,0 +1,148 @@
+---
+name: gcloud-usage
+description: This skill should be used when user asks about "GCloud logs", "Cloud Logging queries", "Google Cloud metrics", "GCP observability", "trace analysis", or "debugging production issues on GCP".
+---
+
+# GCP Observability Best Practices
+
+## Structured Logging
+
+### JSON Log Format
+
+Use structured JSON logging for better queryability:
+
+```json
+{
+  "severity": "ERROR",
+  "message": "Payment failed",
+  "httpRequest": { "requestMethod": "POST", "requestUrl": "/api/payment" },
+  "labels": { "user_id": "123", "transaction_id": "abc" },
+  "timestamp": "2025-01-15T10:30:00Z"
+}
+```
+
+### Severity Levels
+
+Use appropriate severity for filtering:
+
+- **DEBUG:** Detailed diagnostic info
+- **INFO:** Normal operations, milestones
+- **NOTICE:** Normal but significant events
+- **WARNING:** Potential issues, degraded performance
+- **ERROR:** Failures that don't stop the service
+- **CRITICAL:** Failures requiring immediate action
+- **ALERT:** Person must take action immediately
+- **EMERGENCY:** System is unusable
+
+## Log Filtering Queries
+
+### Common Filters
+
+```
+# By severity
+severity >= WARNING
+
+# By resource
+resource.type="cloud_run_revision"
+resource.labels.service_name="my-service"
+
+# By time
+timestamp >= "2025-01-15T00:00:00Z"
+
+# By text content
+textPayload =~ "error.*timeout"
+
+# By JSON field
+jsonPayload.user_id = "123"
+
+# Combined
+severity >= ERROR AND resource.labels.service_name="api"
+```
+
+### Advanced Queries
+
+```
+# Regex matching
+textPayload =~ "status=[45][0-9]{2}"
+
+# Substring search
+textPayload : "connection refused"
+
+# Multiple values
+severity = (ERROR OR CRITICAL)
+```
+
+## Metrics vs Logs vs Traces
+
+### When to Use Each
+
+**Metrics:** Aggregated numeric data over time
+
+- Request counts, latency percentiles
+- Resource utilization (CPU, memory)
+- Business KPIs (orders/minute)
+
+**Logs:** Detailed event records
+
+- Error details and stack traces
+- Audit trails
+- Debugging specific requests
+
+**Traces:** Request flow across services
+
+- Latency breakdown by service
+- Identifying bottlenecks
+- Distributed system debugging
+
+## Alert Policy Design
+
+### Alert Best Practices
+
+- **Avoid alert fatigue:** Only alert on actionable issues
+- **Use multi-condition alerts:** Reduce noise from transient spikes
+- **Set appropriate windows:** 5-15 min for most metrics
+- **Include runbook links:** Help responders act quickly
+
+### Common Alert Patterns
+
+**Error rate:**
+
+- Condition: Error rate > 1% for 5 minutes
+- Good for: Service health monitoring
+
+**Latency:**
+
+- Condition: P99 latency > 2s for 10 minutes
+- Good for: Performance degradation detection
+
+**Resource exhaustion:**
+
+- Condition: Memory > 90% for 5 minutes
+- Good for: Capacity planning triggers
+
+## Cost Optimization
+
+### Reducing Log Costs
+
+- **Exclusion filters:** Drop verbose logs at ingestion
+- **Sampling:** Log only percentage of high-volume events
+- **Shorter retention:** Reduce default 30-day retention
+- **Downgrade logs:** Route to cheaper storage buckets
+
+### Exclusion Filter Examples
+
+```
+# Exclude health checks
+resource.type="cloud_run_revision" AND httpRequest.requestUrl="/health"
+
+# Exclude debug logs in production
+severity = DEBUG
+```
+
+## Debugging Workflow
+
+1. **Start with metrics:** Identify when issues started
+2. **Correlate with logs:** Filter logs around problem time
+3. **Use traces:** Follow specific requests across services
+4. **Check resource logs:** Look for infrastructure issues
+5. **Compare baselines:** Check against known-good periods

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

@@ -0,0 +1,18 @@
+---
+name: setup
+description: This skill should be used when user encounters "ADC not found", "gcloud auth error", "GCloud MCP error", "Application Default Credentials", "project not set", or needs help configuring GCloud integration.
+---
+
+# GCloud Tools Setup
+
+Run `/gcloud-tools:setup` to configure GCloud MCP.
+
+## Quick Fixes
+
+- **ADC not found** - Run `gcloud auth application-default login`
+- **Project not set** - Run `gcloud config set project PROJECT_ID`
+- **Permission denied** - Check IAM roles in Cloud Console
+
+## Don't Need GCloud?
+
+Disable via `/mcp` command to prevent errors.