Skip to content
cccskills
FreePublished on GitHub

marketplace-validate

[Internal] claude-code-plugin リポジトリの marketplace 構造を検証し、 エラーを自動修正するスキル。

CI バリデーション (validate-marketplace.sh) と 同等のチェックをローカルで実行し、missing plugin.json、未登録スキル、 frontmatter 不備、不正キーなどを検出・修正する。

Use when: marketplace を検証したい、CI が失敗した、バリデーションしたい、 プラグイン構造をチェックしたい、plugin.json がない、publish 後の確認。

Triggers: "validate", "バリデーション", "検証", "CI失敗", "CI fix", "marketplace check", "構造チェック", "plugin.json missing", "CI エラー"

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md4.6 KB
  • scripts/fix-marketplace.sh6.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Marketplace Validate

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

対象リポジトリ

PLUGIN_REPO=/Users/babashunsuke/Repository/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] プレフィックスを付けることで行う(専用フィールドは使わない)。

チェック項目

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

ワークフロー

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 skillsmarketplace.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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

This skill should be used when the user asks to "create a team", "spawn agents", "parallel execution", "delegate tasks to agents", "use a swarm", "team workflow", "split work across agents", "run tasks in parallel", or mentions wanting multiple agents to collaborate on a complex task.

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

Agent Teams スキルを設計・構築するためのベストプラクティスガイド。 サブエージェント定義、SendMessage 通信プロトコル、タスク依存管理、 PostToolUse Hook によるログ、MCP ツール統合、コンテキストファイル設計を網羅。 7つの実績あるチームスキル(app-naming, ui-review, logo-design, persona-creation, skill-creator-team, ui-variations, aso-optimize)から抽出したパターン集。 Use when: Agent Teams を使ったスキルを新規作成したい、 既存のチームスキルの品質を改善したい、エージェント間通信のデバッグ、 チームスキルの設計パターンを知りたい。 Triggers: "agent team", "チームスキル", "エージェントチーム", "サブエージェント定義", "SendMessage パターン", "チーム設計", "エージェント間通信", "team skill", "swarm pattern"

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

アプリ名・サービス名の命名を、5つの専門エージェントチームで多角的に評価・決定するスキル。 ブランディング、商標/法的リスク、デジタルプレゼンス(SEO/ASO/SNS)、国際展開(多言語/発音)の 4観点から候補を提案・調査・議論し、コンテキストファイルと議事録で次回セッションへ引き継ぐ。 Use when: アプリ名を決めたい、サービス名を変更したい、プロダクト名を検討したい、 ネーミングブレスト、名前の商標チェック、アプリ名のリネーム。 Triggers: "アプリ名", "サービス名", "プロダクト名", "ネーミング", "名前を決め", "リネーム", "rename", "app name", "naming", "ブランド名", "商標チェック"

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

App Store プレビュー動画を Remotion (React) で生成する Agent Team スキル。 video-director が構成を設計し、script-writer がナレーション台本を作成し、 motion-designer が Remotion コードを実装し、preview-reviewer がコードレビューし、 frame-inspector がレンダリング結果を目視検証する。 Use when: App Store プレビュー動画を作りたい、アプリのプロモーション動画を作りたい、 Remotion で動画を生成したい。 Triggers: "プレビュー動画", "App Store 動画", "アプリ動画", "preview movie", "Remotion", "動画作成", "app preview"

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

アプリのトーン&マナー(トンマナ)を8名のエージェントチームで設計するスキル。 ブランドアーキタイプ・パーソナリティ定義から、カラー・タイポグラフィ・ビジュアルスタイル・ トーン・オブ・ボイスまでを一貫設計し、Pencil (.pen) + Markdown で成果物を出力する。 「デザインテンション」(矛盾ペア)を核に、AIっぽくない独自のブランドアイデンティティを生成する。

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

仕様書・要件定義からソフトウェアアーキテクチャを設計するスキル。 5人の専門エージェント(Architecture Lead・Module Designer・Dependency Analyst・ Platform Expert・Devil's Advocate)が協議しながら、 モジュール分割・依存関係・データフロー・インターフェース設計を行う。 成果物は構造化されたアーキテクチャ設計書(Markdown)。 Use when: 仕様書からどう設計するか迷っている時、モジュール分割の方針を決めたい時、 技術スタックに合ったアーキテクチャパターンを選びたい時、 設計書を作成したい時。 Triggers: "アーキテクチャ設計", "arch design", "仕様書から設計", "モジュール分割", "設計書を作りたい", "アーキテクチャを考えて", "コンポーネント設計", "依存関係を設計", "どう設計する", "design the architecture", "design from spec"

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

See all skills by sean-sunagaku

Report a problem with this skill