初出: Zenn

Note

人間が書きました。

はじめに

Claude Code on the Web 使ってますか?

@mattpocockuk の X の投稿

有名スキル grill-me の作者 Matt氏がローカル開発を離れてクラウド開発に移行しつつあるというツイートくらいのタイミングから「クラウド開発」「クラウドエージェント」の話題をよく聞くようになりました。

私も使いたいなーと思いつつ、「ローカルのスキルが使えない」 を言い訳に少し躊躇していましたが、今回の設定をしたことで、かなり積極的にクラウド開発を開発フローに組み込むことができるようになりました!(この話は別記事で)

色々と試行錯誤をしましたが、設定方法はこれ以外にもいくつかの方法がありそうでしたので一例として共有いたします。

できるようになること

Claude Code on the Web でローカルのスキルがすべて使えるようになります。
/favori と打つと dotfiles: で始まるスキルが候補に並ぶ Claude Code on the web の入力欄

ちなみに、Claude Webアプリ やスマホアプリなど(普通のチャットの方)からもローカルのスキルが使えるようになります!
Claude の Web アプリで /slide と打つと、Dotfiles プラグインのスキルが候補に出る

前提

ローカルの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/
 │   └── ...
 └── ...
.claude-plugin/marketplace.json
{
  "name": "yasu-dotfiles",
  "owner": { "name": "yasu-888" },
  "plugins": [
    { "name": "dotfiles", "source": "./home/dot_agents" }
  ]
}
home/dot_agents/.claude-plugin/plugin.json
{
  "name": "dotfiles"
}

参考: Create a marketplace、Marketplace reference、Plugins reference

2. https://claude.ai/customize/plugins にアクセス

claude.ai のカスタマイズ画面のプラグインのタブ

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

追加メニューの「マーケットプレイスを追加」

4. リポジトリから追加

マーケットプレイスを追加するダイアログの「リポジトリから追加」
参考: Plugins(Find and add a plugin)

5. dotfilesを選択して、同期

Warning

クラウドセッションでdotfilesリポジトリを接続済みである必要があります。
プライベートリポジトリでは既定ブランチ(main)しか同期できませんでした(ブランチを指定する書き方は受け付けられませんでした)。

リポジトリの URL に dotfiles を指定し、自動的に同期をオンにして同期する
参考: Plugins(Find and add a plugin)、Plugin feature support across platforms

6. https://claude.ai/customize/skills/yours に追加される

「追加したマーケットプレイスから」にdotfilesにあるスキルが追加されます。
Skills のタブの「追加したマーケットプレイスから」に dotfiles のスキルが並ぶ
参考: Skills overview

7. https://claude.ai/code のクラウドセッションから使う

Warning

1回目のチャットではセッションはまだ開始されていないので、2回目のチャットから、/での明示的なスキルの指定が可能になります。

1 回目のチャットの前は、/ の候補に組み込みのコマンドしか出ない

明示的に指定したい場合は、「hello」などと打ってから使用可能になります。
プラグインのスキルは /dotfiles:grilling のように、プラグイン名が前に付いた名前で出てきます。
hello と送った後は、/grill- と打つと dotfiles のスキルが候補に出る
参考: 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回目のチャットでは表示されないことなどいろいろな罠に引っかかり苦労しました。

「クラウドでローカルのスキルが使えない」という言い訳がなくなり、クラウドセッションを積極的に活用しているのですが、チケット駆動開発との相性の良さで非常に良い体験になりました。

クラウドセッション、クラウド開発あたりの話題は自分のなかでまとまってきたら改めて記事にしたいと思います。

以上となります。
ここまでお読みいただきありがとうございました!
間違っている点などありましたら、お気軽にご指摘いただけますと嬉しいです。

参考