# dotnet-aspire

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 104 installs · ★ 25 repo stars
- Author: markpitt
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/markpitt/claude-skills/tree/HEAD/skills/dotnet-aspire/SKILL.md
- Updated: 2026-02-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/dotnet-aspire

## What it 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`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill dotnet-aspire -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/dotnet-aspire/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/dotnet-aspire/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill dotnet-aspire -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/dotnet-aspire/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill dotnet-aspire -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/dotnet-aspire/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install markpitt/claude-skills skills/dotnet-aspire
```

2. **Manually: put the files in place**
- File: `.github/skills/dotnet-aspire/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill dotnet-aspire -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/markpitt/claude-skills --path skills/dotnet-aspire
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/dotnet-aspire/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill dotnet-aspire -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/markpitt/claude-skills/tree/HEAD/skills/dotnet-aspire/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [aspire-service-defaults](https://affpapa.org/en/nevibecode/skills/aspire-service-defaults.md) — skill · 507 installs
- [aspire-configuration](https://affpapa.org/en/nevibecode/skills/aspire-configuration.md) — skill · 496 installs
- [aspire](https://affpapa.org/en/nevibecode/skills/aspire.md) — skill · 4000 installs
- [aspire-monitoring](https://affpapa.org/en/nevibecode/skills/aspire-monitoring.md) — skill · 1700 installs
- [aspire-deployment](https://affpapa.org/en/nevibecode/skills/aspire-deployment.md) — skill · 1200 installs
- [dotnet-fullstack-mentor](https://affpapa.org/en/nevibecode/agents/dotnet-fullstack-mentor.md) — subagent · ★ 41430 repo stars

From the same set: [markpitt/claude-skills](https://affpapa.org/en/nevibecode/by/markpitt/claude-skills.md) — 10 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
