From 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.
npx claudepluginhub sean-sunagaku/claude-code-plugin --plugin marketplace-validateThis skill uses the workspace's default tool permissions.
claude-code-plugin リポジトリの構造を検証し、エラーを自動修正する。
Guides creating and managing Claude Code plugin marketplaces. Validates marketplace.json schema, configures plugin entries, and troubleshoots repository setups.
Guides creating, validating, and managing Claude Code plugin marketplaces including marketplace.json schema, plugin entries, and best practices for setup and distribution.
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.
Share bugs, ideas, or general feedback.
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[] エントリに不正キーがないか | 各プラグイン |
claude plugin validate .
Validation passed になることを確認。失敗したら出力のエラー内容を修正する。
bash $PLUGIN_REPO/.github/scripts/validate-marketplace.sh
出力の ERROR: と WARN: を確認する。
エラーがあれば fix スクリプトを実行:
# dry-run で修正内容を確認
bash scripts/fix-marketplace.sh --dry-run
# 実際に修正
bash scripts/fix-marketplace.sh
fix スクリプトが自動修正するもの:
~/.claude/skills/<name>/ にあればコピー、なければ marketplace.json から生成修正後に再度バリデーションを実行し、全て PASSED になることを確認:
claude plugin validate .
bash $PLUGIN_REPO/.github/scripts/validate-marketplace.sh
修正ファイルを確認してコミット。
fix スクリプトで自動修正できないもの:
| 問題 | 対応 |
|---|---|
| SKILL.md の frontmatter に name/description がない | SKILL.md を直接編集 |
| agents/*.md の frontmatter 不備 | 各エージェントファイルを直接編集 |
| references/ の未参照ファイル | SKILL.md に参照を追加するか、不要なら削除 |
| unregistered skills | marketplace.json に登録するか、不要なら削除 |
skill-publisher でスキルを配置した後は、必ずこのスキルで検証する:
# publish 後
claude plugin validate .
bash scripts/fix-marketplace.sh --dry-run
bash $PLUGIN_REPO/.github/scripts/validate-marketplace.sh