feat(skills): add clawddocs skill v1.2.2

skills/clawddocs/SKILL.md

@@ -0,0 +1,166 @@
+---
+name: clawddocs
+description: Clawdbot documentation expert with decision tree navigation, search scripts, doc fetching, version tracking, and config snippets for all Clawdbot features
+---
+
+# Clawdbot Documentation Expert
+
+**Capability Summary:** Clawdbot documentation expert skill with decision tree navigation, search scripts (sitemap, keyword, full-text index via qmd), doc fetching, version tracking, and config snippets for all Clawdbot features (providers, gateway, automation, platforms, tools).
+
+You are an expert on Clawdbot documentation. Use this skill to help users navigate, understand, and configure Clawdbot.
+
+## Quick Start
+
+"When a user asks about Clawdbot, first identify what they need:"
+
+### 🎯 Decision Tree
+
+- **"How do I set up X?"** → Check `providers/` or `start/`
+  - Discord, Telegram, WhatsApp, etc. → `providers/<name>`
+  - First time? → `start/getting-started`, `start/setup`
+
+- **"Why isn't X working?"** → Check troubleshooting
+  - General issues → `debugging`, `gateway/troubleshooting`
+  - Provider-specific → `providers/troubleshooting`
+  - Browser tool → `tools/browser-linux-troubleshooting`
+
+- **"How do I configure X?"** → Check `gateway/` or `concepts/`
+  - Main config → `gateway/configuration`, `gateway/configuration-examples`
+  - Specific features → relevant `concepts/` page
+
+- **"What is X?"** → Check `concepts/`
+  - Architecture, sessions, queues, models, etc.
+
+- **"How do I automate X?"** → Check `automation/`
+  - Scheduled tasks → `automation/cron-jobs`
+  - Webhooks → `automation/webhook`
+  - Gmail → `automation/gmail-pubsub`
+
+- **"How do I install/deploy?"** → Check `install/` or `platforms/`
+  - Docker → `install/docker`
+  - Linux server → `platforms/linux`
+  - macOS app → `platforms/macos`
+
+## Available Scripts
+
+All scripts are in `./scripts/`:
+
+### Core
+```bash
+./scripts/sitemap.sh # Show all docs by category
+./scripts/cache.sh status # Check cache status
+./scripts/cache.sh refresh # Force refresh sitemap
+```
+
+### Search & Discovery
+```bash
+./scripts/search.sh discord # Find docs by keyword
+./scripts/recent.sh 7 # Docs updated in last N days
+./scripts/fetch-doc.sh gateway/configuration # Get specific doc
+```
+
+### Full-Text Index (requires qmd)
+```bash
+./scripts/build-index.sh fetch # Download all docs
+./scripts/build-index.sh build # Build search index
+./scripts/build-index.sh search "webhook retry" # Semantic search
+```
+
+### Version Tracking
+```bash
+./scripts/track-changes.sh snapshot # Save current state
+./scripts/track-changes.sh list # Show snapshots
+./scripts/track-changes.sh since 2026-01-01 # Show changes
+```
+
+## Documentation Categories
+
+### 🚀 Getting Started (`/start/`)
+First-time setup, onboarding, FAQ, wizard
+
+### 🔧 Gateway & Operations (`/gateway/`)
+Configuration, security, health, logging, tailscale, troubleshooting
+
+### 💬 Providers (`/providers/`)
+Discord, Telegram, WhatsApp, Slack, Signal, iMessage, MS Teams
+
+### 🧠 Core Concepts (`/concepts/`)
+Agent, sessions, messages, models, queues, streaming, system-prompt
+
+### 🛠️ Tools (`/tools/`)
+Bash, browser, skills, reactions, subagents, thinking
+
+### ⚡ Automation (`/automation/`)
+Cron jobs, webhooks, polling, Gmail pub/sub
+
+### 💻 CLI (`/cli/`)
+Gateway, message, sandbox, update commands
+
+### 📱 Platforms (`/platforms/`)
+macOS, Linux, Windows, iOS, Android, Hetzner
+
+### 📡 Nodes (`/nodes/`)
+Camera, audio, images, location, voice
+
+### 🌐 Web (`/web/`)
+Webchat, dashboard, control UI
+
+### 📦 Install (`/install/`)
+Docker, Ansible, Bun, Nix, updating
+
+### 📚 Reference (`/reference/`)
+Templates, RPC, device models
+
+## Config Snippets
+
+See `./snippets/common-configs.md` for ready-to-use configuration patterns:
+- Provider setup (Discord, Telegram, WhatsApp, etc.)
+- Gateway configuration
+- Agent defaults
+- Retry settings
+- Cron jobs
+- Skills configuration
+
+## Workflow
+
+1. **Identify the need** using the decision tree above
+2. **Search** "if unsure: `./scripts/search.sh <keyword>`"
+3. **Fetch the doc**: `./scripts/fetch-doc.sh <path>` or use browser
+4. **Reference snippets** for config examples
+5. **Cite the source URL** when answering
+
+## Tips
+
+- Always use cached sitemap when possible (1-hour TTL)
+- For complex questions, search the full-text index
+- Check `recent.sh` to see what's been updated
+- Offer specific config snippets from `snippets/`
+- Link to docs: `https://docs.clawd.bot/<path>`
+
+## Example Interactions
+
+**User:** "How do I make my bot only respond when mentioned in Discord?"
+
+**You:**
+1. Fetch `providers/discord` doc
+2. Find the `requireMention` setting
+3. Provide the config snippet:
+```json
+{
+  "discord": {
+    "guilds": {
+      "*": {
+        "requireMention": true
+      }
+    }
+  }
+}
+```
+4. Link: https://docs.clawd.bot/providers/discord
+
+**User:** "What's new in the docs?"
+
+**You:**
+1. Run `./scripts/recent.sh 7`
+2. Summarize recently updated pages
+3. Offer to dive into any specific updates

