From 3e9339c77fdb5ac4be87b9eb5254b996a72cf1f1 Mon Sep 17 00:00:00 2001
From: Ash Brener <ashley@starlogik.com>
Date: Wed, 28 Jan 2026 10:50:35 +0200
Subject: [PATCH] feat: add workspace-sync skill for agent awareness

---
 skills/workspace-sync/SKILL.md | 100 +++++++++++++++++++++++++++++++++
 1 file changed, 100 insertions(+)
 create mode 100644 skills/workspace-sync/SKILL.md

diff --git a/skills/workspace-sync/SKILL.md b/skills/workspace-sync/SKILL.md
new file mode 100644
index 000000000..c67960ffa
--- /dev/null
+++ b/skills/workspace-sync/SKILL.md
@@ -0,0 +1,100 @@
+---
+name: workspace-sync
+description: Sync agent workspace with cloud storage (Dropbox, Google Drive, S3, etc.) using rclone.
+metadata: {"moltbot":{"emoji":"☁️","requires":{"bins":["rclone"]}}}
+---
+
+# workspace-sync
+
+Bidirectional sync between the agent workspace and cloud storage. Useful for backing up workspace files, sharing across devices, or restoring after migrations.
+
+## Trigger
+
+Use this skill when the user asks to:
+- Sync workspace to/from cloud
+- Back up workspace files
+- Check sync status
+- Fix sync issues
+
+## Commands
+
+### Check sync status
+```bash
+moltbot workspace status
+```
+
+Shows: provider, last sync time, sync count, error count, running state.
+
+### Trigger manual sync
+```bash
+moltbot workspace sync
+```
+
+Runs a bidirectional sync immediately. Use after bulk workspace changes.
+
+### First-time sync (required once)
+```bash
+moltbot workspace sync --resync
+```
+
+Required on first run to establish baseline. Only needed once per remote.
+
+### View remote files
+```bash
+moltbot workspace list
+```
+
+Lists files in the configured cloud storage path.
+
+## Configuration
+
+Workspace sync is configured in `moltbot.json`:
+
+```json
+{
+  "workspace": {
+    "sync": {
+      "provider": "dropbox",
+      "remotePath": "/",
+      "localPath": "/",
+      "interval": 60,
+      "onSessionStart": true,
+      "onSessionEnd": true
+    }
+  }
+}
+```
+
+## Automatic sync
+
+When configured, sync runs automatically:
+- **On session start**: Before you start working (pulls latest from cloud)
+- **On session end**: After conversation ends (pushes changes to cloud)
+- **Periodic interval**: Background sync every N seconds (no LLM cost)
+
+## Troubleshooting
+
+### "rclone not configured"
+Run the setup wizard:
+```bash
+moltbot workspace setup
+```
+
+### "requires --resync"
+First sync needs to establish baseline:
+```bash
+moltbot workspace sync --resync
+```
+
+### Check rclone directly
+```bash
+rclone lsd cloud:/
+rclone ls cloud:moltbot-share
+```
+
+## Notes
+
+- Sync is bidirectional (changes flow both ways)
+- Conflicts resolve by newest file (configurable)
+- `.git/` and `node_modules/` excluded by default
+- Sync operations run in background (no LLM tokens used)