2026 Cursor Agent SkillsをMac変更後もClaude Codeで使うには？

旧Macでは使えていたのに、新しいMacのClaude Codeで同名スキルが2つ見えるなら、最速の解決策は片方の導入元を外し、唯一の供給元に戻すことです。2026年にCursor Agent SkillsをMac変更後も使う場合、ファイル版はリポジトリから再構築し、plugin版は新しいMacで公式手順により再インストールします。

この記事は、Cursorのプロジェクトを新しいMacへ移す個人開発者、短期間だけクラウドMacを使うチーム、同じMacでCursorとClaude Codeを併用する開発者向けです。旧Macの状態をそのまま複製したい人ではなく、次の環境でも再現できる形に整えたい人が対象です。

最終更新：2026年8月27日。導入方式、CLI、ディレクトリ規則、二重導入への注意は、公式README、skills CLIの配布情報、Claude Codeのpluginリファレンスを基に確認しています。

先に固定するスキルの供給元

mattpocock/skillsの公式READMEでは、プロジェクトに置く編集可能なファイル版と、Claude Codeが管理するplugin版を別の導入方法として扱っています。ファイル版は自分で内容を変更し、リポジトリに含めて更新を管理する方式です。plugin版はClaude Code側の管理機能から利用します。

重要なのは、両方を同じ名前で導入しないことです。READMEは、ファイル版とClaude Code pluginを同時に導入すると重複したスキルが発生すると警告しています。まず旧Macで現在どちらを使っているかを記録し、その後にコピーや再インストールを始めてください。

長期利用の新Macはリポジトリから復元

長く使うMacでは、スキルそのものをマシンの持ち物にしないでください。プロジェクトのリポジトリに含まれるファイル、初期化に必要な設定、独自に変更した内容を基準にします。旧Macのホームディレクトリを圧縮して移す方法は、隠れた依存関係まで持ち込むため、再現性の確認になりません。

作業は次の順番で進めます。

1. 旧Macで、ファイル版かplugin版かを記録します。同名スキルの独自変更、プロジェクト設定、初期化手順もメモします。
2. 新Macに対象リポジトリを取得します。スキルをプロジェクトで管理する場合は、公式READMEが示すディレクトリ、通常はプロジェクト内の.agents/skills/を確認します。
3. 当日の公式READMEにあるnpx skills addの書式を確認してから、必要なスキルだけを導入します。古い記事のコマンドをそのまま使わないでください。
4. 旧Macで行った独自変更がGit上に存在するか確認します。未コミットの編集は、旧Macを消去する前に差分として保存します。
5. リポジトリの初期化手順を実行し、Claude Codeからスキル名が見えるか確認します。
6. 低リスクの作業を1回だけ実行します。ファイルの読み取りや説明生成など、変更を伴わない内容が適しています。
7. セッションを再起動し、同じスキルが再び表示されるか確認します。

npx skills addや更新方法はCLIの仕様変更対象です。実行前に公式CLIパッケージの最新情報とREADMEの記載を照合してください。コマンドが通ったことだけで移行完了とは判断しません。独自変更が戻っていること、プロジェクト設定が揃っていること、再起動後も同じ供給元であることが必要です。

注意：.agents/skills/という場所を確認できても、そこに旧Macから別経路の同名ファイルを追加しないでください。導入方式が変わる場合は、いったん一覧と差分を記録してから片方を削除します。

一時Macは完全コピーではなく再構築

一時的なMacやクラウドMacでは、旧Macのユーザーフォルダーを丸ごと再現するより、空の環境からリポジトリを取得する方が安全です。環境を破棄した後も、同じリポジトリから同じ供給元を選べるからです。

プロジェクトファイル版が向くのは、CursorとClaude Codeの両方で編集可能な定義を共有したい場合、または作業終了後に同じ状態を再生成したい場合です。一方、Claude Codeだけで短時間の作業を行い、スキルを変更しないなら、pluginを公式の管理機能から導入する選択もできます。どちらも「旧Macの状態を持ち込む」ことが目的ではありません。

環境を消す前に、次の4項目をリポジトリまたは安全な記録場所へ戻します。

• 独自に編集したスキルと、その変更理由
• プロジェクト初期化に必要な設定
• 使用した供給元と導入時点
• スキルの表示、実行、再起動後の確認結果

MacHTMLの操作画面と利用環境の案内を確認してから作業環境を用意すると、接続方法と破棄前の確認箇所を分けて管理できます。短期環境で作った未整理のホームディレクトリは、プロジェクト資産ではありません。

