name: skill-sync version: 1.0.0 description: Automatically sync local skills to ClawHub and GitHub. Detects new/modified skills, publishes to ClawHub, commits to GitHub, and maintains sync status. author: sunnyhot license: MIT keywords:

skill-sync
clawhub
github
auto-publish
auto-sync
skill-manager

Skill Sync - 自动同步 Skills 到 ClawHub & GitHub

一键同步你的所有 skills

✨ 核心功能

🔄 自动同步

✅ 检测新增的 skills
✅ 检测修改的 skills
✅ 自动发布到 ClawHub
✅ 自动提交到 GitHub
✅ 记录同步状态

📊 状态管理

✅ 跟踪每个 skill 的同步状态
✅ 记录 ClawHub 发布 ID
✅ 记录 GitHub commit hash
✅ 提供同步报告

🔍 智能检测

✅ 检测 SKILL.md 文件变化
✅ 检测 scripts 文件变化
✅ 检测 package.json 变化
✅ 忽略临时文件和缓存

🚀 使用方法

1. 手动触发同步

node /Users/xufan65/.openclaw/workspace/skills/skill-sync/scripts/sync.cjs

功能:

扫描所有 skills
检测需要同步的 skills
发布到 ClawHub
提交到 GitHub
推送同步报告

2. 自动监控模式（推荐）

创建定时任务，每小时自动检查并同步：

openclaw cron add \
  --name "skill-sync" \
  --cron "0 * * * *" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --wake now \
  --deliver \
  --message "运行 skill-sync: 检查所有 skills 的变化，自动同步到 ClawHub 和 GitHub。报告格式用中文。"

运行频率:

每小时检查一次（0 * * * *）
或每 30 分钟检查一次（*/30 * * * *）

3. 查看同步状态

cat /Users/xufan65/.openclaw/workspace/memory/skill-sync-status.json

包含内容:

每个 skill 的同步状态
ClawHub 发布 ID
GitHub commit hash
最后同步时间
版本信息

📋 工作流程

┌─────────────────┐
│  扫描 Skills    │
│  - 检测新增     │
│  - 检测修改     │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  生成同步列表   │
│  - 新 skills    │
│  - 修改的 skills│
└────────┬────────┘
         │
         ▼
     有需要同步的？
         │
    ┌────┴────┐
   Yes       No
    │          │
    ▼          ▼
┌───────┐  ┌──────────┐
│同步流程│  │推送报告  │
└───┬───┘  │无需同步  │
    │      └──────────┘
    ▼
┌─────────────────┐
│  1. Git Commit  │
│  2. ClawHub Pub │
│  3. Git Push    │
│  4. 更新状态    │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  推送同步报告   │
│  - 成功列表     │
│  - 失败列表     │
│  - 状态更新     │
└─────────────────┘

🔧 配置选项

`config/settings.json`

{
  "skillsDir": "/Users/xufan65/.openclaw/workspace/skills",
  "statusFile": "/Users/xufan65/.openclaw/workspace/memory/skill-sync-status.json",
  "gitRepo": "/Users/xufan65/.openclaw/workspace",
  "clawhubConfig": {
    "autoPublish": true,
    "requireConfirmation": false
  },
  "gitConfig": {
    "autoCommit": true,
    "autoPush": true,
    "commitMessage": "Auto-sync skills to ClawHub"
  },
  "ignorePatterns": [
    "node_modules",
    ".git",
    "*.log",
    "*.tmp"
  ]
}

📊 同步状态文件

`memory/skill-sync-status.json`

{
  "lastSync": "2026-03-12T14:30:00+08:00",
  "skills": {
    "deals-hunter": {
      "version": "3.0.0",
      "clawhubId": "k97c0kee4b0t8rmf4490m9r9bn82s082",
      "clawhubPublished": "2026-03-12T10:00:00+08:00",
      "gitCommit": "7779310",
      "gitPushed": "2026-03-12T14:30:00+08:00",
      "status": "synced"
    },
    "failure-monitor": {
      "version": "1.0.0",
      "clawhubId": "k973cr1p4k5g3mh36yjp24agg182rcsa",
      "clawhubPublished": "2026-03-12T14:30:00+08:00",
      "gitCommit": "22b355d",
      "gitPushed": "2026-03-12T14:35:00+08:00",
      "status": "synced"
    }
  }
}

🎯 同步条件

需要同步的情况:

新增 Skill
- skills/ 目录下出现新的 skill 文件夹
- 包含 SKILL.md 文件
版本更新
- SKILL.md 中的 version 字段变化
- package.json 中的 version 字段变化
文件修改
- SKILL.md 被修改
- scripts/ 目录下的文件被修改
- config/ 目录下的文件被修改
未同步状态
- 状态文件中没有该 skill 的记录
- 状态为 pending 或 failed

