Skill

marketplace-validate

Validates and auto-fixes claude-code-plugin marketplace structure: JSON validity, skill dirs, frontmatter, plugin.json consistency, invalid keys, unregistered skills. Local CI equivalent.

Bash

GitHub Actions

code-quality

npx claudepluginhub sean-sunagaku/claude-code-plugin --plugin marketplace-validate

Tool Access

This skill uses the workspace's default tool permissions.

Preview

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

SKILL.md

Similar Skills

plugin-marketplace

Guides creating and managing Claude Code plugin marketplaces. Validates marketplace.json schema, configures plugin entries, and troubleshoots repository setups.

6 files

all-skills

plugin-marketplace

Guides creating, validating, and managing Claude Code plugin marketplaces including marketplace.json schema, plugin entries, and best practices for setup and distribution.

6 files5 tools

claude-code

plugin-development

Guides Claude Code plugin creation, structure (plugin.json, commands/agents/skills/hooks), installation (/plugin), marketplaces, team workflows, testing, debugging, and settings. Delegates to docs-management.

4 files4 tools

claude-ecosystem

Stats

Parent Repo Stars31

Parent Repo Forks0

Last CommitFeb 18, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

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