SkillAgentSearch skills...

marketplace-publishing

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

Install / Use

npx skills add Aaronontheweb/dotnet-skills --skill marketplace-publishing

Installs into whichever agent you are using.

About this skill
šŸ“„

SKILL.md

Installable skill definition

Quality Score

89/100

Category

Automation

Supported Platforms

Claude Code

Our assessment of marketplace-publishing

marketplace-publishing scores 89/100 on our quality scale, 1390th of 2,769 Automation skills we index.

Its SKILL.md is 5.8 KB long, well organised into 28 sections with 11 code examples: a solid amount of guidance for an agent.

With 1,183 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
20/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so marketplace-publishing is actively maintained.
  • Our last check on 2026-10-31 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

marketplace-publishing compared with similar skills

All 4 of these similar skills score higher than marketplace-publishing; compare them before choosing.

SkillScoreStarsUpdatedFormat
marketplace-publishing (this skill)by Aaronontheweb891.2k2mo agoSKILL.md
Agent-Reachby Panniantong100112.7k9d agoCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.9k8d agoCLAUDE.md
Scraplingby D4Vinci100103.9ktodayMCP Server

Frequently asked questions

How do I install marketplace-publishing?
Run npx skills add Aaronontheweb/dotnet-skills --skill marketplace-publishing. The install tabs above show the steps for each supported agent.
Which AI agents does marketplace-publishing work with?
It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
Is marketplace-publishing safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is marketplace-publishing still maintained?
The repository was last updated about 2 months ago, so marketplace-publishing is actively maintained.

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

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]

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:

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

Step 5: Validate

Run the validation script:

./scripts/validate-marketplace.sh

Step 6: Commit Together

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

Adding a New Agent

Step 1: Create the Agent File

Create a markdown file in /agents/:

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

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:

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

Step 3: Commit Together

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

Publishing a Release

Versioning

Update the version in .claude-plugin/plugin.json:

{
  "version": "1.1.0"
}

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

    ./scripts/validate-marketplace.sh
    
  3. Commit version bump

    git add .claude-plugin/plugin.json
    git commit -m "Bump version to 1.1.0"
    
  4. Create and push tag

    git tag v1.1.0
    git push origin master --tags
    
  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):

# 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

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

Related Skills

View on GitHub
GitHub Stars1.2k
CategoryAutomation
Updated2mo ago
Forks109

Languages

Shell

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions
marketplace-publishing — Claude Code Skill: Install & Safety Check | SkillAgent