ReddRadar
Agent skill
Installing Plugins Manually
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.
Install this agent skill to your Project
npx add-skill https://github.com/camoneart/claude-code/tree/main/skills/plugin-fallback-installer
SKILL.md
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を確認して、プラグインに含まれるコンポーネントを特定します：
# marketplace.jsonから対象プラグインの定義を抽出
grep -A 30 '"name": "[plugin-name]"' ~/.claude/plugins/marketplaces/[marketplace-name]/.claude-plugin/marketplace.json
ステップ2: Sub-agentsのコピー
# 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のコピー
# 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/
# 出力例:
# agents/
# commands/
# skills/
手動インストールの実行
# Sub-agentsをコピー
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/
# Commandsをコピー
cp ~/.claude/plugins/marketplaces/claude-code-workflows/plugins/javascript-typescript/commands/typescript-scaffold.md ~/.claude/commands/
# Skillsをコピー
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でエージェントが表示されるか確認
チェックリスト
手動インストール完了前に以下を確認：
- マーケットプレイスが正しく追加されている
- プラグインの構造を確認した
- すべてのSub-agentsをコピーした
- すべてのCommandsをコピーした
- すべてのSkillsをコピーした
- コピーしたファイルの存在を確認した
- Claude Codeを再起動した
-
/helpでコマンドが表示されることを確認した
プロジェクトローカルへのインストール
グローバルではなく、プロジェクトローカルにインストールしたい場合：
# プロジェクトルートに.claude/ディレクトリを作成
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]
# 例: javascript-typescriptをインストール
~/.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 を参照してください。
まとめ
公式のプラグインシステムが失敗した場合でも、この手動インストール方法を使用することで、確実にプラグインの機能を利用できます。
主なメリット:
- 確実にコンポーネントがインストールされる
- プラグインシステムのバグを回避できる
- 必要なコンポーネントだけを選択的にインストールできる
- 自動化スクリプトで効率化できる
注意点:
- 手動で更新管理が必要
- ライセンスの確認が必要
- 再起動が必須
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
camoneart/claude-code
translating-technical-articles
Translates English technical articles (engineering blogs, documentation) to Japanese while preserving layout and structure. Use when the user asks to translate an article, convert English content to Japanese, or mentions translating a URL or technical blog post.
camoneart/claude-code
guiding-tdd-development
Guide Test-Driven Development with task splitting, Red-Green-Refactor cycle, and framework auto-detection. Use when developing features with TDD approach, fixing bugs test-first, or when user mentions "TDD", "テスト駆動開発", "test-first", "/tdd".
camoneart/claude-code
distributed-tracing
Implement distributed tracing with Jaeger and Tempo to track requests across microservices and identify performance bottlenecks. Use when debugging microservices, analyzing request flows, or implementing observability for distributed systems.
camoneart/claude-code
dependency-upgrade
Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing. Use when upgrading framework versions, updating major dependencies, or managing breaking changes in libraries.
camoneart/claude-code
stripe-integration
Implement Stripe payment processing for robust, PCI-compliant payment flows including checkout, subscriptions, and webhooks. Use when integrating Stripe payments, building subscription systems, or implementing secure checkout flows.
camoneart/claude-code
typescript-advanced-types
Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications. Use when implementing complex type logic, creating reusable type utilities, or ensuring compile-time type safety in TypeScript projects.
Didn't find tool you were looking for?