plugin-packager

RevTechStudio's avatarfrom RevTechStudio

生成したプラグインをZIP形式にまとめる。プラグインパッケージング時、配布準備時、またはユーザーがZIP作成、プラグイン配布、パッケージング、リリース準備に言及した際に使用する。

⭐0stars🔀0forks📁View on GitHub🕐Updated Nov 18, 2025
[Prompt Templates and Packaging]

When & Why to Use This Skill

The Plugin Packager is a specialized Claude skill designed to automate the bundling of AI agent plugins into distribution-ready ZIP files. It streamlines the release process by handling file collection, integrity verification, and the generation of essential metadata such as package.json and VERSION files, ensuring that AI agents and skills are professionally packaged and ready for deployment.

Use Cases

  • Preparing a Claude agent plugin for public distribution or sharing with team members by creating a standardized ZIP package.
  • Automating the creation of versioned release packages that include auto-generated manifests and metadata for consistent version control.
  • Validating the completeness and integrity of plugin files (README, SKILL.md, etc.) before packaging to prevent broken or incomplete releases.
  • Standardizing the directory structure and documentation for complex agent projects to ensure they meet distribution requirements.
nameplugin-packager
description生成したプラグインをZIP形式にまとめる。プラグインパッケージング時、配布準備時、またはユーザーがZIP作成、プラグイン配布、パッケージング、リリース準備に言及した際に使用する。

Plugin Packager

概要

このSkillは、生成したプラグインをZIP形式にパッケージングする。プラグインのファイルを収集し、必要なメタデータを生成して、配布可能なZIPファイルを作成する。

責任範囲

このSkillは以下の範囲をカバーする:

  • パッケージング対象ファイルの収集
  • ファイルの完全性検証
  • メタデータファイルの生成（package.json、VERSION）
  • ZIPファイルの作成
  • パッケージの出力とメタデータの記録
  • 配布用ドキュメントの準備

ワークフロー

フェーズ1: ファイル収集

パッケージングするファイルを収集し、リストを作成する。

実施内容:

  1. プラグインディレクトリを確認する
  2. パッケージング対象のファイルを特定する
  3. 除外ファイルを確認する（.claudeignore）
  4. ファイルリストを作成する
  5. ファイルサイズを集計する

収集対象:

  • README.md（必須）
  • agents/[agent-name].md
  • skills/[skill-name]/SKILL.md
  • commands/[command-name].md
  • LICENSE（オプション）
  • CHANGELOG.md（オプション）

除外対象:

  • .git/
  • node_modules/
  • .DS_Store
  • *.tmp
  • .claudeignore に記載されたファイル

良い例:

【ファイル収集結果】

プラグイン名: database-design-plugin
プラグインディレクトリ: D:\projects\database-design-plugin

収集対象ファイル（11個）:
- README.md
- agents/database-design-agent.md
- skills/entity-definition-collector/SKILL.md
- skills/normalization-processor/SKILL.md
- skills/er-diagram-generator/SKILL.md
- skills/table-definition-writer/SKILL.md
- skills/ddl-script-generator/SKILL.md
- skills/database-naming-conventions/SKILL.md
- skills/normalization-rules/SKILL.md
- commands/design-database.md
- commands/generate-schema.md

除外ファイル:
- .git/（Gitディレクトリ）
- .DS_Store（システムファイル）

合計サイズ: 125 KB

悪い例:

【ファイル収集結果】

何かファイルを集めた

フェーズ2: 検証

収集したファイルの完全性を検証する。

実施内容:

  1. 必須ファイルの存在を確認する
  2. ファイル形式の正当性を確認する
  3. フロントマター情報を検証する
  4. ファイル内容の完全性を確認する
  5. 検証結果をレポートする

検証項目:

  • README.md が存在するか
  • 全ての AGENT.md, SKILL.md, COMMAND.md が正しく読み込めるか
  • フロントマター情報が正しくパースできるか
  • 必須フィールド（name, description）が存在するか
  • ファイル内容が破損していないか

良い例:

【検証結果】

必須ファイル: ✓ OK
- ✓ README.md が存在する

ファイル形式: ✓ OK
- ✓ 全てのファイルが正しく読み込める（11個）

