Back to Details

sync-skills-manager

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Sync Skills Manager

Sync Skills Manager

Manage synchronization between repository skills and local/system skill directories.
管理仓库Skills与本地/系统Skill目录之间的同步。

Scripts

脚本

sync-skills.sh
(legacy 2-way)

sync-skills.sh
（传统双向同步）

Sync between 
~/.agents/skills
and 
./system-skills
categories.
CommandDescription
./sync-skills.sh diff
Preview system-only skills
./sync-skills.sh pull
Sync 
~/.agents/skills
-> repo (add new skills)
./sync-skills.sh push
Sync repo -> 
~/.agents/skills
(no 
add-skill
)
./sync-skills.sh dedupe
Remove duplicate entries from 
~/.gemini/skills
./sync-skills.sh status
Show sync status
在
~/.agents/skills
与
./system-skills
分类之间同步。
命令描述
./sync-skills.sh diff
预览仅存在于系统中的Skills
./sync-skills.sh pull
将
~/.agents/skills
同步到仓库（添加新Skills）
./sync-skills.sh push
将仓库同步到
~/.agents/skills
（不执行
add-skill
）
./sync-skills.sh dedupe
从
~/.gemini/skills
中移除重复条目
./sync-skills.sh status
显示同步状态

sync-skills-3way.sh
(recommended)

sync-skills-3way.sh
（推荐使用）

Incremental 3-way sync across:
  • ~/.codex/skills
    (including 
    .system
    )
  • ~/.agents/skills
  • ~/.agent/skills
  • repository skills tree
Key behavior:
  • Incremental only (
    rsync --update
    ), never deletes files.
  • New skills missing in repo are added to 
    system-skills/tools-skills/
    .
  • For duplicate skill names in repo, the newest 
    SKILL.md
    copy is treated as canonical for repo -> local sync.
CommandDescription
./sync-skills-3way.sh sync
Run 3-way incremental sync (default)
./sync-skills-3way.sh status
Show counts and name-level diffs
./sync-skills-3way.sh help
Show usage
跨以下路径的增量三方同步：
  • ~/.codex/skills
    （包含
    .system
    ）
  • ~/.agents/skills
  • ~/.agent/skills
  • 仓库Skills目录树
核心特性：
  • 仅支持增量同步（使用
    rsync --update
    ），从不删除文件。
  • 仓库中缺失的新Skills会被添加到
    system-skills/tools-skills/
    目录下。
  • 对于仓库中重名的Skill，最新的
    SKILL.md
    副本会作为仓库到本地同步的标准版本。
命令描述
./sync-skills-3way.sh sync
执行三方增量同步（默认命令）
./sync-skills-3way.sh status
显示统计数量和名称层面的差异
./sync-skills-3way.sh help
显示使用说明

Usage

使用方法

Daily 3-way sync

日常三方同步

bash
./sync-skills-3way.sh sync
bash
./sync-skills-3way.sh sync

Quick status check

快速状态检查

bash
./sync-skills-3way.sh status
bash
./sync-skills-3way.sh status

Configuration

配置

sync-skills.sh
uses 
sync-config.json
:
json
{
  "system_skills_path": "~/.agents/skills",
  "repo_skills_path": "./system-skills",
  "exclude_patterns": ["sync-skills-manager"],
  "sync_mode": "incremental",
  "default_command": "diff"
}
sync-skills.sh
使用 
sync-config.json
配置文件：
json
{
  "system_skills_path": "~/.agents/skills",
  "repo_skills_path": "./system-skills",
  "exclude_patterns": ["sync-skills-manager"],
  "sync_mode": "incremental",
  "default_command": "diff"
}