install-skill

スキルインストーラー

スキルマーケットプレイスプロジェクトへの新しいスキルのインストールを自動化します。展開、マーケットプレイスへの登録、ドキュメントの更新を処理します。

使用するタイミング

• dist/ ディレクトリに .skill ファイルがある場合
• ユーザーがスキルの「インストール」「追加」「展開」「統合」を依頼した場合
• ユーザーがマーケットプレイスに新しいスキルを追加したい場合

インストールのワークフロー

フェーズ 1：検出

1. 利用可能なスキルパッケージを一覧表示します：

   ls -la dist/*.skill
   

2. 対象のスキルを特定します：ユーザーがスキル名を指定している場合は、そのスキルを使用します。指定していない場合は、利用可能なパッケージを一覧表示して、どれをインストールするか尋ねます。

3. パッケージを検証します：ファイルが存在し、有効な zip アーカイブであることを確認します：

   file dist/<skill-name>.skill
   

フェーズ 2：展開

1. 展開前に内容をプレビューします：

   unzip -l dist/<skill-name>.skill
   

2. プロジェクトのルートに展開します：

   unzip -o dist/<skill-name>.skill
   

3. 展開結果を確認します：

   ls -la <skill-name>/
   ls -la <skill-name>/references/
   

フェーズ 3：メタデータの抽出

1. SKILL.md のフロントマターを読み取り、以下を抽出します：

   • name：スキル識別子（ケバブケース）
   • description：トリガー用の詳細な説明
   • metadata.category：カテゴリ（seo、music、security、tooling など）
   • metadata.tags：カンマ区切りのタグ

2. SKILL.md の先頭にある --- マーカー間のフロントマターを解析します

3. マーケットプレイス用の短い説明を生成します（1 行、最大約 60 文字）

フェーズ 4：マーケットプレイスへの登録

1. .claude-plugin/marketplace.json を更新します：

   a. 必要に応じて、新しいカテゴリを含めるようトップレベルの description を更新します

   b. plugins 配列に追加します：

   {
     "name": "<skill-name>",
     "type": "skill",
     "path": "<skill-name>",
     "description": "<short-description>",
     "category": "<category>",
     "tags": ["tag1", "tag2", ...]
   }
   

   c. 新しいカテゴリの場合は、categories オブジェクトに追加します：

   "<category>": {
     "name": "<Category Display Name>",
     "description": "<Category description>",
     "marketplace": "marketplace-<category>.json"
   }
   

2. カテゴリ別マーケットプレイスを作成／更新します（marketplace-<category>.json）：

   ファイルが存在しない場合は、テンプレートを使って作成します：

   {
     "name": "skills-<category>",
     "version": "1.0.0",
     "description": "<Category> skills for Claude Code.",
     "author": "schwepps",
     "license": "MIT",
     "repository": {
       "type": "git",
       "url": "https://github.com/schwepps/skills.git"
     },
     "plugins": [
       { /* skill entry */ }
     ]
   }
   

   ファイルが存在する場合は、スキルを plugins 配列に追加します。

フェーズ 5：ドキュメントの更新

1. README.md を更新します：

   a. 新しいカテゴリを追加した場合は、ヘッダーの説明を更新します

   b. 「含まれるもの」テーブルに追加します：

   | **[<skill-name>](<skill-name>/)** | <short-description> |
   

   c. 新しいカテゴリの場合は、使用例のセクションを追加します：

   ### <Category>
   

   「プロンプトの例 1」 「プロンプトの例 2」

   d. 「プロジェクト構成」のツリーに追加します：

   ├── <skill-name>/
   

   e. 「ブラウザーからのダウンロード」テーブルに追加します：

   | <Skill Display Name> | [Download ZIP](https://download-directory.github.io/?url=https://github.com/schwepps/skills/tree/main/<skill-name>) |
   

フェーズ 6：検証

1. すべてのファイルが更新されていることを確認します：

   • スキルディレクトリが存在し、SKILL.md と references/ が含まれている
   • marketplace.json にスキルのエントリが含まれている
   • カテゴリ別のマーケットプレイスファイルが存在し、スキルが含まれている
   • README.md にスキルの情報が追加されている

2. 概要を報告します：

   Installed: <skill-name>
   Category: <category>
   Files: <count> reference files
   
   Updated:
   - .claude-plugin/marketplace.json
   - .claude-plugin/marketplace-<category>.json
   - README.md
   

カテゴリの対応関係

カテゴリ	表示名	説明
seo	SEO と AI 検索	検索エンジン最適化と AI 検索での可視性
music	音楽制作	AI を活用した音楽と音声の生成
security	スマートコントラクトセキュリティ	ブロックチェーンとスマートコントラクトの監査
tooling	開発者ツール	自動化と開発ユーティリティ

エラー処理

• ファイルが見つからない：dist/ 内の利用可能な .skill ファイルを一覧表示します
• 無効なパッケージ：ファイルが有効な zip アーカイブか確認します
• SKILL.md がない：パッケージの形式が正しくないため、インストールできません
• フロントマターがない：可能な情報を抽出し、不足しているメタデータをユーザーに尋ねます
• カテゴリの競合：カテゴリの割り当てをユーザーに確認します

クイックインストールコマンド

既知のスキルファイルを簡単にインストールする場合：

/install-skill <skill-name>

これにより、以下が実行されます：

1. dist/<skill-name>.skill を展開します
2. SKILL.md からメタデータを自動検出します
3. すべてのマーケットプレイスファイルに登録します
4. README.md を更新します
5. 完了状況を報告します