tomevault-io 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
Converted and distributed by TomeVault — claim your Tome and manage your conversions.