aspire-init

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

Updated Jul 2, 2026
One-click install
npx skills add https://github.com/ecoDriverltd/FoundryAgentsExperiment --skill aspire-init-ecodriverltd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aspire-init
Source: https://github.com/ecoDriverltd/FoundryAgentsExperiment/tree/main/.agents/skills/aspire-init
Command: npx skills add https://github.com/ecoDriverltd/FoundryAgentsExperiment --skill aspire-init-ecodriverltd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Adding Aspire orchestration to a repository requires choosing between greenfield templates and existing-repo initialization, detecting whether an AppHost already exists, and knowing which follow-up steps handle resource wiring. This Skill automates that first-run decision flow so the correct skeleton is dropped without duplicating existing AppHosts. ## Core Features & Use Cases - AppHost Detection: Checks for existing C#, file-based, and TypeScript AppHosts plus aspire.config.json before running any init command, preventing duplicate skeletons. - Template Selection: Chooses between aspire new templates (aspire-starter, aspire-ts-starter, aspire-py-starter, empty variants) for greenfield projects or aspire init for existing repositories. - Handoff Orchestration: Routes to the aspireify skill for resource wiring and aspire-orchestration for validation after the skeleton is in place. - Use Case: A developer has an existing Express API and .NET backend in one repo and wants Aspire orchestration. The Skill confirms no AppHost exists, runs aspire init with the chosen language, and hands off to aspireify to wire the services. ## Quick Start Add Aspire to my existing repository by scaffolding an AppHost skeleton and then wiring up my services.

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. This drops a minimal AppHost skeleton and aspire.config.json next to your existing code, then the aspireify skill handles resource wiring.

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 for repos that already contain services.

What Aspire starter templates are available?▼

Templates include aspire-starter (ASP.NET Core/Blazor), aspire-ts-cs-starter (React frontend), aspire-py-starter (FastAPI with a TypeScript AppHost), aspire-ts-starter (Express/React), and empty variants aspire-empty and aspire-ts-empty with no pre-wired resources.

Can I run aspire init if an AppHost already exists?▼

No. If any AppHost signal exists, such as a .csproj with Aspire.AppHost.Sdk, an apphost.cs or apphost.ts file, or aspire.config.json, do not run aspire init. Route to the aspireify skill for re-wiring or aspire-orchestration for lifecycle operations instead.

Why does aspire init fail in non-interactive mode?▼

aspire init fails in non-interactive mode when multiple language paths are available and no --language flag is provided. Re-run with --language csharp or --language typescript to resolve it.

Does aspire init wire up my services automatically?▼

No. aspire init only drops the AppHost skeleton, aspire.config.json, and installs the aspireify agent skill. Resource wiring, references, and integrations are handled afterward by the aspireify skill, then validated with aspire start.