marketplace-validate

Marketplace Validate

claude-code-plugin リポジトリの構造を検証し、エラーを自動修正する。

対象リポジトリ

PLUGIN_REPO=/Users/babashunsuke/Desktop/claude-code-plugin
VALIDATE_SCRIPT=$PLUGIN_REPO/.github/scripts/validate-marketplace.sh
FIX_SCRIPT=scripts/fix-marketplace.sh

スキーマ制約（重要）

plugins[] エントリで許可されるキーは以下の 6 つのみ:

name, source, description, version, author, keywords

それ以外のキー（例: "status", "type" 等）を追加すると Claude Code がプラグインを読み込めなくなる。

Beta スキルの表現は description に [Beta] プレフィックスを付けることで行う（専用フィールドは使わない）。

チェック項目

#	チェック	対象
1	marketplace.json が valid JSON	.claude-plugin/marketplace.json
2	必須フィールド (name, version, description, owner)	marketplace.json トップレベル
3	各プラグインの skill ディレクトリが存在	<source>/skills/<name>/
4	SKILL.md が存在し frontmatter に name/description がある	各スキル
5	.claude-plugin/plugin.json が存在し name が一致	各スキル
6	agents/ の各 .md に name/description frontmatter がある	Agent Team 型スキル
7	references/ のファイルが SKILL.md から参照されている	各スキル
8	ディスク上に存在するが marketplace.json に未登録のスキル	全体
9	plugins[] エントリに不正キーがないか	各プラグイン

ワークフロー

Step 1: Claude Code CLI でスキーマ検証

claude plugin validate .

Validation passed になることを確認。失敗したら出力のエラー内容を修正する。

Step 2: 構造バリデーション実行

bash $PLUGIN_REPO/.github/scripts/validate-marketplace.sh

出力の ERROR: と WARN: を確認する。

Step 3: 自動修正

エラーがあれば fix スクリプトを実行:

# dry-run で修正内容を確認
bash scripts/fix-marketplace.sh --dry-run

# 実際に修正
bash scripts/fix-marketplace.sh

fix スクリプトが自動修正するもの:

• missing plugin.json: ~/.claude/skills/<name>/ にあればコピー、なければ marketplace.json から生成
• plugin.json name 不一致: marketplace.json の name に合わせて修正
• version 不一致: plugin.json の version を正として marketplace.json を更新
• 不正キーの削除: スキーマで許可されていないキーを自動削除
• orphaned entries: ディレクトリが存在しない marketplace.json エントリを削除
• unregistered skills: ディスク上にあるが未登録のスキルを報告（手動対応）

Step 4: 再バリデーション

修正後に再度バリデーションを実行し、全て PASSED になることを確認:

claude plugin validate .
bash $PLUGIN_REPO/.github/scripts/validate-marketplace.sh

Step 5: コミット

修正ファイルを確認してコミット。

手動修正が必要なケース

fix スクリプトで自動修正できないもの:

問題	対応
SKILL.md の frontmatter に name/description がない	SKILL.md を直接編集
agents/*.md の frontmatter 不備	各エージェントファイルを直接編集
references/ の未参照ファイル	SKILL.md に参照を追加するか、不要なら削除
unregistered skills	marketplace.json に登録するか、不要なら削除

publish-skill.sh 実行後の推奨

skill-publisher でスキルを配置した後は、必ずこのスキルで検証する:

# publish 後
claude plugin validate .
bash scripts/fix-marketplace.sh --dry-run
bash $PLUGIN_REPO/.github/scripts/validate-marketplace.sh