Add skills, learnings & memory updates (2026-01-26)
- New skills: clawddocs, claude-code-usage, summarize, homeassistant, humanizer, self-improving-agent - Add .learnings/ for self-improvement tracking - Document proaktive cron config (LRN-20260126-001) - Update USER.md: Löchgau as former residence - Update TOOLS.md: Peekaboo workaround - Memory files for 2026-01-25 and 2026-01-26
This commit is contained in:
7
skills/clawddocs/.clawdhub/origin.json
Normal file
7
skills/clawddocs/.clawdhub/origin.json
Normal file
@@ -0,0 +1,7 @@
|
||||
{
|
||||
"version": 1,
|
||||
"registry": "https://clawdhub.com",
|
||||
"slug": "clawddocs",
|
||||
"installedVersion": "1.2.2",
|
||||
"installedAt": 1769382039375
|
||||
}
|
||||
166
skills/clawddocs/SKILL.md
Normal file
166
skills/clawddocs/SKILL.md
Normal file
@@ -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
|
||||
9
skills/clawddocs/package.json
Normal file
9
skills/clawddocs/package.json
Normal file
@@ -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"
|
||||
}
|
||||
17
skills/clawddocs/scripts/build-index.sh
Normal file
17
skills/clawddocs/scripts/build-index.sh
Normal file
@@ -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
|
||||
13
skills/clawddocs/scripts/cache.sh
Normal file
13
skills/clawddocs/scripts/cache.sh
Normal file
@@ -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
|
||||
7
skills/clawddocs/scripts/fetch-doc.sh
Normal file
7
skills/clawddocs/scripts/fetch-doc.sh
Normal file
@@ -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"
|
||||
5
skills/clawddocs/scripts/recent.sh
Normal file
5
skills/clawddocs/scripts/recent.sh
Normal file
@@ -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
|
||||
8
skills/clawddocs/scripts/search.sh
Normal file
8
skills/clawddocs/scripts/search.sh
Normal file
@@ -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
|
||||
23
skills/clawddocs/scripts/sitemap.sh
Normal file
23
skills/clawddocs/scripts/sitemap.sh
Normal file
@@ -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
|
||||
16
skills/clawddocs/scripts/track-changes.sh
Normal file
16
skills/clawddocs/scripts/track-changes.sh
Normal file
@@ -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
|
||||
69
skills/clawddocs/snippets/common-configs.md
Normal file
69
skills/clawddocs/snippets/common-configs.md
Normal file
@@ -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"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
Reference in New Issue
Block a user