devstack 0.1.0

package/vendor/skills/skills/git-rebase/scripts/pre-rebase-backup.sh

@@ -0,0 +1,94 @@
+#!/bin/bash
+
+# pre-rebase-backup.sh
+# Creates a safe backup before starting a rebase
+# Usage: bash pre-rebase-backup.sh [branch-name]
+
+echo "🔐 Pre-Rebase Safety Backup"
+echo "======================================"
+echo ""
+
+# Get current branch
+CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
+
+if [ "$CURRENT_BRANCH" = "HEAD" ]; then
+    echo "❌ You're in detached HEAD state"
+    echo "Checkout a branch first: git checkout your-branch"
+    exit 1
+fi
+
+# Check if clean
+if [ -n "$(git status --porcelain)" ]; then
+    echo "⚠️  Warning: You have uncommitted changes"
+    echo "Commit or stash them first:"
+    echo "  git add . && git commit -m 'work in progress'"
+    echo "  or"
+    echo "  git stash"
+    exit 1
+fi
+
+echo "Current branch: $CURRENT_BRANCH"
+echo ""
+
+# Create timestamped backup
+TIMESTAMP=$(date +%Y%m%d_%H%M%S)
+BACKUP_BRANCH="backup-rebase-${CURRENT_BRANCH}-${TIMESTAMP}"
+
+echo "Creating backup branch..."
+git branch "$BACKUP_BRANCH"
+
+# Get current commit
+CURRENT_SHA=$(git rev-parse HEAD)
+
+echo ""
+echo "✅ Backup created successfully!"
+echo ""
+echo "📋 Backup Details:"
+echo "   Branch name: $BACKUP_BRANCH"
+echo "   Commit SHA: $CURRENT_SHA"
+echo ""
+
+# Save backup info to file for easy recovery
+BACKUP_INFO_FILE=".rebase-backup-info"
+cat > "$BACKUP_INFO_FILE" << EOF
+# Rebase Backup Information
+# Created: $(date)
+
+BACKUP_BRANCH=$BACKUP_BRANCH
+CURRENT_BRANCH=$CURRENT_BRANCH
+COMMIT_SHA=$CURRENT_SHA
+TIMESTAMP=$TIMESTAMP
+
+# To recover from this backup:
+# git reset --hard backup-rebase-${CURRENT_BRANCH}-${TIMESTAMP}
+EOF
+
+echo "💾 Backup info saved to: $BACKUP_INFO_FILE"
+echo ""
+
+# Show git reflog for additional recovery options
+echo "📚 Backup Recovery Instructions:"
+echo ""
+echo "If something goes wrong, you can recover using:"
+echo ""
+echo "  Option 1 (Recommended): Use the backup branch"
+echo "    git reset --hard $BACKUP_BRANCH"
+echo ""
+echo "  Option 2: Use git reflog"
+echo "    git reflog  # Find your commit SHA"
+echo "    git reset --hard <SHA>"
+echo ""
+
+# List all backup branches
+echo "🗂️  All Backup Branches:"
+git branch | grep "backup-rebase" | tail -5 | sed 's/^/  - /'
+echo ""
+
+echo "✅ You're ready to rebase safely!"
+echo ""
+echo "Next steps:"
+echo "  1. git fetch origin"
+echo "  2. git rebase origin/main"
+echo "  3. Resolve any conflicts"
+echo "  4. git rebase --continue"
+echo "  5. git push origin $CURRENT_BRANCH --force-with-lease"

package/vendor/skills/skills/git-rebase/scripts/validate-merge.sh

