# Sean Sunagaku Claude Code Plugin Marketplace Validate > Marketplace Validate - Skill: `tomevault-io/sean-sunagaku-claude-code-plugin-marketplace-validate` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/sean-sunagaku-claude-code-plugin-marketplace-validate` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/sean-sunagaku-claude-code-plugin-marketplace-validate/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/sean-sunagaku-claude-code-plugin-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 ディレクトリが存在 | `/skills//` | | 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 でスキーマ検証 ```bash claude plugin validate . ``` `Validation passed` になることを確認。失敗したら出力のエラー内容を修正する。 ### Step 2: 構造バリデーション実行 ```bash bash $PLUGIN_REPO/.github/scripts/validate-marketplace.sh ``` 出力の `ERROR:` と `WARN:` を確認する。 ### Step 3: 自動修正 エラーがあれば fix スクリプトを実行: ```bash # dry-run で修正内容を確認 bash scripts/fix-marketplace.sh --dry-run # 実際に修正 bash scripts/fix-marketplace.sh ``` fix スクリプトが自動修正するもの: - **missing plugin.json**: `~/.claude/skills//` にあればコピー、なければ marketplace.json から生成 - **plugin.json name 不一致**: marketplace.json の name に合わせて修正 - **version 不一致**: plugin.json の version を正として marketplace.json を更新 - **不正キーの削除**: スキーマで許可されていないキーを自動削除 - **orphaned entries**: ディレクトリが存在しない marketplace.json エントリを削除 - **unregistered skills**: ディスク上にあるが未登録のスキルを報告（手動対応） ### Step 4: 再バリデーション 修正後に再度バリデーションを実行し、全て PASSED になることを確認: ```bash 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` でスキルを配置した後は、必ずこのスキルで検証する: ```bash # publish 後 claude plugin validate . bash scripts/fix-marketplace.sh --dry-run bash $PLUGIN_REPO/.github/scripts/validate-marketplace.sh ``` --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/sean-sunagaku) — claim your Tome and manage your conversions.