Skip to content
Back to search

dotnet-skills

MarketplaceWorks with Claude CodeGitHub

Official Claude Code Marketplace for .NET development - C#, F#, Akka.NET, Aspire, testing frameworks, and specialized tools

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aaronontheweb-dotnet-skills/badge.svg)](/listings/aaronontheweb-dotnet-skills)

HTML

<a href="/listings/aaronontheweb-dotnet-skills"><img src="/api/listings/aaronontheweb-dotnet-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

This plugin works with multiple AI coding assistants that support skills/agents.

Claude Code (CLI)

[Official Docs](https://code.claude.com/docs/en/discover-plugins)

Run these commands inside the Claude Code CLI (the terminal app, not the VSCode extension):

/plugin marketplace add https://github.com/Aaronontheweb/dotnet-skills
/plugin install dotnet-skills

To update:

/plugin marketplace update

Codex (OpenAI)

[Official Docs](https://developers.openai.com/codex/plugins)

Add the marketplace, then install the plugin:

codex plugin marketplace add Aaronontheweb/dotnet-skills
codex plugin add dotnet-skills@dotnet-skills

Verify the install:

codex plugin list

Skills are auto-discovered from the plugin's `skills/` directory. Invoke one with `/skills` or `$skill-name` in the Codex CLI or IDE extension. Note: the specialized agents are Claude Code-specific and are not included in the Codex plugin.

GitHub Copilot

[Official Docs](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills)

Clone or copy skills to your project or global config:

**Project-level** (recommended):

# Clone to .github/skills/ in your project
git clone https://github.com/Aaronontheweb/dotnet-skills.git /tmp/dotnet-skills
cp -r /tmp/dotnet-skills/skills/* .github/skills/

**Global** (all projects):

mkdir -p ~/.copilot/skills
cp -r /tmp/dotnet-skills/skills/* ~/.copilot/skills/

OpenCode

[Official Docs](https://opencode.ai/docs/skills)

git clone https://github.com/Aaronontheweb/dotnet-skills.git /tmp/dotnet-skills

# Global installation (directory names must match frontmatter 'name' field)
mkdir -p ~/.config/opencode/skills ~/.config/opencode/agents
for skill_file in /tmp/dotnet-skills/skills/*/SKILL.md; do
  skill_name=$(grep -m1 "^name:" "$skill_file" | sed 's/name: *//')
  mkdir -p ~/.config/opencode/skills/$skill_name
  cp "$skill_file" ~/.config/opencode/skills/$skill_name/SKILL.md
done
cp /tmp/dotnet-skills/agents/*.md ~/.config/opencode/agents/

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "dotnet-skills",
  3. "description": "Official Claude Code Marketplace for .NET development - C#, F#, Akka.NET, Aspire, testing frameworks, and specialized tools",
  4. "owner": {
  5. "name": "Aaron Stannard",
  6. "url": "https://github.com/Aaronontheweb"
  7. },
  8. "repository": "https://github.com/Aaronontheweb/dotnet-skills",
  9. "plugins": [
  10. {
  11. "name": "dotnet-skills",
  12. "source": "./",
  13. "version": "1.7.1",
  14. "description": "Complete .NET development toolkit with 39 skills and 6 specialized agents covering Akka.NET, Aspire, testing, and modern C# patterns"
  15. }
  16. ]
  17. }
README.md · README · 321 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # .NET Skills for Claude Code and Codex
  2. A comprehensive AI coding plugin with **30 skills** and **5 specialized agents** for professional .NET development. Battle-tested patterns from production systems covering C#, Akka.NET, Aspire, EF Core, testing, and performance optimization.
  3. ## Installation
  4. This plugin works with multiple AI coding assistants that support skills/agents.
  5. ### Claude Code (CLI)
  6. [Official Docs](https://code.claude.com/docs/en/discover-plugins)
  7. Run these commands inside the Claude Code CLI (the terminal app, not the VSCode extension):
  8. ```
  9. /plugin marketplace add https://github.com/Aaronontheweb/dotnet-skills
  10. /plugin install dotnet-skills
  11. ```
  12. To update:
  13. ```
  14. /plugin marketplace update
  15. ```
  16. ### Codex (OpenAI)
  17. [Official Docs](https://developers.openai.com/codex/plugins)
  18. Add the marketplace, then install the plugin:
  19. ```bash
  20. codex plugin marketplace add Aaronontheweb/dotnet-skills
  21. codex plugin add dotnet-skills@dotnet-skills
  22. ```
  23. Verify the install:
  24. ```bash
  25. codex plugin list
  26. ```
  27. Skills are auto-discovered from the plugin's `skills/` directory. Invoke one with `/skills` or `$skill-name` in the Codex CLI or IDE extension. Note: the specialized agents are Claude Code-specific and are not included in the Codex plugin.
  28. ### GitHub Copilot
  29. [Official Docs](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills)
  30. Run these commands:
  31. ```bash
  32. /plugin marketplace add https://github.com/Aaronontheweb/dotnet-skills
  33. /plugin install dotnet-skills@dotnet-skills
  34. ```
  35. To update:
  36. ```bash
  37. /plugin update dotnet-skills@dotnet-skills
  38. ```
  39. Alternatively:
  40. Clone or copy skills to your project or global config:
  41. **Project-level** (recommended):
  42. ```bash
  43. # Clone to .github/skills/ in your project
  44. git clone https://github.com/Aaronontheweb/dotnet-skills.git /tmp/dotnet-skills
  45. cp -r /tmp/dotnet-skills/skills/* .github/skills/
  46. ```
  47. **Global** (all projects):
  48. ```bash
  49. mkdir -p ~/.copilot/skills
  50. cp -r /tmp/dotnet-skills/skills/* ~/.copilot/skills/
  51. ```
  52. ### OpenCode
  53. [Official Docs](https://opencode.ai/docs/skills)
  54. ```bash
  55. git clone https://github.com/Aaronontheweb/dotnet-skills.git /tmp/dotnet-skills
  56. # Global installation (directory names must match frontmatter 'name' field)
  57. mkdir -p ~/.config/opencode/skills ~/.config/opencode/agents
  58. for skill_file in /tmp/dotnet-skills/skills/*/SKILL.md; do
  59. skill_name=$(grep -m1 "^name:" "$skill_file" | sed 's/name: *//')
  60. mkdir -p ~/.config/opencode/skills/$skill_name
  61. cp "$skill_file" ~/.config/opencode/skills/$skill_name/SKILL.md
  62. done
  63. cp /tmp/dotnet-skills/agents/*.md ~/.config/opencode/agents/
  64. ```
  65. ---
  66. ## Suggested AGENTS.md / CLAUDE.md Snippets
  67. These snippets go in your **project root** (the root directory of your codebase, next to your `.git` folder):
  68. - Claude Code: `CLAUDE.md`
  69. - OpenCode: `AGENTS.md`
  70. Prerequisite: install/sync the dotnet-skills plugin in your assistant runtime (Claude Code or OpenCode) so the skill IDs below resolve.
  71. To get consistent skill usage in downstream repos, add a small router snippet in `AGENTS.md` (OpenCode) or `CLAUDE.md` (Claude Code). These snippets tell the assistant which skills to use for common tasks.
  72. ### Readable snippet (copy/paste)
  73. ```markdown
  74. # Agent Guidance: dotnet-skills
  75. IMPORTANT: Prefer retrieval-led reasoning over pretraining for any .NET work.
  76. Workflow: skim repo patterns -> consult dotnet-skills by name -> implement smallest-change -> note conflicts.
  77. Routing (invoke by name)
  78. - C# / code quality: modern-csharp-coding-standards, csharp-concurrency-patterns, api-design, type-design-performance, r3-reactive-extensions
  79. - ASP.NET Core / Web (incl. Aspire): aspire-service-defaults, aspire-integration-testing, mailpit-integration, mjml-email-templates, verify-email-snapshots
  80. - Data: efcore-patterns, database-performance
  81. - DI / config: dependency-injection-patterns, microsoft-extensions-configuration
  82. - Testing: cscheck, testcontainers-integration-tests, playwright-blazor-testing, snapshot-testing
  83. Quality gates (use when applicable)
  84. - dotnet-slopwatch: after substantial new/refactor/LLM-authored code
  85. - crap-analysis: after tests added/changed in complex code
  86. Specialist agents
  87. - dotnet-concurrency-specialist, dotnet-performance-analyst, dotnet-benchmark-designer, akka-net-specialist, docfx-specialist
  88. ```
  89. ### Compressed snippet (generated)
  90. Run `./scripts/generate-skill-index-snippets.sh --update-readme` to refresh the block below.
  91. <!-- BEGIN DOTNET-SKILLS COMPRESSED INDEX -->
  92. ```markdown
  93. [dotnet-skills]|IMPORTANT: Prefer retrieval-led reasoning over pretraining for any .NET work.
  94. |flow:{skim repo patterns -> consult dotnet-skills by name -> implement smallest-change -> note conflicts}
  95. |route:
  96. |akka:{akka-net-best-practices,akka-net-testing-patterns,akka-hosting-actor-patterns,akka-net-aspire-configuration,akka-net-management}
  97. |csharp:{modern-csharp-coding-standards,csharp-concurrency-patterns,csharp-nullable-reference-types,api-design,type-design-performance,r3-reactive-extensions}
  98. |aspnetcore-web:{aspire-integration-testing,aspire-configuration,aspire-service-defaults,mailpit-integration,mjml-email-templates}
  99. |data:{efcore-patterns,database-performance}
  100. |di-config:{microsoft-extensions-configuration,dependency-injection-patterns}
  101. |testing:{cscheck,testcontainers-integration-tests,playwright-blazor-testing,snapshot-testing,verify-email-snapshots,playwright-ci-caching}
  102. |dotnet:{sdk-container-publishing,dotnet-project-structure,dotnet-local-tools,package-management,serialization,dotnet-devcert-trust,ilspy-decompile,opentelemetry-net-instrumentation,aot-trimming}
  103. |quality-gates:{dotnet-slopwatch,crap-analysis}
  104. |meta:{marketplace-publishing,skills-index-snippets}
  105. |agents:{akka-net-specialist,docfx-specialist,dotnet-benchmark-designer,dotnet-concurrency-specialist,dotnet-performance-analyst,roslyn-incremental-generator-specialist}
  106. ```
  107. <!-- END DOTNET-SKILLS COMPRESSED INDEX -->
  108. ## Specialized Agents
  109. Agents are AI personas with deep domain expertise. They're invoked automatically when Claude Code detects relevant tasks.
  110. | Agent | Expertise |
  111. | --------------------------------- | ---------------------------------------------------------------------- |
  112. | **akka-net-specialist** | Actor systems, clustering, persistence, Akka.Streams, message patterns |
  113. | **dotnet-concurrency-specialist** | Threading, async/await, race conditions, deadlock analysis |
  114. | **dotnet-benchmark-designer** | BenchmarkDotNet setup, custom benchmarks, measurement strategies |
  115. | **dotnet-performance-analyst** | Profiler analysis, benchmark interpretation, regression detection |
  116. | **docfx-specialist** | DocFX builds, API documentation, markdown linting |
  117. ---
  118. ## Skills Library
  119. ### Akka.NET
  120. Production patterns for building distributed systems with Akka.NET.
  121. | Skill | What You'll Learn |
  122. | -------------------------- | --------------------------------------------------------------------------- |
  123. | **best-practices** | EventStream vs DistributedPubSub, supervision strategies, actor hierarchies |
  124. | **testing-patterns** | Akka.Hosting.TestKit, async assertions, TestProbe patterns |
  125. | **hosting-actor-patterns** | Props factories, `IRequiredActor<T>`, DI scope management in actors |
  126. | **aspire-configuration** | Akka.NET + .NET Aspire integration, HOCON with IConfiguration |
  127. | **management** | Akka.Management, health checks, cluster bootstrap |
  128. ### C# Language
  129. Modern C# patterns for clean, performant code.
  130. | Skill | What You'll Learn |
  131. | --------------------------- | ----------------------------------------------------------------------- |
  132. | **coding-standards** | Records, pattern matching, nullable types, value objects, no AutoMapper |
  133. | **concurrency-patterns** | When to use Task vs Channel vs lock vs actors |
  134. | **api-design** | Extend-only design, API/wire compatibility, versioning strategies |
  135. | **type-design-performance** | Sealed classes, readonly structs, static pure functions, Span&lt;T&gt; |
  136. | **r3-reactive-extensions** | R3 vs Rx.NET, OnErrorResume, AwaitOperation async dispatch, concurrency, TimeProvider/FrameProvider |
  137. ### Data Access
  138. Database patterns that scale.
  139. | Skill | What You'll Learn |
  140. | ------------------------ | --------------------------------------------------------------- |
  141. | **efcore-patterns** | Entity configuration, migrations, query optimization |
  142. | **database-performance** | Read/write separation, N+1 prevention, AsNoTracking, row limits |
  143. ### .NET Aspire
  144. Cloud-native application orchestration.
  145. | Skill | What You'll Learn |
  146. | ----------------------- | ------------------------------------------------------------ |
  147. | **integration-testing** | DistributedApplicationTestingBuilder, Aspire.Hosting.Testing |
  148. | **service-defaults** | OpenTelemetry, health checks, resilience, service discovery |
  149. | **mailpit-integration** | Email testing with Mailpit container, SMTP config, test assertions |
  150. ### ASP.NET Core
  151. Web application patterns.
  152. | Skill | What You'll Learn |
  153. | ------------------------ | --------------------------------------------------------- |
  154. | **mjml-email-templates** | MJML syntax, responsive layouts, template renderer, composer pattern |
  155. ### .NET Ecosystem
  156. Core .NET development practices.
  157. | Skill | What You'll Learn |
  158. | ---------------------- | ---------------------------------------------------------------------- |
  159. | **project-structure** | Solution layout, Directory.Build.props, layered architecture |
  160. | **package-management** | Central Package Management (CPM), shared version variables, dotnet CLI |
  161. | **serialization** | Protobuf, MessagePack, System.Text.Json source generators, AOT |
  162. | **local-tools** | dotnet tool manifests, team-shared tooling |
  163. | **slopwatch** | Detect LLM-generated anti-patterns in your codebase |
  164. ### Microsoft.Extensions
  165. Dependency injection and configuration patterns.
  166. | Skill | What You'll Learn |
  167. | ------------------------ | ----------------------------------------------------------------- |
  168. | **configuration** | IOptions pattern, environment-specific config, secrets management |
  169. | **dependency-injection** | IServiceCollection extensions, scope management, keyed services |
  170. ### Testing
  171. Comprehensive testing strategies.
  172. | Skill | What You'll Learn |
  173. | -------------------------- | ------------------------------------------------------------- |
  174. | **cscheck** | Property generators, model-based tests, native Spec, shrinking and replay |
  175. | **testcontainers** | Docker-based integration tests, PostgreSQL, Redis, RabbitMQ |
  176. | **playwright-blazor** | E2E testing for Blazor apps, page objects, async assertions |
  177. | **crap-analysis** | CRAP scores, coverage thresholds, ReportGenerator integration |
  178. | **snapshot-testing** | Verify library, approval testing, API response validation |
  179. | **verify-email-snapshots** | Snapshot test email templates, catch rendering regressions |
  180. ---
  181. ## Key Principles
  182. These skills emphasize patterns that work in production:
  183. - **Immutability by default** - Records, readonly structs, value objects
  184. - **Type safety** - Nullable reference types, strongly-typed IDs
  185. - **Composition over inheritance** - No abstract base classes, sealed by default
  186. - **Performance-aware** - Span&lt;T&gt;, pooling, deferred enumeration
  187. - **Testable** - DI everywhere, pure functions, explicit dependencies
  188. - **No magic** - No AutoMapper, no reflection-heavy frameworks
  189. ---
  190. ## Repository Structure
  191. ```
  192. dotnet-skills/
  193. ├── .claude-plugin/
  194. │ ├── plugin.json # Claude Code plugin manifest
  195. │ └── marketplace.json # Claude Code marketplace
  196. ├── .codex-plugin/
  197. │ └── plugin.json # Codex plugin manifest
  198. ├── .agents/
  199. │ └── plugins/
  200. │ └── marketplace.json # Codex marketplace
  201. ├── agents/ # 5 specialized agents (Claude Code)
  202. │ ├── akka-net-specialist.md
  203. │ ├── docfx-specialist.md
  204. │ ├── dotnet-benchmark-designer.md
  205. │ ├── dotnet-concurrency-specialist.md
  206. │ └── dotnet-performance-analyst.md
  207. └── skills/ # Flat structure (30 skills)
  208. ├── akka-best-practices/SKILL.md
  209. ├── akka-hosting-actor-patterns/SKILL.md
  210. ├── akka-net-aspire-configuration/SKILL.md
  211. ├── aspire-configuration/SKILL.md
  212. ├── aspire-integration-testing/SKILL.md
  213. ├── csharp-concurrency-patterns/SKILL.md
  214. ├── testcontainers-integration-tests/SKILL.md
  215. └── ... # (prefixed by category)
  216. ```
  217. ---
  218. ## Contributing
  219. Want to add a skill or agent? PRs welcome!
  220. 1. Create `skills/<skill-name>/SKILL.md` (use prefixes like `akka-`, `aspire-`, `csharp-` for category)
  221. 2. Add the path to `.claude-plugin/plugin.json` (the Codex plugin auto-discovers the whole `skills/` dir)
  222. 3. Run `./scripts/validate-marketplace.sh` and `./scripts/validate-codex-plugin.sh`
  223. 4. Submit a PR
  224. Skills should be comprehensive reference documents (10-40KB) with concrete examples and anti-patterns.
  225. ---
  226. ## Author
  227. Created by [Aaron Stannard](https://aaronstannard.com/) ([@Aaronontheweb](https://github.com/Aaronontheweb))
  228. Patterns drawn from production systems including [Akka.NET](https://getakka.net/), [Petabridge](https://petabridge.com/), and [Sdkbin](https://sdkbin.com/).
  229. ## License
  230. MIT License - Copyright (c) 2025 Aaron Stannard
  231. See [LICENSE](LICENSE) for full details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.