🔒 安全考虑

✅ 只同步 skills 目录：不会修改其他文件
✅ 保留 Git 历史：使用 git add + git commit
✅ ClawHub 验证：发布前检查 skill 格式
✅ 错误处理：发布失败不会中断整个流程
✅ 回滚支持：可以通过 Git 回滚到之前的状态

📝 Discord 推送格式

同步成功

# ✅ Skills 同步完成

**同步时间**: 2026-03-12 14:30:00
**总计**: 3 个 skills

## 📦 成功同步

### 1. **failure-monitor** v1.0.0
- ✅ ClawHub: k973cr1p4k5g3mh36yjp24agg182rcsa
- ✅ GitHub: commit 22b355d
- 📅 发布时间: 2026-03-12 14:30:00

### 2. **deals-hunter** v3.0.0
- ✅ ClawHub: k97c0kee4b0t8rmf4490m9r9bn82s082
- ✅ GitHub: commit 7779310
- 📅 发布时间: 2026-03-12 10:00:00

---

**🔗 快速链接**:
- ClawHub: https://clawhub.com/skill/failure-monitor
- GitHub: https://github.com/sunnyhot/deals-hunter

无需同步

# ℹ️ Skills 检查完成

**检查时间**: 2026-03-12 15:00:00
**总计**: 10 个 skills

✅ 所有 skills 已是最新状态，无需同步

部分失败

# ⚠️ Skills 同步完成（部分失败）

**同步时间**: 2026-03-12 14:30:00
**成功**: 2 个 | **失败**: 1 个

## ✅ 成功同步
- failure-monitor v1.0.0
- deals-hunter v3.0.0

## ❌ 失败列表
### skill-name v1.0.0
- **错误**: ClawHub API rate limit exceeded
- **建议**: 稍后重试或手动发布

---

**建议**: 检查失败的 skills 并手动修复

📁 文件结构

skills/skill-sync/
├── SKILL.md                      # 技能说明
├── scripts/
│   ├── sync.cjs                  # 主同步脚本
│   ├── scan-skills.cjs           # 扫描 skills
│   ├── publish-clawhub.cjs       # 发布到 ClawHub
│   └── git-sync.cjs              # Git 同步
├── config/
│   └── settings.json             # 配置选项
└── package.json                  # 依赖管理

🔧 命令行选项

完整同步

node scripts/sync.cjs --all

同步所有需要同步的 skills

指定 Skill

node scripts/sync.cjs --skill failure-monitor

只同步指定的 skill

仅 ClawHub

node scripts/sync.cjs --clawhub-only

只发布到 ClawHub，不提交到 GitHub

仅 GitHub

node scripts/sync.cjs --git-only

只提交到 GitHub，不发布到 ClawHub

Dry Run

node scripts/sync.cjs --dry-run

只检查需要同步的 skills，不实际执行

🎯 最佳实践

1. 运行频率

✅ 推荐：每小时检查一次
✅ 可接受：每 30 分钟检查一次
❌ 不推荐：超过 2 小时（可能错过更新）

2. 版本管理

✅ 每次修改后更新 version 字段
✅ 使用语义化版本（SemVer）
✅ 在 SKILL.md 中记录更新日志

3. 提交信息

✅ 使用清晰的 commit message
✅ 包含 skill 名称和版本
✅ 描述主要修改内容

🚨 故障排除

Q: ClawHub 发布失败怎么办？

A: 检查以下几点：

ClawHub CLI 是否已登录（clawhub login）
SKILL.md 格式是否正确
是否有网络问题
可以稍后重试或手动发布

Q: Git 推送失败怎么办？

A: 检查以下几点：

Git 仓库是否正确配置
是否有网络问题
是否有冲突需要解决
可以手动 git push 解决

Q: 如何查看详细日志？

A: 查看日志文件：

cat /Users/xufan65/.openclaw/workspace/memory/skill-sync-log.json

📝 更新日志

v1.0.0 (2026-03-12)

✅ 初始版本
✅ 支持自动检测 skills 变化
✅ 支持自动发布到 ClawHub
✅ 支持自动提交到 GitHub
✅ 支持同步状态跟踪
✅ 支持 Discord 推送通知

🤝 贡献

欢迎提交 Issue 和 Pull Request！

GitHub: https://github.com/sunnyhot/skill-sync

🎉 让你的 skills 管理更加自动化！

Skill Sync

Description