skill-syncer

name	skill-syncer
description	Sync skills from `.claude/skills` and `.codex/skills` into `.gemini/skills`. Use when the user wants to import other agents' skills, detect newer upstream skill folders, or rewrite agent-specific skill paths for Gemini.

skill-syncer

.claude/skills と .codex/skills を見て、.gemini/skills へ不足分を取り込み、source 側のほうが新しい同名スキルだけ更新する。

Workflow

1. まず dry-run を実行して、copied / updated / skipped を確認する。

python3 .gemini/skills/skill-syncer/scripts/sync_skills.py --json

2. updated がある場合は、必要なら対象スキルだけ中身を開いて差分を確認する。 特に絶対パスや .claude/skills / .codex/skills 参照が .gemini/skills に正しく寄っているかを見る。

3. 問題なければ apply を実行する。

python3 .gemini/skills/skill-syncer/scripts/sync_skills.py --apply

4. 実行後に git diff -- .gemini/skills で結果を確認する。

Notes

• source が 2 つにまたがる同名スキルは、より新しい mtime のほうを採用する
• .gemini/skills 側が同等内容または新しい場合は上書きしない
• UTF-8 テキストは .claude/skills / .codex/skills のパス参照を .gemini/skills へ自動書換えする
• binary はそのままコピーする
• 自動書換えで足りないケースがあれば、apply 後に対象スキルだけ手で patch する