aspire-init

Scaffolds Aspire AppHost skeletons in repositories using aspire new or aspire init.

1|Updated Jul 7, 2026
One-click install
npx skills add https://github.com/seiggy/maf-copilot-studio-demo --skill aspire-init-seiggy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aspire-init
Source: https://github.com/seiggy/maf-copilot-studio-demo/tree/main/.agents/skills/aspire-init
Command: npx skills add https://github.com/seiggy/maf-copilot-studio-demo --skill aspire-init-seiggy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Adding .NET Aspire orchestration to a repository requires choosing the right entry command, template, and language, and running the wrong one on a repo that already has an AppHost breaks the setup. This Skill detects whether a repo is safe to initialize, picks between aspire new (greenfield) and aspire init (existing repo), drops the AppHost skeleton, and hands off wiring to the aspireify skill. ## Core Features & Use Cases - AppHost Detection: Checks for C# AppHost projects, file-based apphost.cs, TypeScript apphost.ts, and aspire.config.json before running any init command, preventing duplicate skeletons. - Template Selection: Chooses among aspire-starter, aspire-ts-starter, aspire-py-starter, aspire-empty, and aspire-ts-empty based on whether the project is greenfield, Python-based, or minimal. - Non-Interactive Agent Flows: Runs aspire init --language csharp|typescript --non-interactive and aspire new <template> --non-interactive so AI agents can scaffold without prompts. - Use Case: A developer has an existing FastAPI plus React repository and wants Aspire orchestration. The Skill confirms no AppHost exists, runs aspire init --language typescript --non-interactive, then hands off to aspireify to wire the services. ## Quick Start Ask the agent to add Aspire to this repository and it will detect the missing AppHost, run the appropriate aspire init or aspire new command, and hand off wiring to aspireify.

Frequently Asked Questions about aspire-init

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

FAQPage Schema
How do I add Aspire to an existing repository?

Run aspire init with an explicit language flag, such as aspire init --language csharp --non-interactive. It drops an AppHost skeleton and aspire.config.json next to your existing code, then the aspireify skill wires your services into the AppHost.

What is the difference between aspire new and aspire init?

aspire new generates a full starter solution from a template for brand-new projects, while aspire init drops a minimal AppHost skeleton into an existing repository without modifying current project files. Use aspire new for greenfield work and aspire init when services already exist.

Which Aspire template should I use for a Python FastAPI project?

Use aspire new aspire-py-starter, which orchestrates a FastAPI service and React frontend through a TypeScript AppHost. The older dotnet new aspire-py-starter template was removed in version 13.3.

Why does aspire init fail in non-interactive mode?

aspire init fails without prompts when multiple language paths are available and no --language flag is passed. Re-run with --language csharp or --language typescript alongside --non-interactive.

Can I run aspire init if an AppHost already exists?

No. If the repo contains an AppHost .csproj, apphost.cs, apphost.ts, or aspire.config.json, do not run aspire init because it duplicates the skeleton. Route to the aspireify skill for re-wiring or aspire-orchestration for lifecycle commands instead.

What prerequisites does the Aspire CLI need?

The Aspire CLI requires the .NET 10 SDK and installs via dotnet tool install -g Aspire.Cli or the curl installer at aspire.dev. Run aspire doctor to diagnose missing prerequisites before initializing.