marketplace-publishing

Name: marketplace-publishing
Author: Aaronontheweb

307installs98forks

How to install marketplace-publishing?

aaronontheweb/dotnet-skills/marketplace-publishing

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

Installs into the current project.

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.

Files · 1

View on GitHub

SKILL.md

1	# Marketplace Publishing Workflow
2
3	This skill documents how to publish skills and agents to the dotnet-skills Claude Code marketplace.
4
5	## Repository Structure
6
7	```
8	dotnet-skills/
9	├── .claude-plugin/
10	│ ├── marketplace.json # Marketplace catalog
11	│ └── plugin.json # Plugin metadata + skill/agent registry
12	├── .github/workflows/
13	│ └── release.yml # Release automation
14	├── skills/
15	│ ├── akka/ # Akka.NET skills
16	│ │ ├── best-practices/SKILL.md
17	│ │ ├── testing-patterns/SKILL.md
18	│ │ └── ...
19	│ ├── aspire/ # .NET Aspire skills
20	│ ├── csharp/ # C# language skills
21	│ ├── testing/ # Testing framework skills
22	│ └── meta/ # Meta skills
23	├── agents/
24	│ └── *.md # Agent definitions
25	└── scripts/
26	└── validate-marketplace.sh
27	```
28
29	## Adding a New Skill
30
31	### Step 1: Choose a Category
32
33	Skills are organized by domain:
34
35	\| Category \| Purpose \|
36	\|----------\|---------\|
37	\| `akka/` \| Akka.NET actor patterns, testing, clustering \|
38	\| `aspire/` \| .NET Aspire orchestration, testing, configuration \|
39	\| `csharp/` \| C# language features, coding standards \|
40	\| `testing/` \| Testing frameworks (xUnit, Playwright, Testcontainers) \|
41	\| `meta/` \| Meta skills about this marketplace \|
42
43	Create a new category folder if none fits.
44
45	### Step 2: Create the Skill Folder
46
47	Create a folder with `SKILL.md` inside:
48
49	```
50	skills/<category>/<skill-name>/SKILL.md
51	```
52
53	Example: `skills/akka/cluster-sharding/SKILL.md`
54
55	### Step 3: Write the SKILL.md
56
57	```markdown
58	---
59	name: my-new-skill
60	description: Brief description of what this skill does and when to use it.
61	---
62
63	# My New Skill
64
65	## When to Use This Skill
66
67	Use this skill when:
68	- [List specific scenarios]
69
70	---
71
72	## Content
73
74	[Comprehensive guide with examples, patterns, and anti-patterns]
75	```
76
77	Requirements:
78	- `name` must be lowercase with hyphens (e.g., `cluster-sharding`)
79	- `description` should be 1-2 sentences explaining when Claude should use this skill
80	- Content should be 10-40KB covering the topic comprehensively
81	- Include concrete code examples with modern C# patterns
82
83	### Step 4: Register in plugin.json
84
85	Add the skill path to `.claude-plugin/plugin.json` in the `skills` array:
86
87	```json
88	{
89	"skills": [
90	"./skills/akka/best-practices",
91	"./skills/akka/cluster-sharding" // Add new skill here
92	]
93	}
94	```
95
96	### Step 5: Validate
97
98	Run the validation script:
99
100	```bash
101	./scripts/validate-marketplace.sh
102	```
103
104	### Step 6: Commit Together
105
106	```bash
107	git add skills/akka/cluster-sharding/ .claude-plugin/plugin.json
108	git commit -m "Add cluster-sharding skill for Akka.NET Cluster Sharding patterns"
109	```
110
111	---
112
113	## Adding a New Agent
114
115	### Step 1: Create the Agent File
116
117	Create a markdown file in `/agents/`:
118
119	```markdown
120	---
121	name: my-agent-name
122	description: Expert in [domain]. Specializes in [specific areas]. Use for [scenarios].
123	model: sonnet
124	color: blue
125	---
126
127	You are a [domain] specialist with deep expertise in [areas].
128
129	Reference Materials:
130	- [Official docs and resources]
131
132	Core Expertise Areas:
133	[List expertise areas]
134
135	Diagnostic Approach:
136	[How the agent analyzes problems]
137	```
138
139	Requirements:
140	- `name` must be lowercase with hyphens
141	- `model` must be one of: `haiku`, `sonnet`, `opus`
142	- `color` is optional (used for UI display)
143
144	### Step 2: Register in plugin.json
145
146	Add to the `agents` array:
147
148	```json
149	{
150	"agents": [
151	"./agents/akka-net-specialist",
152	"./agents/my-agent-name" // Add new agent here
153	]
154	}
155	```
156
157	### Step 3: Commit Together
158
159	```bash
160	git add agents/my-agent-name.md .claude-plugin/plugin.json
161	git commit -m "Add my-agent-name agent for [domain] expertise"
162	```
163
164	---
165
166	## Publishing a Release
167
168	### Versioning
169
170	Update the version in `.claude-plugin/plugin.json`:
171
172	```json
173	{
174	"version": "1.1.0"
175	}
176	```
177
178	Use semantic versioning (`MAJOR.MINOR.PATCH`):
179	- MAJOR: Breaking changes (renamed/removed skills)
180	- MINOR: New skills or agents added
181	- PATCH: Fixes or improvements to existing content
182
183	### Release Process
184
185	1. Update version in plugin.json
186
187	2. Validate
188	```bash
189	./scripts/validate-marketplace.sh
190	```
191
192	3. Commit version bump
193	```bash
194	git add .claude-plugin/plugin.json
195	git commit -m "Bump version to 1.1.0"
196	```
197
198	4. Create and push tag
199	```bash
200	git tag v1.1.0
201	git push origin master --tags
202	```
203
204	5. GitHub Actions will automatically:
205	- Validate the marketplace structure
206	- Create a GitHub release with auto-generated notes
207
208	---
209
210	## User Installation
211
212	Users install the complete plugin (all skills and agents):
213
214	```bash
215	# Add the marketplace (one-time)
216	/plugin marketplace add Aaronontheweb/dotnet-skills
217
218	# Install the plugin (gets everything)
219	/plugin install dotnet-skills
220
221	# Update to latest vers

People who liked this also viewed

6 picks

Type

marketplace-publishing

307installs98forks

View on GitHub

How to install marketplace-publishing?

aaronontheweb/dotnet-skills/marketplace-publishing

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

Installs into the current project.

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.

Files · 1

View on GitHub

SKILL.md

1	# Marketplace Publishing Workflow
2
3	This skill documents how to publish skills and agents to the dotnet-skills Claude Code marketplace.
4
5	## Repository Structure
6
7	```
8	dotnet-skills/
9	├── .claude-plugin/
10	│ ├── marketplace.json # Marketplace catalog
11	│ └── plugin.json # Plugin metadata + skill/agent registry
12	├── .github/workflows/
13	│ └── release.yml # Release automation
14	├── skills/
15	│ ├── akka/ # Akka.NET skills
16	│ │ ├── best-practices/SKILL.md
17	│ │ ├── testing-patterns/SKILL.md
18	│ │ └── ...
19	│ ├── aspire/ # .NET Aspire skills
20	│ ├── csharp/ # C# language skills
21	│ ├── testing/ # Testing framework skills
22	│ └── meta/ # Meta skills
23	├── agents/
24	│ └── *.md # Agent definitions
25	└── scripts/
26	└── validate-marketplace.sh
27	```
28
29	## Adding a New Skill
30
31	### Step 1: Choose a Category
32
33	Skills are organized by domain:
34
35	\| Category \| Purpose \|
36	\|----------\|---------\|
37	\| `akka/` \| Akka.NET actor patterns, testing, clustering \|
38	\| `aspire/` \| .NET Aspire orchestration, testing, configuration \|
39	\| `csharp/` \| C# language features, coding standards \|
40	\| `testing/` \| Testing frameworks (xUnit, Playwright, Testcontainers) \|
41	\| `meta/` \| Meta skills about this marketplace \|
42
43	Create a new category folder if none fits.
44
45	### Step 2: Create the Skill Folder
46
47	Create a folder with `SKILL.md` inside:
48
49	```
50	skills/<category>/<skill-name>/SKILL.md
51	```
52
53	Example: `skills/akka/cluster-sharding/SKILL.md`
54
55	### Step 3: Write the SKILL.md
56
57	```markdown
58	---
59	name: my-new-skill
60	description: Brief description of what this skill does and when to use it.
61	---
62
63	# My New Skill
64
65	## When to Use This Skill
66
67	Use this skill when:
68	- [List specific scenarios]
69
70	---
71
72	## Content
73
74	[Comprehensive guide with examples, patterns, and anti-patterns]
75	```
76
77	Requirements:
78	- `name` must be lowercase with hyphens (e.g., `cluster-sharding`)
79	- `description` should be 1-2 sentences explaining when Claude should use this skill
80	- Content should be 10-40KB covering the topic comprehensively
81	- Include concrete code examples with modern C# patterns
82
83	### Step 4: Register in plugin.json
84
85	Add the skill path to `.claude-plugin/plugin.json` in the `skills` array:
86
87	```json
88	{
89	"skills": [
90	"./skills/akka/best-practices",
91	"./skills/akka/cluster-sharding" // Add new skill here
92	]
93	}
94	```
95
96	### Step 5: Validate
97
98	Run the validation script:
99
100	```bash
101	./scripts/validate-marketplace.sh
102	```
103
104	### Step 6: Commit Together
105
106	```bash
107	git add skills/akka/cluster-sharding/ .claude-plugin/plugin.json
108	git commit -m "Add cluster-sharding skill for Akka.NET Cluster Sharding patterns"
109	```
110
111	---
112
113	## Adding a New Agent
114
115	### Step 1: Create the Agent File
116
117	Create a markdown file in `/agents/`:
118
119	```markdown
120	---
121	name: my-agent-name
122	description: Expert in [domain]. Specializes in [specific areas]. Use for [scenarios].
123	model: sonnet
124	color: blue
125	---
126
127	You are a [domain] specialist with deep expertise in [areas].
128
129	Reference Materials:
130	- [Official docs and resources]
131
132	Core Expertise Areas:
133	[List expertise areas]
134
135	Diagnostic Approach:
136	[How the agent analyzes problems]
137	```
138
139	Requirements:
140	- `name` must be lowercase with hyphens
141	- `model` must be one of: `haiku`, `sonnet`, `opus`
142	- `color` is optional (used for UI display)
143
144	### Step 2: Register in plugin.json
145
146	Add to the `agents` array:
147
148	```json
149	{
150	"agents": [
151	"./agents/akka-net-specialist",
152	"./agents/my-agent-name" // Add new agent here
153	]
154	}
155	```
156
157	### Step 3: Commit Together
158
159	```bash
160	git add agents/my-agent-name.md .claude-plugin/plugin.json
161	git commit -m "Add my-agent-name agent for [domain] expertise"
162	```
163
164	---
165
166	## Publishing a Release
167
168	### Versioning
169
170	Update the version in `.claude-plugin/plugin.json`:
171
172	```json
173	{
174	"version": "1.1.0"
175	}
176	```
177
178	Use semantic versioning (`MAJOR.MINOR.PATCH`):
179	- MAJOR: Breaking changes (renamed/removed skills)
180	- MINOR: New skills or agents added
181	- PATCH: Fixes or improvements to existing content
182
183	### Release Process
184
185	1. Update version in plugin.json
186
187	2. Validate
188	```bash
189	./scripts/validate-marketplace.sh
190	```
191
192	3. Commit version bump
193	```bash
194	git add .claude-plugin/plugin.json
195	git commit -m "Bump version to 1.1.0"
196	```
197
198	4. Create and push tag
199	```bash
200	git tag v1.1.0
201	git push origin master --tags
202	```
203
204	5. GitHub Actions will automatically:
205	- Validate the marketplace structure
206	- Create a GitHub release with auto-generated notes
207
208	---
209
210	## User Installation
211
212	Users install the complete plugin (all skills and agents):
213
214	```bash
215	# Add the marketplace (one-time)
216	/plugin marketplace add Aaronontheweb/dotnet-skills
217
218	# Install the plugin (gets everything)
219	/plugin install dotnet-skills
220
221	# Update to latest vers

People who liked this also viewed

6 picks

Type