Agent skill

Aspire Upgrade

by CommunityToolkit in CommunityToolkit/Aspire

Update the Aspire version in the repository to the latest nightly build.

MITAuto-check passed

Install Aspire Upgrade

skills CLI

$ npx skills add CommunityToolkit/Aspire --skill aspire-upgrade -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install CommunityToolkit/Aspire aspire-upgrade --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/CommunityToolkit/Aspire.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/aspire-upgrade .claude/skills/aspire-upgrade && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "aspire-upgrade" agent skill from https://github.com/CommunityToolkit/Aspire/tree/main/.agents/skills/aspire-upgrade into .claude/skills/aspire-upgrade/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aspire-upgrade", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/CommunityToolkit/Aspire/tree/main/.agents/skills/aspire-upgrade

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add CommunityToolkit/Aspire --skill aspire-upgrade -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install CommunityToolkit/Aspire aspire-upgrade --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CommunityToolkit/Aspire.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/aspire-upgrade .agents/skills/aspire-upgrade && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "aspire-upgrade" agent skill from https://github.com/CommunityToolkit/Aspire/tree/main/.agents/skills/aspire-upgrade into .agents/skills/aspire-upgrade/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aspire-upgrade", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add CommunityToolkit/Aspire --skill aspire-upgrade -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install CommunityToolkit/Aspire aspire-upgrade --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CommunityToolkit/Aspire.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/aspire-upgrade .cursor/skills/aspire-upgrade && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "aspire-upgrade" agent skill from https://github.com/CommunityToolkit/Aspire/tree/main/.agents/skills/aspire-upgrade into .cursor/skills/aspire-upgrade/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aspire-upgrade", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/CommunityToolkit/Aspire.git --path .agents/skills/aspire-upgrade

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add CommunityToolkit/Aspire --skill aspire-upgrade -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install CommunityToolkit/Aspire aspire-upgrade --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CommunityToolkit/Aspire.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/aspire-upgrade .gemini/skills/aspire-upgrade && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "aspire-upgrade" agent skill from https://github.com/CommunityToolkit/Aspire/tree/main/.agents/skills/aspire-upgrade into .gemini/skills/aspire-upgrade/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aspire-upgrade", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install CommunityToolkit/Aspire aspire-upgrade

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add CommunityToolkit/Aspire --skill aspire-upgrade -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/CommunityToolkit/Aspire.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/aspire-upgrade .github/skills/aspire-upgrade && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "aspire-upgrade" agent skill from https://github.com/CommunityToolkit/Aspire/tree/main/.agents/skills/aspire-upgrade into .github/skills/aspire-upgrade/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aspire-upgrade", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add CommunityToolkit/Aspire --skill aspire-upgrade -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install CommunityToolkit/Aspire aspire-upgrade --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CommunityToolkit/Aspire.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/aspire-upgrade .opencode/skills/aspire-upgrade && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "aspire-upgrade" agent skill from https://github.com/CommunityToolkit/Aspire/tree/main/.agents/skills/aspire-upgrade into .opencode/skills/aspire-upgrade/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aspire-upgrade", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: aspire-upgrade
GitHub stars: 629
Token cost: ~817 tokens
SKILL.md length: 385 words
Files: 1
Skills in repo: 8
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Update the Aspire version in the repository to the latest nightly build.

Works in 5 steps: Update Directory.Build.props → Configure the AppHost SDK version in… → Update TypeScript AppHost… → …
SKILL.md covers Step 1: Update…, Step 2: Configure the AppHost…, Step 3: Update TypeScript… and Step 4: Validate the changes, plus 1 more section
Calls dotnet; reaches pkgs.dev.azure.com

What it does

Aspire Upgrade is an agent skill from CommunityToolkit/Aspire. Update the Aspire version in the repository to the latest nightly build.

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with .NET. The repository describes itself as: A community project with additional components and extensions for Aspire. The licence is MIT.

Example prompts

“/aspire-upgrade”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

Update Directory.Build.props
Configure the AppHost SDK version in global.json
Update TypeScript AppHost aspire.config.json files
Validate the changes
Create a pull request

What it can do on your machine

Read from SKILL.md and the folder at commit 69a155d. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- dotnet
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- pkgs.dev.azure.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Aspire Upgrade loads about 817 tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 385 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~22
When it runs · the whole SKILL.md, loaded when a task matches: ~817

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from CommunityToolkit/Aspire at commit 69a155d, republished under its MIT licence (© CommunityToolkit). 385 words, ~817 tokens.

