openclaw-skills/README.md

OpenClaw Custom Skills

Backup and version control for custom OpenClaw skills deployed on docker-test. These skills extend the agent beyond the built-in defaults (ClawHub-installed or bundled).

Purpose

• Backup — Preserve custom skills outside the deployment
• Version control — Track changes, roll back, collaborate
• Sync — Pull new skills from docker-test, push local edits back

Directory Structure

Skills are organized by their source location on the remote:

Directory	Remote Path	Skills
workspace/	/opt/openclaw/workspace/skills/	capmetro-monitor, github-notifications, model-selector
workspace-security/	/opt/openclaw/state/workspace-security/skills/	vt-monitor, monitor-unauthorized
workspace-home/	/opt/openclaw/state/workspace-home/skills/	cron-manager
extensions/	/opt/openclaw/state/extensions/openclaw-plugin-vt-sentinel/skills/	vt-sentinel

Each skill is a folder containing SKILL.md and optional scripts/, references/, etc.

Access Pattern

Prerequisites

• SSH access to docker-test (configured in ~/.ssh/config)
• OpenClaw deployed at /opt/openclaw on docker-test

Sync Script

# Pull skills FROM docker-test TO local (download new/updated)
./sync.sh pull

# Push skills FROM local TO docker-test (upload your changes)
./sync.sh push

Override the SSH host:

REMOTE=my-server ./sync.sh pull

What Gets Excluded

The sync script and .gitignore exclude runtime files:

• state.json — Per-skill state (tokens, seen IDs)
• seen-connections.json — Connection tracking
• authorized-ips.json — IP whitelist
• memory/ — Skill memory directories

These contain environment-specific or sensitive data and should never be committed.

Custom Skills Inventory

Skill	Source	Description
capmetro-monitor	workspace	Monitor CapMetro (Austin) service changes for Route 5/500
github-notifications	workspace	Check GitHub PRs and releases with smart filtering
model-selector	workspace	Safely change agent primary/fallback models via LLM proxy
vt-monitor	workspace-security	Parse VT-Sentinel activity from gateway logs
monitor-unauthorized	workspace-security	Detect unauthorized WebSocket connections
cron-manager	workspace-home	Manage cron and reminder workflows
vt-sentinel	extensions	VirusTotal security scanner (ClawHub plugin)

First-Time Setup

1. Create the repository on Gitea (e.g. b3nw/openclaw-skills) if it does not exist.
2. Push the initial commit: git push -u origin main

Workflow

1. Regular backup: Run ./sync.sh pull periodically to capture new skills or updates made directly on docker-test.
2. Edit locally: Modify skills in this repo, commit, push to Gitea.
3. Deploy changes: Run ./sync.sh push to apply local edits to docker-test.
4. Restart OpenClaw or start a new session so it picks up changes.