Note
人間が書きました。
はじめに
Claude Code on the Web 使ってますか?
有名スキル grill-me の作者 Matt氏がローカル開発を離れてクラウド開発に移行しつつあるというツイートくらいのタイミングから「クラウド開発」「クラウドエージェント」の話題をよく聞くようになりました。
私も使いたいなーと思いつつ、「ローカルのスキルが使えない」 を言い訳に少し躊躇していましたが、今回の設定をしたことで、かなり積極的にクラウド開発を開発フローに組み込むことができるようになりました!(この話は別記事で)
色々と試行錯誤をしましたが、設定方法はこれ以外にもいくつかの方法がありそうでしたので一例として共有いたします。
できるようになること
Claude Code on the Web でローカルのスキルがすべて使えるようになります。

ちなみに、Claude Webアプリ やスマホアプリなど(普通のチャットの方)からもローカルのスキルが使えるようになります!

前提
ローカルのClaudeCodeで使用しているスキルをクラウド環境(Claude Code on the web)やClaudeのWebアプリで使用できるようにしたい。
ローカルのスキルはchezmoiで他のPC設定と共にdotfiles(プライベートリポジトリ)にして管理しています。
dotfiles/ # chezmoi のソース(プライベートリポジトリ)
├── .chezmoiroot # 中身は "home"。home/ 配下だけを chezmoi のソースとして扱う
├── home/
│ ├── dot_agents/ # → ~/.agents
│ │ └── skills/ # → ~/.agents/skills(約 220 件)
│ │ ├── grilling/
│ │ │ └── SKILL.md
│ │ ├── taking-note/
│ │ │ ├── SKILL.md
│ │ │ └── scripts/
│ │ └── ...
│ ├── dot_claude/ # → ~/.claude(skills は ~/.agents/skills への symlink)
│ ├── dot_config/ # → ~/.config
│ └── ... # その他の PC 設定
└── ...具体的な方法
単刀直入に結論からいくと、自身のスキルをpluginにパッケージ化することでかなりシンプルに実現できました。
1. dotfiles にマーケットプレイスとプラグインの定義を足す
claude.ai はリポジトリ直下の .claude-plugin/marketplace.json を読み、source に書いたディレクトリをプラグインとして配ります。プラグインの中の skills/ 配下がスキルとして読み込まれます。ここでは home/dot_agents をそのままプラグインにしました。
dotfiles/
├── .chezmoiroot
+├── .claude-plugin/
+│ └── marketplace.json # プラグインの取得元は ./home/dot_agents
├── home/
│ ├── dot_agents/
+│ │ ├── .claude-plugin/
+│ │ │ └── plugin.json # プラグイン「dotfiles」の定義
│ │ └── skills/
│ └── ...
└── ...{
"name": "yasu-dotfiles",
"owner": { "name": "yasu-888" },
"plugins": [
{ "name": "dotfiles", "source": "./home/dot_agents" }
]
}{
"name": "dotfiles"
}参考: Create a marketplace、Marketplace reference、Plugins reference
2. https://claude.ai/customize/plugins にアクセス

3. 追加 > マーケットプレイスを追加

4. リポジトリから追加

参考: Plugins(Find and add a plugin)
5. dotfilesを選択して、同期
Warning
クラウドセッションでdotfilesリポジトリを接続済みである必要があります。
プライベートリポジトリでは既定ブランチ(main)しか同期できませんでした(ブランチを指定する書き方は受け付けられませんでした)。

参考: Plugins(Find and add a plugin)、Plugin feature support across platforms
6. https://claude.ai/customize/skills/yours に追加される
「追加したマーケットプレイスから」にdotfilesにあるスキルが追加されます。

参考: Skills overview
7. https://claude.ai/code のクラウドセッションから使う
Warning
1回目のチャットではセッションはまだ開始されていないので、2回目のチャットから、/での明示的なスキルの指定が可能になります。

明示的に指定したい場合は、「hello」などと打ってから使用可能になります。
プラグインのスキルは /dotfiles:grilling のように、プラグイン名が前に付いた名前で出てきます。

参考: Claude Code on the web、Skills
つまずいた点
- chezmoi のファイル名がそのまま届く
claude.ai はリポジトリの中身をそのまま配るので、executable_start-server.shやliteral_run_eval.pyのような chezmoi の接頭辞付きの名前のまま届き、スキルが呼ぶスクリプトが見つからなくなりました。スキル配下では chezmoi の接頭辞を使わない名前にしました。 - 実行ビットが落ちる
プラグインは zip 経由で届くので、スクリプトの実行権限(chmod+x)が外れます。./scripts/x.sh のように直接実行すると Permission deniedになるため、スクリプトはbash scripts/x.shやuv run scripts/x.pyのように、インタプリタを付けて呼ぶ書き方にしました(公式のスキルも同じ書き方でした)。 - settings.json の設定は届かない
ローカルのsettings.jsonのskillOverridesで手動専用にしていたスキルが、Web では自動で呼ばれる状態になります。SKILL.md の frontmatter にdisable-model-invocation: trueと書けば、ローカルでも Web でも効きます。同じく、グローバルの CLAUDE.md とユーザー設定の hook も Web には届きません。
参考: Skills(Control who invokes a skill) - description に山括弧を書くと警告になる
<repo>のような山括弧は、claude.ai が取り除いて保存し、同期のたびに警告が出ます。{repo}のように書き換えました。 - push しても同期されないことがある
「自動的に同期」をオンにしていても、push だけでは再同期されないことがありました。「マーケットプレイスを管理」で「アップデートを確認」を押すと取り込まれます(1 回目は失敗することがあり、少し待って押し直すと通りました)。
参考: Plugins(Manage installed plugins) - ローカルの Claude Code にも同じプラグインが届く
claude.ai で有効にしたプラグインは、ローカルの Claude Code にもdotfiles@syncedとして読み込まれ、手元のスキルと二重 になってしまいます。ローカルのsettings.jsonのenabledPluginsで"dotfiles@synced": falseにして止めています。
参考: Plugin loading reference(Plugins synced from claude.ai)
おわりに
結果的にはシンプルな方法でしたが、クラウドセッション1回目のチャットでは表示されないことなどいろいろな罠に引っかかり苦労しました。
「クラウドでローカルのスキルが使えない」という言い訳がなくなり、クラウドセッションを積極的に活用しているのですが、チケット駆動開発との相性の良さで非常に良い体験になりました。
クラウドセッション、クラウド開発あたりの話題は自分のなかでまとまってきたら改めて記事にしたいと思います。
以上となります。
ここまでお読みいただきありがとうございました!
間違っている点などありましたら、お気軽にご指摘いただけますと嬉しいです。