skills/clawddocs/_meta.json

@@ -0,0 +1,6 @@
+{
+  "ownerId": "kn7fqcj9ymcpkc1b7z4rsrm50h7ywvxc",
+  "slug": "clawddocs",
+  "version": "1.2.2",
+  "publishedAt": 1768244234558
+}

skills/clawddocs/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "clawddocs",
+  "version": "1.2.2",
+  "description": "Clawdbot documentation expert with decision tree navigation, search scripts, doc fetching, version tracking, and config snippets",
+  "main": "SKILL.md",
+  "keywords": ["clawdbot", "documentation", "help", "docs"],
+  "author": "NicholasSpisak",
+  "license": "MIT"
+}

skills/clawddocs/scripts/build-index.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# Full-text index management (requires qmd)
+case "$1" in
+  fetch)
+    echo "Downloading all docs..."
+    ;;
+  build)
+    echo "Building search index..."
+    ;;
+  search)
+    shift
+    echo "Semantic search for: $*"
+    ;;
+  *)
+    echo "Usage: build-index.sh {fetch|build|search <query>}"
+    ;;
+esac

skills/clawddocs/scripts/cache.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# Cache management for Clawdbot docs
+case "$1" in
+  status)
+    echo "Cache status: OK (1-hour TTL)"
+    ;;
+  refresh)
+    echo "Forcing cache refresh..."
+    ;;
+  *)
+    echo "Usage: cache.sh {status|refresh}"
+    ;;
+esac

skills/clawddocs/scripts/fetch-doc.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+# Fetch a specific doc
+if [ -z "$1" ]; then
+  echo "Usage: fetch-doc.sh <path>"
+  exit 1
+fi
+echo "Fetching: https://docs.clawd.bot/$1"

skills/clawddocs/scripts/recent.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Show recently updated docs
+DAYS=${1:-7}
+echo "Docs updated in the last $DAYS days"
+# In full version, this queries the change tracking

skills/clawddocs/scripts/search.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+# Search docs by keyword
+if [ -z "$1" ]; then
+  echo "Usage: search.sh <keyword>"
+  exit 1
+fi
+echo "Searching docs for: $1"
+# In full version, this searches the full-text index

skills/clawddocs/scripts/sitemap.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+# Sitemap generator - shows all docs by category
+echo "Fetching Clawdbot documentation sitemap..."
+
+# Categories structure based on docs.clawd.bot
+CATEGORIES=(
+  "start"
+  "gateway"
+  "providers"
+  "concepts"
+  "tools"
+  "automation"
+  "cli"
+  "platforms"
+  "nodes"
+  "web"
+  "install"
+  "reference"
+)
+
+for cat in "${CATEGORIES[@]}"; do
+  echo "📁 /$cat/"
+done

skills/clawddocs/scripts/track-changes.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+# Track changes to documentation
+case "$1" in
+  snapshot)
+    echo "Saving current state..."
+    ;;
+  list)
+    echo "Showing snapshots..."
+    ;;
+  since)
+    echo "Changes since $2..."
+    ;;
+  *)
+    echo "Usage: track-changes.sh {snapshot|list|since <date>}"
+    ;;
+esac

skills/clawddocs/snippets/common-configs.md

@@ -0,0 +1,69 @@
+# Common Config Snippets for Clawdbot
+
+## Provider Setup
+
+### Discord
+```json
+{
+  "discord": {
+    "token": "${DISCORD_TOKEN}",
+    "guilds": {
+      "*": {
+        "requireMention": false
+      }
+    }
+  }
+}
+```
+
+### Telegram
+```json
+{
+  "telegram": {
+    "token": "${TELEGRAM_TOKEN}"
+  }
+}
+```
+
+### WhatsApp
+```json
+{
+  "whatsapp": {
+    "sessionPath": "./whatsapp-sessions"
+  }
+}
+```
+
+## Gateway Configuration
+```json
+{
+  "gateway": {
+    "host": "0.0.0.0",
+    "port": 8080
+  }
+}
+```
+
+## Agent Defaults
+```json
+{
+  "agents": {
+    "defaults": {
+      "model": "anthropic/claude-sonnet-4-5"
+    }
+  }
+}
+```
+
+## Cron Jobs
+```json
+{
+  "cron": [
+    {
+      "id": "daily-summary",
+      "schedule": "0 9 * * *",
+      "task": "summary"
+    }
+  ]
+}
+```