| name | Installing Plugins Manually |
| description | Manually install Claude Code plugin components when official plugin installation fails. Use when `/plugin install` succeeds but plugins don't load, when verifying plugin installation, or when user mentions plugin installation issues. |
| allowed-tools | Read, Bash, Edit, Write |
Installing Plugins Manually
このSkillは、公式の/plugin installコマンドが失敗した場合に、プラグインのコンポーネント（Sub-agents、Commands、Skills）を手動で抽出・インストールする方法を提供します。
いつ使うか
以下の状況で使用してください：
/plugin installが成功メッセージを表示するが、実際にプラグインがロードされない~/.claude/plugins/config.jsonが空のまま（repositories: {}）- プラグインが正しくインストールされているか検証したい
- ユーザーがプラグインのインストール問題について言及している
診断フロー
ステップ1: インストール状況の確認
まず、プラグインが実際にインストールされているか確認します：
cat ~/.claude/plugins/config.json
ls -la ~/.claude/plugins/repos/
判定基準:
config.jsonが{"repositories": {}}の場合 → インストール失敗repos/ディレクトリが空の場合 → インストール失敗
ステップ2: マーケットプレイスの確認
マーケットプレイスが正しく追加されているか確認します：
cat ~/.claude/plugins/known_marketplaces.json
ls -la ~/.claude/plugins/marketplaces/
ステップ3: プラグインの構造を解析
対象プラグインの構造を確認します：
ls -la ~/.claude/plugins/marketplaces/[marketplace-name]/plugins/[plugin-name]/
ls -la ~/.claude/plugins/marketplaces/[marketplace-name]/plugins/[plugin-name]/agents/
ls -la ~/.claude/plugins/marketplaces/[marketplace-name]/plugins/[plugin-name]/commands/
ls -la ~/.claude/plugins/marketplaces/[marketplace-name]/plugins/[plugin-name]/skills/
手動インストール手順
プラグインのインストールが失敗した場合、以下の手順で手動インストールを実行します。
ステップ1: コンポーネントの特定
マーケットプレイスのmarketplace.jsonを確認して、プラグインに含まれるコンポーネントを特定します：
grep -A 30 '"name": "[plugin-name]"' ~/.claude/plugins/marketplaces/[marketplace-name]/.claude-plugin/marketplace.json
ステップ2: Sub-agentsのコピー
cp ~/.claude/plugins/marketplaces/[marketplace-name]/plugins/[plugin-name]/agents/*.md ~/.claude/agents/
確認:
ls -la ~/.claude/agents/ | grep [agent-name]
ステップ3: Commandsのコピー
cp ~/.claude/plugins/marketplaces/[marketplace-name]/plugins/[plugin-name]/commands/*.md ~/.claude/commands/
確認:
ls -la ~/.claude/commands/ | grep [command-name]
ステップ4: Skillsのコピー
cp -r ~/.claude/plugins/marketplaces/[marketplace-name]/plugins/[plugin-name]/skills/* ~/.claude/skills/
確認:
ls -la ~/.claude/skills/ | grep [skill-name]
ステップ5: インストールの検証
すべてのコンポーネントが正しくコピーされたか確認します：
ls -la ~/.claude/agents/[agent-name].md
ls -la ~/.claude/commands/[command-name].md
ls -la ~/.claude/skills/[skill-name]/
実例: javascript-typescript プラグイン
以下はclaude-code-workflowsマーケットプレイスからjavascript-typescriptプラグインを手動インストールする実例です。
コンポーネントの確認
ls -la ~/.claude/plugins/marketplaces/claude-code-workflows/plugins/javascript-typescript/
手動インストールの実行
cp ~/.claude/plugins/marketplaces/claude-code-workflows/plugins/javascript-typescript/agents/javascript-pro.md ~/.claude/agents/
cp ~/.claude/plugins/marketplaces/claude-code-workflows/plugins/javascript-typescript/agents/typescript-pro.md ~/.claude/agents/
cp ~/.claude/plugins/marketplaces/claude-code-workflows/plugins/javascript-typescript/commands/typescript-scaffold.md ~/.claude/commands/
cp -r ~/.claude/plugins/marketplaces/claude-code-workflows/plugins/javascript-typescript/skills/* ~/.claude/skills/
検証
ls -la ~/.claude/agents/ | grep -E "(javascript|typescript)"
ls -la ~/.claude/commands/ | grep typescript
ls -la ~/.claude/skills/ | grep -E "(javascript|typescript|nodejs)"
期待される出力:
javascript-pro.md
typescript-pro.md
typescript-scaffold.md
javascript-testing-patterns/
modern-javascript-patterns/
nodejs-backend-patterns/
typescript-advanced-types/
よくある問題と対処法
問題1: .claude-plugin/plugin.jsonが存在しない
一部のマーケットプレイス（特にclaude-code-workflows）では、個別のプラグインに.claude-plugin/plugin.jsonが存在せず、マーケットプレイスのmarketplace.jsonで一括管理しています。
対処法: 手動インストールを使用してください。プラグインシステムを経由せず、直接コンポーネントをコピーします。
問題2: インストール成功メッセージが出るが実際にはインストールされない
/plugin installが✓ Installedと表示しても、config.jsonが空のままの場合があります。
対処法:
- 診断フローで実際のインストール状況を確認
- 失敗している場合は手動インストールに切り替え
問題3: コピー後もClaude Codeが認識しない
コンポーネントをコピーしても認識されない場合があります。
対処法:
- Claude Codeを再起動
/helpでコマンドが表示されるか確認/agentsでエージェントが表示されるか確認
チェックリスト
手動インストール完了前に以下を確認：
プロジェクトローカルへのインストール
グローバルではなく、プロジェクトローカルにインストールしたい場合：
mkdir -p .claude/agents .claude/commands .claude/skills
cp [source]/agents/*.md .claude/agents/
cp [source]/commands/*.md .claude/commands/
cp -r [source]/skills/* .claude/skills/
注意事項
ライセンスと著作権
マーケットプレイスからプラグインをコピーする際は、各プラグインのライセンスを確認してください。ほとんどのプラグインはMITライセンスですが、商用利用の制限がある場合があります。
更新管理
手動インストールしたコンポーネントは、マーケットプレイスの更新を自動で取得できません。定期的にマーケットプレイスを確認し、必要に応じて手動で更新してください。
cd ~/.claude/plugins/marketplaces/[marketplace-name]
git pull
自動化スクリプト
手動コピーが面倒な場合は、自動化スクリプトを使用できます：
~/.claude/skills/plugin-fallback-installer/scripts/install-plugin-manually.sh [marketplace] [plugin]
~/.claude/skills/plugin-fallback-installer/scripts/install-plugin-manually.sh claude-code-workflows javascript-typescript
~/.claude/skills/plugin-fallback-installer/scripts/install-plugin-manually.sh claude-code-workflows javascript-typescript --local
~/.claude/skills/plugin-fallback-installer/scripts/install-plugin-manually.sh claude-code-workflows javascript-typescript --dry-run
このスクリプトは以下を自動的に実行します：
- プラグインの構造を解析
- すべてのコンポーネントをコピー
- インストール結果をサマリー表示
さらに詳しい情報
より多くの実例
様々なマーケットプレイスとプラグインタイプの実例は examples.md を参照してください。
チェックリストテンプレート
手動インストールを追跡するためのチェックリストは templates/plugin-install-checklist.md を参照してください。
まとめ
公式のプラグインシステムが失敗した場合でも、この手動インストール方法を使用することで、確実にプラグインの機能を利用できます。
主なメリット:
- 確実にコンポーネントがインストールされる
- プラグインシステムのバグを回避できる
- 必要なコンポーネントだけを選択的にインストールできる
- 自動化スクリプトで効率化できる
注意点:
- 手動で更新管理が必要
- ライセンスの確認が必要
- 再起動が必須
