microsoft / aspire

✓ Official★ 6,100

A skill package that teaches your agent 17 capabilities — every one documented and browsable below, no GitHub required · by microsoft.

Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.

api-review🔥🔥✓ Verified🔒 repo maintenanceFreeQuick setup

Reviews .NET API surface area PRs for design guideline violations. Analyzes api/*.cs file diffs, applies review rules from .NET Framework Design Guidelines and…

1 file — installable on its own

→

aspire🔥🔥🔥✓ VerifiedFreeQuick setup

Use this skill when the user is working with an Aspire distributed application and needs to operate the AppHost or its resources through the Aspire CLI: start,…

3 files — installable on its own

→

backport-pr🔥🔥✓ Verified🔒 repo maintenanceFreeQuick setup

Backports a merged PR to a release branch by triggering the /backport bot, waiting for the bot-created PR, and filling in the shiproom template (Customer…

1 file — installable on its own

→

ci-test-failures🔥🔥✓ Verified🔒 repo maintenanceFreeQuick setup

Guide for diagnosing GitHub Actions test failures, extracting failed tests from runs, and creating or updating failing-test issues. Use this when asked to…

1 file — installable on its own

→

cli-e2e-testing🔥🔥✓ Verified🔒 repo maintenanceFreeQuick setup

Guide for writing Aspire CLI end-to-end tests using Hex1b terminal automation. Use this when asked to create, modify, or debug CLI E2E tests.

2 files — installable on its own

→

connection-properties🔥🔥✓ Verified🔒 repo maintenanceFreeQuick setup

Specialized agent for creating and improving Connection Properties in Aspire resource and README files

1 file — installable on its own

→

create-pr🔥🔥🔥✓ VerifiedFreeQuick setup

Create a pull request using the repository PR template. Use when asked to: create PR, open PR, push and create PR, submit PR, open pull request, send changes…

1 file — installable on its own

→

dashboard-testing🔥🔥✓ Verified🔒 repo maintenanceFreeQuick setup

Guide for writing tests for the Aspire Dashboard. Use this when asked to create, modify, or debug dashboard unit tests or Blazor component tests.

1 file — installable on its own

→

dependency-update🔥🔥✓ Verified🔒 repo maintenanceFreeQuick setup

Guides dependency version updates by checking nuget.org for latest versions, triggering the dotnet-migrate-package Azure DevOps pipeline, and monitoring runs.…

4 files — installable on its own

→

deployment-e2e-testing🔥🔥✓ Verified🔒 repo maintenanceFreeQuick setup

Guide for writing Aspire deployment end-to-end tests. Use this when asked to create, modify, or debug deployment E2E tests that deploy to Azure.

1 file — installable on its own

→

fix-flaky-test🔥🔥✓ Verified🔒 repo maintenanceFreeQuick setup

Reproduces and fixes flaky or quarantined tests. Tries local reproduction first (fast), then falls back to CI reproduce workflow (reproduce-flaky-tests.yml).…

3 files — installable on its own

→

hex1b🔥🔥🔥✓ VerifiedFreeQuick setup

CLI tool for automating any terminal application — TUI apps, shells, CLI tools, REPLs, and more. Use when you need to launch a process in a virtual terminal,…

1 file — installable on its own

→

pr-testing🔥🔥✓ Verified🔒 repo maintenanceFreeQuick setup

Downloads and tests Aspire CLI from a PR build, preferably in the repo-local container runner under eng/scripts, verifies version, and runs test scenarios…

2 files — installable on its own

→

reviewing-aspire-architecture🔥🔥✓ Verified🔒 repo maintenanceFreeQuick setup

Triggers deep architectural review across 15 Aspire-specific dimensions. Activated by requests for deep review, architectural review, pattern review, or PRs…

1 file — installable on its own

→

startup-perf🔥🔥✓ Verified🔒 repo maintenanceFreeQuick setup

Measures Aspire application startup performance using dotnet-trace and the TraceAnalyzer tool. Use this when asked to measure impact of a code change on Aspire…

1 file — installable on its own

→

test-management🔥🔥✓ Verified🔒 repo maintenanceFreeQuick setup

Quarantines or disables flaky/problematic tests using the QuarantineTools utility

1 file — installable on its own

→

update-container-images🔥🔥✓ Verified🔒 repo maintenanceFreeQuick setup

Updates Docker container image tags used by Aspire hosting integrations. Queries registries for newer tags, uses LLM to determine version-compatible updates,…

4 files — installable on its own

→

Aspire

What is Aspire?

Aspire is a multi-language, code-first toolchain for building, running, and deploying distributed applications.

Describe how services, frontends, containers, databases, caches, and connections fit together in code. The Aspire CLI runs the whole app locally, exposes OpenTelemetry-based observability, and carries the same definition into deployment.

A simple app definition

The same application definition can be written in different languages.

C# (apphost.cs)

Copy & paste — that's it

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache");

var api = builder.AddNodeApp("api", "./api", "src/index.ts")
    .WithReference(cache)
    .WaitFor(cache)
    .WithHttpEndpoint(env: "PORT")
    .WithExternalHttpEndpoints();

builder.AddViteApp("frontend", "./frontend")
    .WithReference(api)
    .WaitFor(api);

builder.Build().Run();

TypeScript (apphost.ts)

Copy & paste — that's it

import { createBuilder } from './.aspire/modules/aspire.js';

const builder = await createBuilder();

const cache = await builder.addRedis("cache");

const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withReference(cache)
    .waitFor(cache)
    .withHttpEndpoint({ env: "PORT" })
    .withExternalHttpEndpoints();

await builder
    .addViteApp("frontend", "./frontend")
    .withReference(api)
    .waitFor(api);

await builder.build().run();

Getting started

Install the Aspire CLI

To install the latest released version of the Aspire CLI:

On Windows:

Copy & paste — that's it

irm https://aspire.dev/install.ps1 | iex

On Linux or macOS:

Copy & paste — that's it

curl -sSL https://aspire.dev/install.sh | bash

[!NOTE] If you want to use the latest daily builds instead of the released version, follow the instructions in docs/using-latest-daily.md.

Useful links

What is in this repo?

This repo contains the Aspire CLI, AppHost SDK, dashboard, service discovery infrastructure, project templates, integrations, and VS Code Extension.

Contributing

Follow docs/contributing.md for working in the repository.

Reporting security issues and security bugs

Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) secure@microsoft.com. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter. You can also find these instructions in this repo's Security doc.

Note on containers used by Aspire resource and client integrations

The Aspire team cannot evaluate the underlying third-party containers for which it provides API support for suitability for specific customer requirements.

You should evaluate whichever containers you chose to compose and automate with Aspire to ensure they meet your, your employers or your government’s requirements on security and safety as well as cryptographic regulations and any other regulatory or corporate standards that may apply to your use of the container.

License

The code in this repo is licensed under the MIT license.

Install the whole package (17 skills):

Copy & paste — that's it

npx skills add https://github.com/microsoft/aspire

Or install a single skill:

Copy & paste — that's it

npx skills add https://github.com/microsoft/aspire --skill <name>

Pick the skill name from the Skills tab — each entry there installs independently.