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

Marketplace Publishing Workflow This skill documents how to publish skills and agents to the dotnet skills Claude Code marketplace. Repository Structure 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: Example: skills/akka/cluster sharding/SKILL.md Step 3: Write the SKILL.md Requirements: name must be lowercase with hyphens (e.g., cluster sharding ) description should be 1 2 sentences explaining when Claude should use this skill Content should be 10 40KB covering the topic comprehensively Include concrete code examples with modern C patterns Step 4: Register in plugin.json Add the skill path to .claude plugin/plugin.json in the skills array: Step 5: Validate Run the validation script: Step 6: Commit Together Adding a New Agent Step 1: Create the Agent File Create a markdown file in /agents/ : Requirements: name must be lowercase with hyphens model must be one of: haiku , sonnet , opus color is optional (used for UI display) Step 2: Register in plugin.json Add to the agents array: Step 3: Commit Together Publishing a Release Versioning Update the version in .claude plugin/plugin.json : Use semantic versioning ( MAJOR.MINOR.PATCH ): MAJOR : Breaking changes (renamed/removed skills) MINOR : New skills or agents added PATCH : Fixes or improvements to existing content Release Process 1. Update version in plugin.json 2. Validate 3. Commit version bump 4. Create and push tag 5. GitHub Actions will automatically: Validate the marketplace structure Create a GitHub release with auto generated notes User Installation Users install the complete plugin (all skills and agents): Validation Checklist Before committing: [ ] SKILL.md has valid YAML frontmatter with name and description [ ] Skill folder is under appropriate category [ ] Path added to plugin.json skills array [ ] For agents: model is specified (haiku/sonnet/opus) [ ] ./scripts/validate marketplace.sh passes Troubleshooting Skill not appearing after install Verify the path in plugin.json matches the folder structure Check that SKILL.md exists in the folder Try reinstalling: /plugin uninstall dotnet skills && /plugin install dotnet skills Validation errors Ensure JSON is valid: jq . .claude plugin/plugin.json Check for trailing commas in arrays Verify all referenced folders contain SKILL.md Release not created Ensure tag follows semver format ( v1.0.0 ) Check GitHub Actions logs for errors Verify plugin.json version matches the tag

marketplace-publishing