フロントマター: ✓ OK
- ✓ 全てのフロントマターが正しくパースできる（10個）
- ✓ 必須フィールド（name, description）が全て存在する

ファイル内容: ✓ OK
- ✓ 全てのファイルが破損していない

検証: 合格

悪い例（問題がある場合）:

【検証結果】

必須ファイル: ✗ NG
- ✗ README.md が存在しない

ファイル形式: ✗ NG
- ✗ entity-definition-collector/SKILL.md が読み込めない

フロントマター: ✗ NG
- ✗ normalization-processor/SKILL.md でフロントマターがパースできない

検証: 不合格（3個の問題）

フェーズ3: メタデータ生成

パッケージに必要なメタデータファイルを生成する。

実施内容:

  1. package.json を生成する
  2. VERSION ファイルを生成する
  3. MANIFEST.md を生成する（ファイルリスト）
  4. ハッシュ値を計算する（整合性確認用）
  5. メタデータの妥当性を確認する

生成するメタデータ:

  • package.json: プラグインのメタ情報（名前、バージョン、説明、作者など）
  • VERSION: バージョン番号
  • MANIFEST.md: 含まれるファイルのリスト
  • CHECKSUM.txt: ファイルのハッシュ値（オプション）

良い例:

【メタデータ生成結果】

package.json:
{
  "name": "database-design-plugin",
  "version": "1.0.0",
  "description": "データベース設計を支援するプラグイン",
  "author": "Your Name",
  "created": "2025-11-15",
  "agents": ["database-design-agent"],
  "skills": [
    "entity-definition-collector",
    "normalization-processor",
    "er-diagram-generator",
    "table-definition-writer",
    "ddl-script-generator",
    "database-naming-conventions",
    "normalization-rules"
  ],
  "commands": ["design-database", "generate-schema"]
}

VERSION:
1.0.0

MANIFEST.md:
# Manifest

このパッケージには以下のファイルが含まれています:

## プラグイン情報
- package.json
- VERSION
- MANIFEST.md
- README.md

## エージェント
- agents/database-design-agent.md

## スキル
- skills/entity-definition-collector/SKILL.md
- skills/normalization-processor/SKILL.md
- skills/er-diagram-generator/SKILL.md
- skills/table-definition-writer/SKILL.md
- skills/ddl-script-generator/SKILL.md
- skills/database-naming-conventions/SKILL.md
- skills/normalization-rules/SKILL.md

## コマンド
- commands/design-database.md
- commands/generate-schema.md

合計: 14ファイル

メタデータ生成: 完了

悪い例:

【メタデータ生成結果】

何か作った

フェーズ4: パッケージング

収集したファイルとメタデータをZIP形式にまとめる。

実施内容:

  1. ZIPファイル名を決定する
  2. ファイルをZIPに追加する
  3. ディレクトリ構造を保持する
  4. 圧縮レベルを設定する
  5. ZIP作成を実行する

パッケージング設定:

  • ファイル名形式: {plugin-name}-v{version}.zip
  • 圧縮レベル: 標準（balance between size and speed）
  • ディレクトリ構造: 保持する
  • ルートディレクトリ: プラグイン名のディレクトリを作成

良い例:

【パッケージング結果】

ZIPファイル名: database-design-plugin-v1.0.0.zip

ディレクトリ構造:
database-design-plugin/
  package.json
  VERSION
  MANIFEST.md
  README.md
  agents/
    database-design-agent.md
  skills/
    entity-definition-collector/
      SKILL.md
    normalization-processor/
      SKILL.md
    er-diagram-generator/
      SKILL.md
    table-definition-writer/
      SKILL.md
    ddl-script-generator/
      SKILL.md
    database-naming-conventions/
      SKILL.md
    normalization-rules/
      SKILL.md
  commands/
    design-database.md
    generate-schema.md

ファイル数: 14個
圧縮前サイズ: 125 KB
圧縮後サイズ: 35 KB
圧縮率: 72%

パッケージング: 完了

悪い例:

【パッケージング結果】

ZIPを作った

フェーズ5: 出力

作成したパッケージを出力し、メタデータを記録する。

実施内容:

  1. 出力先ディレクトリを確認する
  2. ZIPファイルを出力する
  3. パッケージ情報を記録する
  4. 配布用ドキュメントを準備する
  5. 次のステップを案内する

