marketplace-publishing

Aaronontheweb/dotnet-skillsDeveloper ToolsAudit passedSnapshot 69127d962414

Installs: 0

Summary

Workflow for publishing skills and agents to the dotnet-skills Claude Code marketplace. Covers adding new content, updating plugin.json, validation, and release tagging.

SKILL.md

Marketplace Publishing Workflow

This skill documents how to publish skills and agents to the dotnet-skills Claude Code marketplace.

Repository Structure

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

Adding a New Skill

Step 1: Choose a Category

Skills are organized by domain:

Category	Purpose
`akka/`	Akka.NET actor patterns, testing, clustering
`aspire/`	.NET Aspire orchestration, testing, configuration
`csharp/`	C# language features, coding standards
`testing/`	Testing frameworks (xUnit, Playwright, Testcontainers)
`meta/`	Meta skills about this marketplace

Create a new category folder if none fits.

Step 2: Create the Skill Folder

Create a folder with SKILL.md inside:

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

Example: skills/akka/cluster-sharding/SKILL.md

Step 3: Write the 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]

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

./scripts/validate-marketplace.sh

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

---
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]

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

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

{
  "version": "1.1.0"
}

Update version in plugin.json
Validate
```
./scripts/validate-marketplace.sh
```

Commit version bump

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

Create and push tag

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

GitHub Actions will automatically:
- Validate the marketplace structure
- Create a GitHub release with auto-generated notes

# 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

marketplace-publishing

Summary

SKILL.md

Marketplace Publishing Workflow

Repository Structure

Adding a New Skill

Step 1: Choose a Category

Step 2: Create the Skill Folder

Step 3: Write the SKILL.md

Step 4: Register in plugin.json

Step 5: Validate

Step 6: Commit Together

Adding a New Agent

Step 1: Create the Agent File

Step 2: Register in plugin.json

Step 3: Commit Together

Publishing a Release

Versioning

Release Process

User Installation

Validation Checklist

Troubleshooting

Skill not appearing after install

Validation errors

Release not created

Related skills