メインコンテンツまでスキップ

移行

他の Skill 管理方法から skillshare への移行方法です。

手動管理からの移行​

これまで AI CLI 間で Skill を手動でコピーしていた場合:

ステップ 1: skillshare を初期化する​

skillshare init

ステップ 2: 既存の Skill を収集する​

# 各 AI CLI から収集
skillshare collect claude
skillshare collect cursor
skillshare collect codex

# または一度にすべてから収集
skillshare collect --all

ステップ 3: 重複を処理する​

同じ Skill が複数の場所に存在する場合、collect が警告します。どちらを残すか選択してください。

ステップ 4: Sync する​

skillshare sync

これで、すべての Target が単一の Source にシンボリックリンクされます。

他のインストールツールからの移行​

npx install-skill などを使っていた場合:

ステップ 1: skillshare を初期化する​

skillshare init

ステップ 2: 既存の Skill をバックアップする​

skillshare backup

ステップ 3: 収集または再インストールする​

オプション A: 既存のものを収集する（現在のバージョンを維持）

skillshare collect --all

オプション B: Source から再インストールする（最新バージョンを取得）

# メタデータを確認
cat ~/.config/skillshare/skills/.metadata.json

# 再インストール
skillshare install anthropics/skills/skills/pdf

ステップ 4: Sync する​

skillshare sync

Git サブモジュールからの移行​

git サブモジュールを使っていた場合:

ステップ 1: サブモジュールの内容をエクスポートする​

# 既存の Skill リポジトリ内で
git submodule foreach 'cp -r $toplevel/$sm_path ~/temp-skills/$name'

ステップ 2: skillshare を初期化する​

skillshare init

ステップ 3: Skill をインポートする​

# Source にコピー
cp -r ~/temp-skills/* ~/.config/skillshare/skills/

# または Tracked repos としてインストール
skillshare install github.com/org/skill-repo --track

ステップ 4: Sync する​

skillshare sync

コミット済みの Project Skill からの移行​

すでにリポジトリに .claude/skills/、.cursor/skills/ などのディレクトリに Skill がコミットされている場合:

ステップ 1: Project mode を初期化する​

cd my-project
skillshare init -p

ステップ 2: Skill を .skillshare/skills/ に移動する​

# 既存の Skill を skillshare の Source にコピー
cp -r .claude/skills/my-skill .skillshare/skills/
cp -r .claude/skills/api-guide .skillshare/skills/

# 元のものを削除（Sync がシンボリックリンクとして再作成する）
rm -rf .claude/skills/my-skill .claude/skills/api-guide

ステップ 3: Sync する​

skillshare sync

これで .claude/skills/my-skill は .skillshare/skills/my-skill へのシンボリックリンクになり、他のすべての Target（Cursor、Windsurf など）にも同じ Skill が自動的に反映されます。

ステップ 4: 移行をコミットする​

git add .skillshare/ .claude/skills/ .cursor/skills/
git commit -m "Migrate project skills to skillshare"
マルチツールのメリット

以前: Skill は1つの AI CLI でしか動作しなかった。以後: 同じ Skill が設定済みのすべての Target で自動的に利用可能になる。

チーム独自の仕組みからの移行​

チームに独自の Skill 共有の仕組みがある場合:

ステップ 1: 現在のアプローチを特定する​

  • Skill はどこに保存されているか？
  • どのように共有されているか？
  • どのように更新されているか？

ステップ 2: 移行パスを選ぶ​

オプション A: Global mode — 各マシンのすべてのプロジェクトで Skill を利用可能にする。

# チーム Skill リポジトリを作成
cp -r /current/team/skills ~/new-team-skills
cd ~/new-team-skills && git init && git add . && git commit -m "Migrate to skillshare"
git push origin main

# チームメンバーは Global にインストール
skillshare install github.com/org/team-skills --track && skillshare sync

オプション B: Project mode — 特定のリポジトリにスコープされた Skill を git 経由で共有する。

cd my-project
skillshare init -p

# チーム Skill を Project の Source に移動
cp -r /current/team/skills/* .skillshare/skills/

# Sync してコミット
skillshare sync
git add .skillshare/
git commit -m "Add team skills via skillshare"

新しいチームメンバーは次のコマンドですべてを取得できます。

git clone github.com/org/my-project
cd my-project
skillshare install -p && skillshare sync

オプション C: 両方 — 組織全体の標準は Global、プロジェクト固有の Skill は各リポジトリで。

# 組織の標準（Global）
skillshare install github.com/org/standards --track && skillshare sync

# プロジェクト固有の Skill（Project mode）
cd my-project
skillshare init -p
skillshare install github.com/org/project-skills -p && skillshare sync
どちらを選ぶべきか？
  • Global: コーディング標準、セキュリティ監査など、すべてのプロジェクトに必要なもの
  • Project: API 規約、ドメインルール、デプロイガイドなど、1つのリポジトリに固有のもの
  • 両方: 多くのチームは成長するにつれてここに落ち着く

Global から Project への移行​

特定のプロジェクトに属する Skill が Global mode にある場合:

ステップ 1: Project mode を初期化する​

cd my-project
skillshare init -p

ステップ 2: Global の Source から Skill をコピーする​

# 特定の Skill をコピー
cp -r ~/.config/skillshare/skills/api-guide .skillshare/skills/
cp -r ~/.config/skillshare/skills/deploy-rules .skillshare/skills/

ステップ 3: Global から削除する（任意）​

skillshare uninstall api-guide
skillshare uninstall deploy-rules
skillshare sync   # Global のシンボリックリンクをクリーンアップ

ステップ 4: Sync してコミットする​

skillshare sync   # Project mode を自動検出
git add .skillshare/
git commit -m "Move project-specific skills to project mode"

これで Skill はこのリポジトリにスコープされ、git 経由でチームと共有されます — もう Global の設定を圧迫することはありません。

履歴の保持​

git の履歴を維持したい場合:

個人の Skill の場合​

# 既存のリポジトリを skillshare の場所に clone
git clone your-existing-repo ~/.config/skillshare/skills

# 既存の Source で skillshare を初期化
skillshare init --source ~/.config/skillshare/skills

チームのリポジトリの場合​

# --track を使って .git を保持
skillshare install github.com/team/skills --track

ロールバック​

移行がうまくいかなかった場合:

バックアップから復元する​

skillshare restore claude
skillshare restore cursor

最初からやり直す​

rm ~/.config/skillshare/config.yaml
skillshare init

チェックリスト​

移行前:

  • 現在の Skill の場所をすべてリストアップする
  • 重複を特定する
  • カスタム設定をメモする
  • バックアップを作成する

移行後:

  • skillshare list にすべての Skill が表示されることを確認する
  • 各 AI CLI で Skill をテストする
  • git リモートをセットアップする（必要であれば）
  • 新しいワークフローをチームと共有する

関連項目​