@@ -0,0 +1,106 @@
+#!/bin/bash
+
+# validate-merge.sh
+# Validates that merge/rebase is clean and ready for testing
+# Usage: bash validate-merge.sh
+
+set -e
+
+echo "🔍 Merge/Rebase Validation"
+echo "======================================"
+echo ""
+
+EXIT_CODE=0
+
+# 1. Check for remaining conflict markers
+echo "1️⃣  Checking for conflict markers..."
+if git grep -l '<<<<<<\|======\|>>>>>>' 2>/dev/null | wc -l | grep -q '^0$'; then
+    echo "   ✓ No conflict markers found"
+else
+    echo "   ❌ FOUND conflict markers:"
+    git grep -l '<<<<<<\|======\|>>>>>>' 2>/dev/null || true
+    echo ""
+    echo "   ⚠️  Please resolve these files before continuing"
+    EXIT_CODE=1
+fi
+echo ""
+
+# 2. Check for unresolved git conflicts
+echo "2️⃣  Checking git status..."
+if [ -z "$(git diff --name-only --diff-filter=U)" ]; then
+    echo "   ✓ No unresolved conflicts in git status"
+else
+    echo "   ❌ Git still shows unresolved conflicts:"
+    git diff --name-only --diff-filter=U | sed 's/^/   - /'
+    EXIT_CODE=1
+fi
+echo ""
+
+# 3. Check if working directory is clean
+echo "3️⃣  Checking working directory..."
+if git status --porcelain | grep -q '^ M\| ??'; then
+    echo "   ⚠️  Unstaged changes found:"
+    git status --short | sed 's/^/   /'
+    echo ""
+    echo "   Tip: Run 'git add .' to stage all changes"
+else
+    echo "   ✓ Working directory clean"
+fi
+echo ""
+
+# 4. Check for duplicate code (merged sections)
+echo "4️⃣  Checking for duplicate code patterns..."
+COMMON_DUPES=$(git diff HEAD | grep -c '^+.*{$' || echo 0)
+if [ "$COMMON_DUPES" -lt 10 ]; then
+    echo "   ✓ No obvious code duplication detected"
+else
+    echo "   ⚠️  Possible code duplication (many new code blocks):"
+    echo "   Manual review recommended"
+fi
+echo ""
+
+# 5. Check for common merge markers in comments
+echo "5️⃣  Checking for merge message artifacts..."
+if git diff HEAD | grep -i "merged\|conflict\|cherry-pick\|rebase"; then
+    echo "   ⚠️  Found merge-related comments in changes"
+    echo "   Review to ensure they're intentional"
+else
+    echo "   ✓ No merge artifacts in comments"
+fi
+echo ""
+
+# 6. Show changed files
+echo "6️⃣  Changed Files Summary:"
+CHANGED=$(git diff --name-only)
+CHANGED_COUNT=$(echo "$CHANGED" | grep -c . || echo 0)
+echo "   $CHANGED_COUNT files changed:"
+echo "$CHANGED" | sed 's/^/   - /'
+echo ""
+
+# 7. Show stats
+echo "7️⃣  Diff Statistics:"
+git diff --stat | sed 's/^/   /'
+echo ""
+
+# Final status
+echo "======================================"
+if [ $EXIT_CODE -eq 0 ]; then
+    echo "✅ Validation PASSED - Ready for testing!"
+    echo ""
+    echo "Next steps:"
+    echo "  1. Run tests: npm test"
+    echo "  2. Run linter: npm run lint"
+    echo "  3. Manual smoke test if needed"
+    echo "  4. Then: git rebase --continue"
+else
+    echo "❌ Validation FAILED - Fix issues before proceeding"
+    echo ""
+    echo "Issues found:"
+    echo "  - Conflict markers remain (resolve in files)"
+    echo "  - Git shows unresolved conflicts"
+    echo "  - Other validation errors above"
+    echo ""
+    echo "Fix and run: bash validate-merge.sh"
+fi
+
+exit $EXIT_CODE

package/vendor/skills/skills/google-ads/SKILL.md

