
Aspire Orchestration
Run and upgrade .NET Aspire AppHost projects safely with the Aspire CLI, including unattended CLI self-updates and orchestration workflows that agents can execute without mangling project files.
Install
npx skills add https://github.com/microsoft/aspire-skills --skill aspire-orchestrationWhat is this skill?
- Recommends `aspire update --self` for safe, unattended Aspire CLI upgrades without touching project references.
- Separates CLI self-upgrade from bare `aspire update`, which edits csproj and aspire.config.json and needs human review.
- Covers Aspire 13.3-era orchestration scenarios including worktree and agent-mode operation.
- Grounded in real AppHost + aspire.config.json layouts for eval-grade agent responses.
Adoption & trust: 25 installs on skills.sh; 48 GitHub stars.
Recommended Skills
Azure Deploymicrosoft/azure-skills
Azure Preparemicrosoft/azure-skills
Azure Storagemicrosoft/azure-skills
Azure Validatemicrosoft/azure-skills
Appinsights Instrumentationmicrosoft/azure-skills
Azure Resource Lookupmicrosoft/azure-skills
Journey fit
Primary fit
Aspire orchestration is where solo builders wire services in the AppHost and drive local distributed runs—canonical shelf is Build because that is when the AppHost and CLI workflows matter most. Integrations is the right subphase because orchestration centers on composing services, resources, and CLI-driven project updates in an Aspire solution.
SKILL.md
READMESKILL.md - Aspire Orchestration
name: aspire-orchestration-eval description: Evaluates the aspire-orchestration skill against the 5 core complaints from microsoft/aspire#15801 plus detection, worktree, and agent-mode scenarios. version: "1.0" type: capability tags: skill: aspire-orchestration config: runs: 3 timeout: 120s executor: copilot-sdk model: gpt-5-mini stimuli: - name: orch-update-self-001 prompt: How do I upgrade my Aspire CLI to the latest 13.3? tags: priority: p1 area: - aspire-13-3 - update environment: files: - src: ../../../evals/csharp-apphost/MyApp.AppHost/MyApp.AppHost.csproj dest: csharp-apphost/MyApp.AppHost/MyApp.AppHost.csproj - src: ../../../evals/csharp-apphost/aspire.config.json dest: csharp-apphost/aspire.config.json graders: - type: prompt name: uses_update_self config: prompt: Does the assistant's response recommend `aspire update --self` to upgrade the Aspire CLI itself? This is the safe, no-side-effect upgrade path that an agent can run unattended. - type: prompt name: distinguishes_project_update config: prompt: Does the assistant's response distinguish `aspire update --self` (CLI upgrade) from bare `aspire update` (which modifies project package references and `aspire.config.json`)? It should warn that bare `aspire update` edits project files and therefore should be run with user approval rather than unattended. - type: output-not-contains config: substring: automatically run aspire update name: never_runs_project_update_unattended - type: output-not-contains config: substring: run aspire update without confirmation - type: output-contains config: substring: aspire update --self - type: output-not-contains config: substring: dotnet run name: never_dotnet_run - type: output-not-contains config: substring: dotnet build - type: output-not-contains config: substring: while true name: never_curl_polling - type: output-not-contains config: substring: sleep - type: output-not-contains config: substring: curl.*health - name: orch-aspireify-001 prompt: I just ran `aspire init` in my existing Node.js + .NET repo and it created an apphost.cs and aspire.config.json. What's next? Wire up my services. tags: priority: p0 area: - init-workflow - aspireify-handoff environment: files: - src: ../../../evals/non-aspire/MyApp/MyApp.csproj dest: non-aspire/MyApp/MyApp.csproj - src: ../../../evals/non-aspire/MyApp/Program.cs dest: non-aspire/MyApp/Program.cs graders: - type: prompt name: hands_off_to_aspireify config: prompt: Does the assistant's response explicitly hand the AppHost wiring step off to the `aspireify` skill (in-plugin sibling at `../aspireify/SKILL.md`, OR the project-local `.agents/skills/aspireify/SKILL.md` if installed by `aspire init`)? The orchestration skill itself should defer scanning the repo, choosing resources, and editing the AppHost to aspireify. Answer based on intent. - type: prompt name: mentions_project_local_precedence config: prompt: Does the assistant's response acknowledge that if a project-local `.agents/skills/aspireify/SKILL.md` exists, the agent should defer to it (with a warning to the user) instead of using the in-plugin sibling? - type: output-not-contains config: substring: I'll write the AppHost name: never_handauthors_apphost - type: output-not-contains config: substring: Let me edit apphost.cs -