migrate-skills-between-libraries について
メタデータと依存関係を保ち、重複を避けながら、ライブラリのワークスペース間でスキルを移行するためのスキルです。ソースの確認、移行先での名前衝突チェック、インポート、ドキュメント再生成、検証を案内します。
主な機能
- 01ソースのスキルを JSON で一覧表示
- 02インポート前の名前衝突確認
- 03自作スキルのコピーと上流スキルの再カタログ
- 04ドキュメント再生成と移行先の検証
- 05依存関係とコレクション所属の確認
活用シーン
- 01選んだスキルを別のワークスペースへ移行
- 02上流スキルを元のソースから移行
- 03移行に必要な依存関係の確認と対応
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ moizibnyousaf/ ai-agent-skills --skill migrate-skills-between-librariesインストール後、Claude Code で/migrate-skills-between-librariesを入力して読み込まれたか確認します。
詳細
ライブラリ間でスキルを移行する
目的
メタデータを失ったり、依存関係を壊したり、エントリーを重複させたりせずに、あるライブラリのワークスペースから別のワークスペースへスキルを移動します。
ガードレール
- 対象ワークスペースで変更を伴うコマンドを実行する前に、必ず
--dry-runを使用してください。 - インポートする前に、必ず
--listを使用してソースライブラリを確認してください。 - 移行のスクリプトを作成する場合、構造化出力には必ず
--format jsonを使用してください。 - 対象ワークスペースで名前が衝突しないか確認せずに、スキルをインポートしないでください。
- 移行後は、必ず対象ワークスペースで
build-docsを実行してください。
ワークフロー
エクスポート:ソースライブラリから移行するスキルを特定する
- ソースワークスペース内のすべてのスキルを一覧表示します。
cd /path/to/source-library
npx ai-agent-skills list --format json --fields name,tier,workArea,collections
- ローカルコピーの場合はスキルフォルダーのパスを控えます。上流ソースから選択したスキルの場合は、installSource を控えます。
インポート:対象ワークスペースにスキルを追加する
- ローカルコピーの場合は、
vendorを使用してスキルフォルダーを対象にコピーします。
cd /path/to/target-library
npx ai-agent-skills vendor /path/to/source-library --skill <name> --area <workArea> --branch <branch> --why "Migrated from source library." --dry-run
npx ai-agent-skills vendor /path/to/source-library --skill <name> --area <workArea> --branch <branch> --why "Migrated from source library."
- 上流ソースから選択したスキルの場合は、
catalogを使用して元のソースから再カタログ化します。
npx ai-agent-skills catalog <owner>/<repo> --skill <name> --area <workArea> --branch <branch> --why "Migrated from source library." --dry-run
npx ai-agent-skills catalog <owner>/<repo> --skill <name> --area <workArea> --branch <branch> --why "Migrated from source library."
- 対象ワークスペースでドキュメントを再ビルドします。
npx ai-agent-skills build-docs
- 対象ワークスペースを検証します。
npx ai-agent-skills validate
注意事項
- スキル名はワークスペースごとに一意である必要があります。インポート前に名前が衝突しないか確認してください。
- ローカルコピーはフォルダー全体のコピーです。移行後、ソースと対象はそれぞれ独立します。
- 上流ソースから選択したスキルは、中間ライブラリではなく、元の上流ソースから再カタログ化されます。
- 依存関係(
requiresフィールド)も移行する必要があります。各スキルの依存関係グラフを確認するには、info --format jsonを使用してください。 - コレクションへの所属は自動的に引き継がれません。移行したスキルを対象のコレクションに追加するには、
curate --collection <id>を使用してください。
コメント
Markdown 対応