市场出版
- 作者仓库星标 0
- 作者更新于 2026年8月7日 18:11
- 作者仓库 dotnet-skills
- 领域
- 效率工具
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @Aaronontheweb · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
第 1 步:选择类别
技能按领域组织: 类别 · 目的 `akka/` · Akka.NET Actor 模式、测试、集群 `aspire/` · .NET Aspire 编排、测试、配置 `csharp/` · C# 语言功能、编码标准
第2步:创建技能文件夹
创建一个文件夹,其中包含`SKILL.md`:示例:`skills/akka/cluster-sharding/SKILL.md`
第3步:编写SKILL.md
要求: `name` 必须是小写并带有连字符(例如,`cluster-sharding`) `description` 应该是 1-2 句话,解释 Claude 何时应该使用此技能 内容应该是 10-40KB 全面涵盖该主题 包括具有现代 C# 模式的具体代码示例
第4步:在plugin.json中注册
将技能路径添加到`skills`数组中的`.claude-plugin/plugin.json`:
第 5 步:验证
运行验证脚本:
第 1 步:创建代理文件
在`/agents/`中创建markdown文件: 要求: `name`必须小写,带连字符 `model`必须是以下之一:`haiku`、`sonnet`、`opus` `color`可选(用于UI显示)
第2步:在plugin.json中注册
添加到 `agents` 数组:
# 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
```markdown
---
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:
```json
{
"skills": [
"./skills/akka/best-practices",
"./skills/akka/cluster-sharding" // Add new skill here
]
}
```
### Step 5: Validate
Run the validation script:
```bash
./scripts/validate-marketplace.sh
```
### Step 6: Commit Together
```bash
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/`:
```markdown
---
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:
```json
{
"agents": [
"./agents/akka-net-specialist",
"./agents/my-agent-name" // Add new agent here
]
}
```
### Step 3: Commit Together
```bash
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`:
```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**
```bash
./scripts/validate-marketplace.sh
```
3. **Commit version bump**
```bash
git add .claude-plugin/plugin.json
git commit -m "Bump version to 1.1.0"
```
4. **Create and push tag**
```bash
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):
```bash
# 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
章节与文件索引
按说明文件中的顺序排列。
第 1 步:选择类别
第2步:创建技能文件夹
第3步:编写SKILL.md
第4步:在plugin.json中注册
第 5 步:验证
文件/命令 -> akka/ · aspire/ · csharp/ · testing/ · meta/ · skills/akka/cluster-sharding/SKILL.md · name · cluster-sharding
内容校验值 -> 1c1a11855db1
当前原文的自动摘译,尚未人工审校。
第 1 步:选择类别
技能按领域组织:类别 · 目的
akka/· Akka.NET Actor 模式、测试、集群aspire/· .NET Aspire 编排、测试、配置csharp/· C# 语言功能、编码标准