| 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
- まず dry-run を実行して、
copied / updated / skipped を確認する。
python3 .gemini/skills/skill-syncer/scripts/sync_skills.py --json
-
updated がある場合は、必要なら対象スキルだけ中身を開いて差分を確認する。
特に絶対パスや .claude/skills / .codex/skills 参照が .gemini/skills に正しく寄っているかを見る。
-
問題なければ apply を実行する。
python3 .gemini/skills/skill-syncer/scripts/sync_skills.py --apply
- 実行後に
git diff -- .gemini/skills で結果を確認する。
Notes
- source が 2 つにまたがる同名スキルは、より新しい mtime のほうを採用する
.gemini/skills 側が同等内容または新しい場合は上書きしない
- UTF-8 テキストは
.claude/skills / .codex/skills のパス参照を .gemini/skills へ自動書換えする
- binary はそのままコピーする
- 自動書換えで足りないケースがあれば、apply 後に対象スキルだけ手で patch する