Back to Skills

aspire

Aspire skill covering the Aspire CLI, AppHost orchestration, service discovery, integrations, MCP server, VS Code extension, Dev Containers, GitHub Codespaces, templates, dashboard, and deployment. Use when the user asks to create, run, debug, configure, deploy, or troubleshoot an Aspire distributed application.

30,587stars3,654forksUpdated 4/21/2026

Security Assessment

Safe(93/100)
Security Score93/100

About aspire

This skill is a comprehensive guide to .NET Aspire, a code-first, polyglot toolchain for building observable, production-ready distributed applications orchestrated from a single AppHost project. It solves the problem of coordinating heterogeneous workloads (C#, Python, JavaScript/TypeScript, Go, Java, Rust, Bun, Deno, PowerShell) by treating the AppHost as a conductor that starts services, wires up service discovery, and watches for problems. The skill packages a main SKILL.md plus on-demand reference files covering the CLI, MCP server, integrations catalog, polyglot APIs, architecture, dashboard, deployment, testing, and troubleshooting.

Its capabilities span the Aspire lifecycle. It explains how to research Aspire documentation, including the Aspire MCP server's docs and integration lookup tools across CLI versions and Context7 or GitHub search as fallbacks. It documents installation and prerequisites (a .NET 10 SDK), CLI usage, AppHost orchestration, service discovery, integrations, the dashboard, and a detailed deployment reference. The deployment material shows how aspire publish generates artifacts for Docker Compose, Kubernetes manifests and Helm charts, Azure Container Apps Bicep, and Azure App Service, maps AppHost resource concepts to each target, and includes CI/CD examples for GitHub Actions and Azure DevOps plus Dev Container and Codespaces configuration.

The target users are .NET and polyglot developers building cloud-native, multi-service applications who want to create, run, debug, configure, deploy, or troubleshoot Aspire apps. The install and CI examples use the official aspire.dev install script piped to a shell, a documented vendor pattern; the skill itself is reference documentation and does not execute those commands on its own.

FAQ

What are the prerequisites for using Aspire?

The skill notes a .NET 10.0+ SDK is required, even for non-.NET workloads, and covers installing the standalone Aspire CLI which is cross-platform.

Which deployment targets does it cover?

It documents generating artifacts with aspire publish for Docker Compose, Kubernetes (YAML manifests and optional Helm charts), Azure Container Apps via Bicep, and Azure App Service, and maps AppHost concepts to each.

Does Aspire deploy applications directly?

No. The reference is explicit that Aspire generates deployment manifests; you run those artifacts through your own CI/CD pipeline. It provides GitHub Actions and Azure DevOps examples for that.

How does it help find Aspire documentation?

It describes the Aspire MCP server's docs search and integration lookup tools (varying by CLI version), with Context7 and GitHub search of the official repos as fallbacks.

Is it only for C# projects?

No. Aspire is polyglot and can orchestrate C#, Python, JavaScript/TypeScript, Go, Java, Rust, Bun, Deno, and PowerShell workloads from one AppHost.

All Files

10 files
references/deployment.md6.2 KB
View
references/cli-reference.md8.5 KB
View
references/testing.md7.3 KB
View
references/dashboard.md6.2 KB
View
references/architecture.md9.8 KB
View
references/troubleshooting.md10.8 KB
View
references/mcp-server.md8.3 KB
View
references/integrations-catalog.md5.0 KB
View
references/polyglot-apis.md8.7 KB
View
SKILL.md9.1 KB
View

Install aspire

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill