Marketplace Publishing

This walks you through the complete publishing workflow for the dotnet-skills marketplace on Claude Code. It covers the folder structure (skills go in category folders like akka/ or aspire/, agents in /agents/), how to write the SKILL.md frontmatter with name and description fields, registering everything in plugin.json, and the release process with semantic versioning and GitHub tags. The validation script catches common mistakes before you commit. What's useful here is seeing the actual mechanics of how marketplace content gets structured and deployed, especially the requirement that skills and their plugin.json registration stay in sync. If you're maintaining a Claude Code marketplace or want to understand how the publishing side works, this gives you the repeatable checklist.

skills.sh installs: 408
GitHub stars: 1.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add aaronontheweb/dotnet-skills --skill marketplace-publishing --agent claude-code

Installs into .claude/skills of the current project.

Files

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