出力先:

  • デフォルト: {plugin-directory}/dist/
  • カスタム: ユーザー指定のディレクトリ

良い例:

【出力結果】

出力先: D:\projects\database-design-plugin\dist\
ZIPファイル: database-design-plugin-v1.0.0.zip
ZIPファイルパス: D:\projects\database-design-plugin\dist\database-design-plugin-v1.0.0.zip

パッケージ情報:
- プラグイン名: database-design-plugin
- バージョン: 1.0.0
- 作成日時: 2025-11-15 10:30:00
- ファイル数: 14個
- 圧縮後サイズ: 35 KB
- ハッシュ値（SHA-256）: a1b2c3d4e5f6...

配布用ドキュメント:
- README.md（プラグインの概要、インストール方法、使い方）
- CHANGELOG.md（変更履歴）
- LICENSE（ライセンス情報）

【配布方法】

1. GitHub リリースとして配布
   - ZIPファイルをアップロード
   - リリースノートを作成

2. 手動配布
   - ZIPファイルを共有
   - README.md を参照してもらう

【次のステップ】

1. パッケージを配布する
2. ユーザーにインストール方法を案内する
3. フィードバックを収集する

パッケージング完了: ✓

良い例:

出力結果が明確で、パッケージ情報、配布方法、次のステップが案内されている。

悪い例:

【出力結果】

ZIPを作った

アウトプット

このスキルは以下を生成する:

  • ZIPファイル: プラグイン全体をまとめたZIPファイル
  • メタデータファイル: package.json, VERSION, MANIFEST.md
  • パッケージ情報レポート: パッケージの詳細情報（ファイル数、サイズ、ハッシュ値など）

想定されるエラーと対処法

エラー1: 必須ファイルが存在しない

検出例:

README.md が存在しない

対処法:

  • README.md を作成する
  • プラグインの概要、使い方、コマンド一覧を記述する
  • パッケージングを再実行する

エラー2: ファイルが破損している

検出例:

entity-definition-collector/SKILL.md が読み込めない

対処法:

  • ファイルの内容を確認する
  • ファイルを再生成する
  • パッケージングを再実行する

エラー3: メタデータ生成に失敗

検出例:

package.json の生成に失敗した

対処法:

  • プラグイン名、バージョン、説明が正しいか確認する
  • メタデータ生成の設定を確認する
  • 再度メタデータ生成を実行する

ベストプラクティス

  • パッケージング前にプラグインを検証する（plugin-validator スキルを使用）
  • メタデータファイルを必ず含める（package.json, VERSION, MANIFEST.md）
  • README.md を詳細に記述する（インストール方法、使い方）
  • CHANGELOG.md を作成する（変更履歴を記録）
  • LICENSE ファイルを含める（ライセンス情報）
  • ハッシュ値を記録する（整合性確認用）
  • 配布用ドキュメントを準備する

チェックリスト

ファイル収集完了時

  • プラグインディレクトリが確認されている
  • パッケージング対象のファイルが特定されている
  • 除外ファイルが確認されている
  • ファイルリストが作成されている
  • ファイルサイズが集計されている

検証完了時

  • 必須ファイルの存在が確認されている
  • ファイル形式の正当性が確認されている
  • フロントマター情報が検証されている
  • ファイル内容の完全性が確認されている
  • 検証結果がレポートされている

メタデータ生成完了時

  • package.json が生成されている
  • VERSION ファイルが生成されている
  • MANIFEST.md が生成されている
  • ハッシュ値が計算されている（オプション）
  • メタデータの妥当性が確認されている

パッケージング完了時

  • ZIPファイル名が決定されている
  • ファイルがZIPに追加されている
  • ディレクトリ構造が保持されている
  • 圧縮レベルが設定されている
  • ZIP作成が実行されている

出力完了時

  • 出力先ディレクトリが確認されている
  • ZIPファイルが出力されている
  • パッケージ情報が記録されている
  • 配布用ドキュメントが準備されている
  • 次のステップが案内されている
  • ユーザーの承認を得ている

最終確認

  • ZIPファイルが作成されている
  • メタデータファイルが生成されている
  • パッケージ情報レポートが作成されている
  • すべてのアウトプットが明確で理解しやすい
  • ユーザーがパッケージを配布できる状態になっている