marketplace-publishing

マーケットプレイスへの公開ワークフロー

このスキルでは、dotnet-skills Claude Code マーケットプレイスにスキルとエージェントを公開する方法を説明します。

リポジトリの構成

dotnet-skills/
├── .claude-plugin/
│   ├── marketplace.json      # Marketplace catalog
│   └── plugin.json           # Plugin metadata + skill/agent registry
├── .github/workflows/
│   └── release.yml           # Release automation
├── skills/
│   ├── akka/                 # Akka.NET skills
│   │   ├── best-practices/SKILL.md
│   │   ├── testing-patterns/SKILL.md
│   │   └── ...
│   ├── aspire/               # .NET Aspire skills
│   ├── csharp/               # C# language skills
│   ├── testing/              # Testing framework skills
│   └── meta/                 # Meta skills
├── agents/
│   └── *.md                  # Agent definitions
└── scripts/
    └── validate-marketplace.sh

新しいスキルの追加

ステップ 1：カテゴリを選択する

スキルはドメイン別に整理されています。

カテゴリ	目的
akka/	Akka.NET のアクターパターン、テスト、クラスタリング
aspire/	.NET Aspire のオーケストレーション、テスト、構成
csharp/	C# の言語機能、コーディング規約
testing/	テストフレームワーク（xUnit、Playwright、Testcontainers）
meta/	このマーケットプレイスに関するメタスキル

該当するカテゴリがない場合は、新しいカテゴリフォルダーを作成してください。

ステップ 2：スキルフォルダーを作成する

フォルダーを作成し、その中に SKILL.md を配置します。

skills/<category>/<skill-name>/SKILL.md

例：skills/akka/cluster-sharding/SKILL.md

ステップ 3：SKILL.md を記述する

---
name: my-new-skill
description: Brief description of what this skill does and when to use it.
---

# My New Skill

## When to Use This Skill

Use this skill when:
- [List specific scenarios]

---

## Content

[Comprehensive guide with examples, patterns, and anti-patterns]

要件：

• name は小文字とハイフンで記述する必要があります（例：cluster-sharding）
• description は、Claude がこのスキルを使うべき場面を説明する 1～2 文にしてください
• トピックを網羅する内容を 10～40KB で記述してください
• 最新の C# パターンを用いた具体的なコード例を含めてください

ステップ 4：plugin.json に登録する

スキルのパスを .claude-plugin/plugin.json の skills 配列に追加します。

{
  "skills": [
    "./skills/akka/best-practices",
    "./skills/akka/cluster-sharding"  // Add new skill here
  ]
}

ステップ 5：検証する

検証スクリプトを実行します。

./scripts/validate-marketplace.sh

ステップ 6：まとめてコミットする

git add skills/akka/cluster-sharding/ .claude-plugin/plugin.json
git commit -m "Add cluster-sharding skill for Akka.NET Cluster Sharding patterns"

---

新しいエージェントの追加

ステップ 1：エージェントファイルを作成する

/agents/ に Markdown ファイルを作成します。

---
name: my-agent-name
description: Expert in [domain]. Specializes in [specific areas]. Use for [scenarios].
model: sonnet
color: blue
---

You are a [domain] specialist with deep expertise in [areas].

**Reference Materials:**
- [Official docs and resources]

**Core Expertise Areas:**
[List expertise areas]

**Diagnostic Approach:**
[How the agent analyzes problems]

要件：

• name は小文字とハイフンで記述する必要があります
• model は次のいずれかである必要があります：haiku、sonnet、opus
• color は任意です（UI 表示に使用されます）

ステップ 2：plugin.json に登録する

agents 配列に追加します。

{
  "agents": [
    "./agents/akka-net-specialist",
    "./agents/my-agent-name"  // Add new agent here
  ]
}

ステップ 3：まとめてコミットする

git add agents/my-agent-name.md .claude-plugin/plugin.json
git commit -m "Add my-agent-name agent for [domain] expertise"

---

リリースの公開

バージョン管理

.claude-plugin/plugin.json のバージョンを更新します。

{
  "version": "1.1.0"
}

セマンティックバージョニング（MAJOR.MINOR.PATCH）を使用します。

• MAJOR：互換性を損なう変更（スキルの名前変更／削除）
• MINOR：新しいスキルまたはエージェントの追加
• PATCH：既存コンテンツの修正または改善

リリース手順

1. plugin.json のバージョンを更新する

2. 検証する

   ./scripts/validate-marketplace.sh
   

3. バージョン更新をコミットする

   git add .claude-plugin/plugin.json
   git commit -m "Bump version to 1.1.0"
   

4. タグを作成してプッシュする

   git tag v1.1.0
   git push origin master --tags
   

5. GitHub Actions が自動的に次の処理を実行します：

   • マーケットプレイスの構成を検証する
   • 自動生成されたリリースノートを含む GitHub リリースを作成する

---

ユーザーによるインストール

ユーザーはプラグイン全体（すべてのスキルとエージェント）をインストールします。

# Add the marketplace (one-time)
/plugin marketplace add Aaronontheweb/dotnet-skills

# Install the plugin (gets everything)
/plugin install dotnet-skills

# Update to latest version
/plugin marketplace update

---

検証チェックリスト

コミットする前に確認してください。

• SKILL.md に name と description を含む有効な YAML フロントマターがある
• スキルフォルダーが適切なカテゴリの下にある
• パスが plugin.json の skills 配列に追加されている
• エージェントの場合：model が指定されている（haiku／sonnet／opus）
• ./scripts/validate-marketplace.sh が成功する

---

トラブルシューティング

インストール後にスキルが表示されない

• plugin.json のパスがフォルダー構成と一致していることを確認してください
• フォルダー内に SKILL.md があることを確認してください
• 再インストールを試してください：/plugin uninstall dotnet-skills && /plugin install dotnet-skills

検証エラー

• JSON が有効であることを確認してください：jq . .claude-plugin/plugin.json
• 配列内に末尾のカンマがないか確認してください
• 参照されているすべてのフォルダーに SKILL.md が含まれていることを確認してください

リリースが作成されない

• タグが semver 形式（v1.0.0）に従っていることを確認してください
• GitHub Actions のログでエラーを確認してください
• plugin.json のバージョンがタグと一致していることを確認してください