Download SKILL.mdSave it as .claude/skills/aspire-upgrade/SKILL.md (or your agent's skills folder).

name: aspire-upgrade
description: Update the Aspire version in the repository to the latest nightly build.

aspire-upgrade

The target version prefix is 13.6.

aspire-upgrade

You are responsible for updating the Aspire version in our repo to the latest nightly build.

You are to use the NuGet feed https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet9/nuget/v3/index.json

Look for the latest nightly version that starts with the target version prefix above. To do this, you will need to use the .NET CLI package search feature with the --prerelease and --exact-match flags (and probably best to specify the feed with --source to avoid confusion with any stable versions from nuget.org). Query for the Aspire.AppHost.Sdk package as it is a dependency of all our AppHost projects and will be the most reliable way to find the correct version string.

Here is an example command to find the latest version:

bash

dotnet package search Aspire.AppHost.Sdk --prerelease --exact-match --source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet9/nuget/v3/index.json --format json

Parse the result for the latest version that matches the target version prefix. This will be the version you update to in the next steps.

Step 1: Update `Directory.Build.props`

Update the following values in the root Directory.Build.props file:

xml

<AspireMajorVersion>MAJOR_VERSION</AspireMajorVersion>
<AspireVersion>$(AspireMajorVersion).MINOR_VERSION.PATCH_VERSION-PREVIEW_VERSION</AspireVersion>
<AspirePreviewSuffix></AspirePreviewSuffix>

Where MAJOR_VERSION, MINOR_VERSION, PATCH_VERSION, and PREVIEW_VERSION are the respective parts of the version you found.

When using a nightly build, we want to blank out the AspirePreviewSuffix to avoid confusion with the actual preview versions.

Step 2: Configure the AppHost SDK version in `global.json`

Set the Aspire.AppHost.Sdk version in the root global.json under msbuild-sdks. This keeps the SDK package version in one place while preserving the standard project SDK reference.

json

"msbuild-sdks": {
  "Aspire.AppHost.Sdk": "VERSION"
}

Search the repository for all .csproj files that reference Aspire.AppHost.Sdk. Each AppHost project should use the standard SDK reference with no version in the project file:

xml

<Project Sdk="Aspire.AppHost.Sdk">

Show full SKILL.md (129 more words)Show less

Step 3: Update TypeScript AppHost `aspire.config.json` files

Search the entire repository for all aspire.config.json files (typically under examples/ in directories ending with .AppHost.TypeScript). Each file has an sdk.version field that must be updated to the new version.

The sdk.version value should be the full version string (e.g., 13.6.0-preview.1.26475.12).

Use a command like find . -name "aspire.config.json" to locate all files, then update the "version" value inside the "sdk" object in each one.

Step 4: Validate the changes

Run dotnet restore at the repository root to verify the new version resolves correctly. Fix any errors before proceeding.

Step 5: Create a pull request

After all changes are made and validated, create a pull request with the title "Update Aspire version to X.Y.Z" where X.Y.Z is the full version you updated to.

Files

Just SKILL.md in .agents/skills/aspire-upgrade of CommunityToolkit/Aspire.

Open the folder on GitHubat commit 69a155d

Compare with similar skills

Aspire Upgrade next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Aspire Upgrade compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Aspire Upgrade this skillCommunityToolkit/Aspire	629	—	~817	Automated safety check: Pass	MIT	yesterday
Minimax DOCXpoco-ai/poco-claw	1.4k	7 repos	~3.9k	Automated safety check: Pass	MIT	16 days ago
Microsoft Skill CreatorMicrosoftDocs/mcp	1.9k	3 repos	~2.1k	Automated safety check: Pass	CC-BY-4.0	yesterday
Speckit ConstitutionWeihanLi/WeihanLi.Common	242	11 repos	~2.1k	Automated safety check: Pass	Apache-2.0	24 days ago
Copilot Session Failure Analysisdotnet/maui	23k	—	~3.4k	Automated safety check: Pass	MIT	yesterday
Microsoft Code ReferenceMicrosoftDocs/mcp	1.9k	4 repos	~1.1k	Automated safety check: Pass	CC-BY-4.0	yesterday

Similar skills

Minimax DOCX
poco-ai/poco-claw
Professional DOCX document creation, editing, and formatting using OpenXML SDK (.NET).
1.4k GitHub starsUsed in 7 repos~3.9k tokens
Documents & OfficeAuto-check passed
Microsoft Skill Creator
MicrosoftDocs/mcp
Official
Create agent skills for Microsoft technologies using official documentation.
1.9k GitHub starsUsed in 3 repos~2.1k tokens
Agent WorkflowsAuto-check passed
Speckit Constitution
WeihanLi/WeihanLi.Common
Create or update the project constitution from interactive or provided principle inputs, ensuring all dependent templates stay in sync.
242 GitHub starsUsed in 11 repos~2.1k tokens
DevelopmentAuto-check passed
Copilot Session Failure Analysis
dotnet/maui
Official
Mines local Copilot CLI session logs for dotnet/maui to rank costly or failing runs, tag recurring failure modes, propose repo edits and emit guard evals.
23k GitHub stars~3.4k tokensUpdated yesterday
Agent WorkflowsAuto-check passed
Microsoft Code Reference
MicrosoftDocs/mcp
Official
Find working code samples, verify API signatures, and fix Microsoft SDK errors using official docs.
1.9k GitHub starsUsed in 4 repos~1.1k tokens
DevelopmentAuto-check passed
Update .NET OS Packages
dotnet/core
Official
Audits and updates os-packages.json files listing the Linux packages each .NET release needs per distro, then regenerates the Markdown from the JSON.
22k GitHub stars~2.3k tokensUpdated yesterday
DevelopmentAuto-check passed

More from CommunityToolkit/Aspire

All 8 skills in this repo

Dotnet Inspect
CommunityToolkit/Aspire
Query .NET APIs across NuGet packages, platform libraries, and local files.
629 GitHub starsUsed in 2 repos~1.5k tokens
Auto-check passed
Aspire Monitoring
CommunityToolkit/Aspire
ANALYSIS SKILL - Observe Aspire apps: logs, traces, metrics, resource state, telemetry export, browser telemetry, and the standalone dashboard.
629 GitHub stars~3.5k tokensUpdated yesterday
Auto-check passed
Aspireify
CommunityToolkit/Aspire
WORKFLOW SKILL - Wire Aspire AppHosts or repair TypeScript AppHost toolchains.
629 GitHub stars~5.3k tokensUpdated yesterday
Auto-check: notes
Aspire Deployment
CommunityToolkit/Aspire
WORKFLOW SKILL — Deploy Aspire apps from AppHost models to Docker Compose, Kubernetes, Azure, AWS, or preview Radius.
629 GitHub stars~4.5k tokensUpdated yesterday
Auto-check: notes
Aspire Project V2 Migration
CommunityToolkit/Aspire
WORKFLOW SKILL - Safely migrates eligible Aspire 13.6+ AppHosts from legacy ProjectResource APIs to experimental DotnetProjectResource APIs after a per-resource assessment and explicit approval of…
629 GitHub stars~3.4k tokensUpdated yesterday
Auto-check passed
Aspire Typescript Apphost
CommunityToolkit/Aspire
Generate a TypeScript AppHost from an existing C example AppHost, then add a TypeScriptAppHostTest-based integration test.
629 GitHub stars~739 tokensUpdated yesterday
Auto-check passed

Works with

.NET

Questions about Aspire Upgrade

What does Aspire Upgrade do?

Update the Aspire version in the repository to the latest nightly build. Aspire Upgrade is an agent skill from CommunityToolkit/Aspire. Update the Aspire version in the repository to the latest nightly build.

How do I install Aspire Upgrade in Claude Code?

Run `npx skills add CommunityToolkit/Aspire --skill aspire-upgrade -a claude-code`. Or copy the skill folder (.agents/skills/aspire-upgrade in CommunityToolkit/Aspire) into .claude/skills/aspire-upgrade in your project. Claude Code loads it when a task matches its description.

How do I install Aspire Upgrade in Codex?

Run `npx skills add CommunityToolkit/Aspire --skill aspire-upgrade -a codex`. Or copy the skill folder (.agents/skills/aspire-upgrade in CommunityToolkit/Aspire) into .agents/skills/aspire-upgrade in your project. Codex loads it when a task matches its description.

Can I use Aspire Upgrade in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add CommunityToolkit/Aspire --skill aspire-upgrade -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/aspire-upgrade, .gemini/skills/aspire-upgrade, .github/skills/aspire-upgrade and .opencode/skills/aspire-upgrade in your project.

What does Aspire Upgrade need to run?

Going by SKILL.md and its folder, Aspire Upgrade needs the command-line tools its instructions call (dotnet).

Does Aspire Upgrade access the network?

SKILL.md names 1 domain. In commands or code: pkgs.dev.azure.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Aspire Upgrade safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Aspire Upgrade use?

Aspire Upgrade is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Aspire Upgrade use?

About 817 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Aspire Upgrade?

Skills that share tags, products or a category with Aspire Upgrade: Minimax DOCX (poco-ai/poco-claw, 1.4k stars), Microsoft Skill Creator (MicrosoftDocs/mcp, 1.9k stars), Speckit Constitution (WeihanLi/WeihanLi.Common, 242 stars) and Copilot Session Failure Analysis (dotnet/maui, 23k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Aspire Upgrade?

CommunityToolkit (a GitHub organization) maintains it in CommunityToolkit/Aspire, which has 629 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 7, 2026.

Source: CommunityToolkit/Aspire on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Aspire Upgrade

Facts

At a glance

What it does

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

aspire-upgrade

aspire-upgrade

Step 1: Update Directory.Build.props

Step 2: Configure the AppHost SDK version in global.json

Step 3: Update TypeScript AppHost aspire.config.json files

Step 4: Validate the changes

Step 5: Create a pull request

Files

Compare with similar skills

Similar skills

More from CommunityToolkit/Aspire

Related

Questions about Aspire Upgrade

Step 1: Update `Directory.Build.props`

Step 2: Configure the AppHost SDK version in `global.json`

Step 3: Update TypeScript AppHost `aspire.config.json` files