@@ -0,0 +1,197 @@
+---
+name: google-ads
+description: "Query, audit, and optimize Google Ads campaigns. Supports two modes: (1) API mode for bulk operations with google-ads Python SDK, (2) Browser automation mode for users without API access - just attach a browser tab to ads.google.com. Use when asked to check ad performance, pause campaigns/keywords, find wasted spend, audit conversion tracking, or optimize Google Ads accounts."
+metadata:
+  {
+    "openclaw":
+      { "emoji": "📊", "requires": { "anyBins": ["python3"], "config": ["~/.google-ads.yaml"] } },
+  }
+---
+
+# Google Ads Skill
+
+Manage Google Ads accounts via API or browser automation.
+
+## Mode Selection
+
+**Check which mode to use:**
+
+1. **API Mode** - If user has `google-ads.yaml` configured or `GOOGLE_ADS_*` env vars
+2. **Browser Mode** - If user says "I don't have API access" or just wants quick checks
+
+```bash
+# Check for API config
+ls ~/.google-ads.yaml 2>/dev/null || ls google-ads.yaml 2>/dev/null
+```
+
+If no config found, ask: "Do you have Google Ads API credentials, or should I use browser automation?"
+
+---
+
+## Browser Automation Mode (Universal)
+
+**Requirements:** User logged into ads.google.com in browser
+
+### Setup
+
+1. User opens ads.google.com and logs in
+2. User clicks Clawdbot Browser Relay toolbar icon (badge ON)
+3. Use `browser` tool with `profile="chrome"`
+
+### Common Workflows
+
+#### Get Campaign Performance
+
+```
+1. Navigate to: ads.google.com/aw/campaigns
+2. Set date range (top right date picker)
+3. Snapshot the campaigns table
+4. Parse: Campaign, Status, Budget, Cost, Conversions, Cost/Conv
+```
+
+#### Find Zero-Conversion Keywords (Wasted Spend)
+
+```
+1. Navigate to: ads.google.com/aw/keywords
+2. Click "Add filter" → Conversions → Less than → 1
+3. Click "Add filter" → Cost → Greater than → [threshold, e.g., $500]
+4. Sort by Cost descending
+5. Snapshot table for analysis
+```
+
+#### Pause Keywords/Campaigns
+
+```
+1. Navigate to keywords or campaigns view
+2. Check boxes for items to pause
+3. Click "Edit" dropdown → "Pause"
+4. Confirm action
+```
+
+#### Download Reports
+
+```
+1. Navigate to desired view (campaigns, keywords, etc.)
+2. Click "Download" icon (top right of table)
+3. Select format (CSV recommended)
+4. File downloads to user's Downloads folder
+```
+
+**For detailed browser selectors:** See `references/browser-workflows.md`
+
+---
+
+## API Mode (Power Users)
+
+**Requirements:** Google Ads API developer token + OAuth credentials
+
+### Setup Check
+
+```bash
+# Verify google-ads SDK
+python -c "from google.ads.googleads.client import GoogleAdsClient; print('OK')"
+
+# Check config
+cat ~/.google-ads.yaml
+```
+
+### Common Operations
+
+#### Query Campaign Performance
+
+```python
+from google.ads.googleads.client import GoogleAdsClient
+
+client = GoogleAdsClient.load_from_storage()
+ga_service = client.get_service("GoogleAdsService")
+
+query = """
+    SELECT campaign.name, campaign.status,
+           metrics.cost_micros, metrics.conversions,
+           metrics.cost_per_conversion
+    FROM campaign
+    WHERE segments.date DURING LAST_30_DAYS
+    ORDER BY metrics.cost_micros DESC
+"""
+
+response = ga_service.search(customer_id=CUSTOMER_ID, query=query)
+```
+
+#### Find Zero-Conversion Keywords
+
+```python
+query = """
+    SELECT ad_group_criterion.keyword.text,
+           campaign.name, metrics.cost_micros
+    FROM keyword_view
+    WHERE metrics.conversions = 0
+      AND metrics.cost_micros > 500000000
+      AND segments.date DURING LAST_90_DAYS
+    ORDER BY metrics.cost_micros DESC
+"""
+```
+
+#### Pause Keywords
+
+```python
+operations = []
+for keyword_id in keywords_to_pause:
+    operation = client.get_type("AdGroupCriterionOperation")
+    operation.update.resource_name = f"customers/{customer_id}/adGroupCriteria/{ad_group_id}~{keyword_id}"
+    operation.update.status = client.enums.AdGroupCriterionStatusEnum.PAUSED
+    operations.append(operation)
+
+service.mutate_ad_group_criteria(customer_id=customer_id, operations=operations)
+```
+
+**For full API reference:** See `references/api-setup.md`
+
+---
+
+## Audit Checklist
+
+Quick health check for any Google Ads account:
+
+| Check               | Browser Path                         | What to Look For          |
+| ------------------- | ------------------------------------ | ------------------------- |
+| Zero-conv keywords  | Keywords → Filter: Conv<1, Cost>$500 | Wasted spend              |
+| Empty ad groups     | Ad Groups → Filter: Ads=0            | No creative running       |
+| Policy violations   | Campaigns → Status column            | Yellow warning icons      |
+| Optimization Score  | Overview page (top right)            | Below 70% = action needed |
+| Conversion tracking | Tools → Conversions                  | Inactive/no recent data   |
+
+---
+
+## Output Formats
+
+When reporting findings, use tables:
+
+```markdown
+## Campaign Performance (Last 30 Days)
+
+| Campaign | Cost | Conv | CPA  | Status   |
+| -------- | ---- | ---- | ---- | -------- |
+| Branded  | $5K  | 50   | $100 | ✅ Good  |
+| SDK Web  | $10K | 2    | $5K  | ❌ Pause |
+
+## Recommended Actions
+
+1. **PAUSE**: SDK Web campaign ($5K CPA)
+2. **INCREASE**: Branded budget (strong performer)
+```
+
+---
+
+## Troubleshooting
+
+### Browser Mode Issues
+
+- **Can't see data**: Check user is on correct account (top right account selector)
+- **Slow loading**: Google Ads UI is heavy; wait for tables to fully load
+- **Session expired**: User needs to re-login to ads.google.com
+
+### API Mode Issues
+
+- **Authentication failed**: Refresh OAuth token, check `google-ads.yaml`
+- **Developer token rejected**: Ensure token is approved (not test mode)
+- **Customer ID error**: Use 10-digit ID without dashes

package/vendor/skills/skills/google-ads/_meta.json

@@ -0,0 +1,22 @@
+{
+    "owner": "jdrhyne",
+    "slug": "google-ads",
+    "displayName": "Google Ads",
+    "latest": {
+        "version": "1.1.0",
+        "publishedAt": 1770969683223,
+        "commit": "https://github.com/openclaw/skills/commit/5ee802dfd16d90ba0ecc8fe0f417c594e5fd6959"
+    },
+    "history": [
+        {
+            "version": "1.0.3",
+            "publishedAt": 1768840602714,
+            "commit": "https://github.com/clawdbot/skills/commit/e1dcb3f2efe0b09dd8f5eafc2329c4e54cde25b7"
+        },
+        {
+            "version": "1.0.2",
+            "publishedAt": 1768840295506,
+            "commit": "https://github.com/clawdbot/skills/commit/a86c7288ab249ab026192a3e205e147c0b5155d5"
+        }
+    ]
+}