plugin版だけを新Macへ戻す場合

旧MacでClaude Code pluginだけを使っていたなら、新MacでもClaude Codeの公式手順から導入します。pluginの管理対象を手動でコピーするのではなく、Claude Codeが認識する導入経路を使ってください。pluginの公式リファレンスでは、管理や有効化に関する操作が整理されています。

復元後は、次の順で確認します。

• pluginが有効になっている
• 期待するスキルが一覧または検索結果に表示される
• 対象リポジトリを開いた状態で呼び出せる
• 現在のリポジトリの初期化要件を満たしている
• セッションを再起動しても状態が維持される

プロジェクト内に同名のファイル版が残っていたら、設定を足し続けないでください。どちらを残すか決め、不要な方を削除または別ブランチへ退避します。Claude Codeのplugin探索や導入の考え方は、公式のplugin探索ガイドにも従います。

CursorとClaude Codeを同じMacで使う構成

併用自体は問題ではありません。問題になるのは、Claude Codeへ同じ名前のスキルを2経路で見せることです。Cursor用とClaude Code用に別コピーを作るのではなく、編集可能なプロジェクトファイルを共通の供給元にするか、Claude Codeだけpluginを使う形に限定します。

検証はツールごとに分けます。まずCursorで対象プロジェクトと想定スキルが見えることを確認します。次にClaude Codeで同じプロジェクト文脈を開き、同じ名前の定義を1つだけ検出できることを確認します。最後に、ファイル変更を伴わない低リスクのテストを各ツールで1回ずつ実行します。

交付前の証拠とロールバック

新Macをチームへ渡す前に、口頭説明ではなく記録を残します。最低限、唯一のインストール元、見えているスキル一覧、実際の呼び出し結果、独自内容の一致、再起動後の状態を保存します。これで「動いた」という一度限りの確認と、再現できる環境を区別できます。

ロールバックは、旧Macで確認済みのリポジトリ版へ戻すか、単一のplugin版へ戻します。問題がある状態へもう一度別方式を追加するのはロールバックではありません。

交付前チェック

• [ ] 旧Macの導入方式を記録した
• [ ] 新Macの供給元を1つに決めた
• [ ] リポジトリの独自変更を確認した
• [ ] 期待するスキル一覧を記録した
• [ ] 低リスクの実行結果を保存した
• [ ] セッション再起動後も確認した
• [ ] ホームディレクトリのキャッシュを交付根拠にしていない

経験上、交付資料に含めるべきなのはGit管理された定義と検証記録です。旧Macの一時キャッシュ、管理ツールが生成した未確認ファイル、個人のホームフォルダー全体は、再現性の証拠になりません。

よくある判断

新しいMacで毎回再インストールが必要か

ファイル版ならリポジトリから取得して確認します。plugin版ならClaude Code側で再導入します。旧Macの管理フォルダーをコピーして済ませる方法は、今回の供給元を再現したことになりません。

mattpocock/skillsはGitで移せるか

編集可能なファイル版としてプロジェクトに含める運用なら、Gitで移行できます。導入元、独自変更、初期化手順を同時に管理してください。plugin版の管理内容までGitにコピーする意味ではありません。

クラウドMacでCursorとClaude Codeを併用する方法

同じプロジェクトファイルを共有するか、Claude Codeだけpluginを使います。2つの同名定義を置かず、各ツールで一覧、文脈、低リスク実行、再起動後の状態を確認します。

Claude Code pluginの新Mac復元

Claude Codeの公式plugin手順で導入し、pluginの有効化、スキルの発見、プロジェクト初期化、再起動後の維持を確認します。同名のファイル版があれば、追加設定より先に整理します。

一時Macではどちらを選ぶか

再構築を重視するなら、リポジトリから戻せるファイル版が扱いやすいです。Claude Codeだけの短期検証で編集もしないならplugin版が候補です。終了前に設定と検証記録を持ち帰れることを優先します。

旧Macのユーザーフォルダーを丸ごと移す方法は、隠れたキャッシュ、古い設定、同名スキルの重複を持ち込みやすく、今回の用途では長期運用の根拠になりません。MacHTMLのレンタルMacなら、短期検証用の環境を分けて使い、作業後はこのチェック項目で交付状態を確認できます。長期の安定運用や物理機器への接続が必要なら自前のMacが適するため、用途と期間を確認したうえでMacHTMLの利用方法や料金プランを比較してください。

関連記事: エージェントスキルの導入とチーム設定を確認する 新しいMacで開発環境を分離し、再現性を高める方法