📝 README: ローカル clone からの導入手順を marketplace 経由に直す

[rinjugatla]

概要

README のローカル導入手順（Installation → Claude Code の "Alternatively, clone the repository and install locally"）が現行の Claude Code CLI では通らないため修正します。

PS> claude plugins install .
Installing plugin "."...
✘ Failed to install plugin ".": Plugin "." not found in any configured marketplace

原因は claude plugin install の引数仕様です。

$ claude plugin --help
Usage: claude plugin|plugins [options] [command]
  install|i [options] <plugin>   Install a plugin from available marketplaces
                                 (use plugin@marketplace for specific marketplace)

• plugins は plugin の単なる別名で、複数形にしても挙動は変わりません。
• install の <plugin> はプラグイン名（または 名前@marketplace）で、登録済み marketplace の中から解決されます。パスは受け付けず、--path 相当の option もありません（claude plugin install --help で確認）。
• パスを受け取るのは marketplace add の側です（Add a marketplace from a URL, path, or GitHub repo）。

このため . は「. という名前のプラグイン」と解釈され、どの marketplace にも存在せず失敗します。Linux でも同一のエラーになるため、OS 依存ではなく手順そのものの誤りです。

この repo は plugin root と marketplace root を兼ねているので、clone を marketplace として登録してから plugin 名で install する 2 段階が正しい形になります。Codex 側の "Or clone and register locally" は既にこの形なので、それに揃えました。

変更内容

README.md の Installation → Claude Code のローカル導入手順を変更します。

変更前:

git clone https://github.com/u-ichi/reviewable-html-workbench.git
cd reviewable-html-workbench
claude plugins install .

変更後:

git clone https://github.com/u-ichi/reviewable-html-workbench.git
claude plugin marketplace add ./reviewable-html-workbench
claude plugin install reviewable-html-workbench@reviewable-html-workbench-local

• cd が不要になり、Codex 側の同等ブロックと同じ 3 行構成になります。
• install 時に marketplace 名が必要になるため、直前の説明文に「この repo は plugin root と marketplace root を兼ねること」と marketplace 名 reviewable-html-workbench-local を補いました。これも Codex 側の記述に合わせています。

README 以外に claude plugins install を案内している箇所は無いことを確認済みです。なお claude plugins validate . は validate <path> がパスを取る仕様のため正しく、変更していません。

テスト計画

記載どおりの手順が通ること

親ディレクトリから README のコマンド列をそのまま実行し、marketplace 登録と install が通ることを Windows / Linux の両方で確認しました。

Windows 11:

✔ Successfully added marketplace
✔ Successfully installed plugin: reviewable-html-workbench (scope: user)

Linux（node:22-slim + claude 2.1.226）:

✔ Successfully added marketplace: reviewable-html-workbench-local
✔ Successfully installed plugin: reviewable-html-workbench@reviewable-html-workbench-local
  Version: 1.28.2   Status: ✔ enabled

いずれも ~/.claude/plugins/cache/.../skills/ に plan-preview / reviewable-design-doc / visual-html-renderer の 3 skill が実体として展開されることを確認しています。

パス表記の切り分け

marketplace add に渡すパスの表記を総当たりで確認しました。. 単体はソース種別の判定に当てはまらず弾かれるため、README では相対パスで repo ディレクトリ名まで書く形（= Codex 側と同じ形）にしています。

表記	結果
.	✘ Invalid marketplace source format. Try: owner/repo, https://..., or ./path
./	✔
./reviewable-html-workbench（採用）	✔
絶対パス	✔

自動テスト

README のみの変更のためコードへの影響はありませんが、念のため実行しています。

$ python -m unittest discover -s tests

失敗は .sh を直接 exec できない Windows 環境固有の既存のものだけで、本 PR とは無関係です（Linux 環境では発生しません）。

Checklist

• Tests pass
• Plugin validation passes

補足

version を bump していないことについて

AGENTS.md の規約では commit ごとに 4 ファイルの version を更新することになっていますが、本 PR ではあえて据え置きにしています。Windows で claude plugin install が ENOTDIR になる symlink 依存の修正 PR を並行して出しており、両方が version を上げると衝突するためです。bump の要否と値の判断は作者にお任せします。ご指示いただければこの PR 側で bump します。

並行 PR との関係

本 PR は README のみの修正で、コードには触れていません。ただし Windows でこの手順を最後まで通すには、もう一方の PR（symlink 依存の除去）も必要です。marketplace add までは成功しますが、続く install が ENOTDIR で失敗するためです。両者は独立して merge できますが、Windows ユーザー向けには両方揃って初めて「clone してローカル導入」が成立します。

---

🤖 このPRは Claude Code（Claude Opus 5）を使用して作成しました。