dotnet-aspire — Claude Code skill: setup and installation
The dotnet-aspire skill helps add .NET Aspire to an existing .NET solution, including its orchestration and shared service setup. Use it when wiring a distributed app.
no license 104 installs ★ 25 updated 2026-02-19
npx skills add markpitt/claude-skills --skill dotnet-aspire -a claude-codeWhat dotnet-aspire does
The skill examines a .NET solution to identify APIs, web apps, and worker services, then guides the setup of AppHost and ServiceDefaults projects. AppHost describes the services and their dependencies; ServiceDefaults supplies shared service configuration. The skill also covers service discovery and adding NuGet packages.
Install the Aspire workload with dotnet workload install aspire. If the app uses container resources such as PostgreSQL or Redis, Docker Desktop must be running before you start AppHost. Without it, those container resources will not start. The setup also covers service links and launching AppHost with dotnet run --project MyApp.AppHost.
What it helps with
- add AppHost and ServiceDefaults projects to a .NET solution
- connect APIs, web apps, and worker services
- replace hardcoded service URLs with service discovery
- attach databases, caches, or message queues to AppHost
Example prompts for the agent
- Add .NET Aspire to this solution and create the AppHost and ServiceDefaults projects.
- Set up service discovery between the API and web app in this .NET solution.
- Connect PostgreSQL and Redis to AppHost and link them to the right projects.
How to install dotnet-aspire
1Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill dotnet-aspire -a claude-code2Manually: put the files in place
~/.claude/skills/dotnet-aspire/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/dotnet-aspire/
1Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill dotnet-aspire -a codex2Manually: put the files in place
.agents/skills/dotnet-aspire/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill dotnet-aspire -a cursor2Manually: put the files in place
.cursor/skills/dotnet-aspire/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install markpitt/claude-skills skills/dotnet-aspire2Manually: put the files in place
.github/skills/dotnet-aspire/SKILL.md1Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill dotnet-aspire -a gemini-cli2Platform CLI
gemini skills install https://github.com/markpitt/claude-skills --path skills/dotnet-aspireManually: put the files in place
.devin/skills/dotnet-aspire/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill dotnet-aspire -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about dotnet-aspire
How do I install dotnet-aspire in Claude Code?
Run npx skills add markpitt/claude-skills --skill dotnet-aspire -a claude-code. The skill file is placed at ~/.claude/skills/dotnet-aspire/SKILL.md.
What does dotnet-aspire do?
It guides adding .NET Aspire to a solution: setting up AppHost and ServiceDefaults, connecting services, and configuring distributed app orchestration.
What do I need to run AppHost with containers?
Install the Aspire workload with dotnet workload install aspire. Container resources also require Docker Desktop to be running.