aspire-orchestration

Manage Aspire AppHost lifecycle operations with safe recovery from file locks and port conflicts.

1|Updated Feb 4, 2025
One-click install
npx skills add https://github.com/MarcelMichau/dotnet-starter-project-template --skill aspire-orchestration-marcelmichau
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aspire-orchestration
Source: https://github.com/MarcelMichau/dotnet-starter-project-template/tree/main/.agents/skills/aspire-orchestration
Command: npx skills add https://github.com/MarcelMichau/dotnet-starter-project-template --skill aspire-orchestration-marcelmichau

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides centralized lifecycle management for Aspire AppHost, enabling safe startup, shutdown, wait-for-resource sequencing, and recovery from file locks, port conflicts, and orphaned processes.

Core Features & Use Cases

  • Manage AppHost lifecycle (start, stop, wait, describe) and resource awareness.
  • Safely recover from common issues like file locks and port conflicts without manual intervention.
  • Guidance for troubleshooting and escalation, with non-interactive agent-friendly patterns.

Quick Start

Start the Aspire AppHost with aspire start and then verify resources with aspire ps.

Frequently Asked Questions about aspire-orchestration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage the Aspire AppHost lifecycle automatically?

Automating Aspire AppHost lifecycle management involves handling startup, stop, wait-for-resource sequencing, and describe operations. It enforces non-interactive agent flows and provides JSON-formatted output for resource awareness across local development and containerized workloads.

How do I recover from file locks and port conflicts when running Aspire?

Recovering from file locks and port conflicts during Aspire AppHost execution is handled through built-in safe recovery safeguards. It detects these common issues and automatically resolves them without requiring manual intervention.

Does Aspire orchestration work with git worktrees and containerized workloads?

Yes, Aspire orchestration works with git worktrees and containerized workloads. It applies lifecycle management and resource operations across these environments, detecting AppHost types and enforcing non-interactive agent-friendly patterns.

What is the best way to troubleshoot orphaned processes in Aspire AppHost?

The best way to troubleshoot orphaned processes in Aspire AppHost is using the built-in guidance for troubleshooting and escalation. It provides JSON-formatted describe output and a guarded handoff to project-local skills for deeper diagnosis.

Why does my Aspire AppHost startup fail due to non-interactive agent flows?

Aspire AppHost startup can fail if non-interactive agent flows are not properly enforced. This Skill detects the AppHost type and enforces these flows to ensure safe startup and resource sequencing without manual input.