Skip to content
Projects

microsoft/aspire-skills has 94 GitHub stars and 12 forks. GitHot measured 0 stars in 24 hours, +1 in 7 days, and +1 in 15 days. Last checked 2026-11-15 16:30 UTC. Last push 2026-11-15.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
+1
in 15 days
+1
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Official Aspire skills and plugins for AI coding agents to initialize, wire, orchestrate, monitor, and deploy distributed apps.

Developer Tools

README.md

Original

Aspire Skills

Aspire Skills is a plugin, skill pack, and extension pack for AI coding agents working on Aspire distributed applications.

It helps agents recognize Aspire workspaces, use the Aspire CLI correctly, route common work to focused skills instead of ad hoc dotnet, curl, Docker, or shell workflows, and surface focused visual tools for Aspire-specific tasks.

What's included

Skills

Skill Purpose
aspire Top-level router for Aspire projects
aspire-init Creates a new Aspire project or adds an Aspire skeleton to an existing repo
aspireify Wires a new AppHost or extends an existing application graph
aspire-project-v2-migration Assesses and migrates eligible Aspire 13.6+ legacy project resources to Project v2 after explicit edit approval
aspire-orchestration Starts, stops, waits for, and manages Aspire resources
aspire-deployment Publishes, deploys, and tears down Aspire apps
aspire-monitoring Routes logs, traces, dashboard, telemetry, and diagnostics work

Extensions

Extension Purpose
aspire-doctor Visualizes aspire doctor environment checks, suggested fixes, and detected CLI installations
aspireify Presents Aspireify findings and the proposed resource plan for confirmation before AppHost edits
aspire-apphosts Workspace and Global AppHost workbench

Install

Choose the path that matches your agent host.

Aspire CLI

Aspire's first-party agent setup installs Aspire skill files and extension files into detected agent environments. Aspire MCP server configuration is separate and opt-in.

  • In Aspire 13.6 and later, the agent setup that aspire new and aspire init run preselects the recommended repository-local skills, including aspireify. It doesn't offer MCP configuration.
  • Standalone aspire agent init keeps an MCP choice that's off by default. It doesn't configure MCP in non-interactive runs unless you pass --mcp.

Create a new Aspire app and opt into agent guidance when prompted:

aspire new

Add Aspire to an existing repository and opt into agent guidance when prompted:

aspire init

Add, update, or reconfigure agent guidance in an existing Aspire workspace:

aspire agent init

Configure the Aspire MCP server only when you want it (Aspire 13.6+):

aspire agent init --mcp

In Aspire 13.5, run aspire agent init interactively and select the MCP server option; 13.5 has no --mcp flag.

GitHub Copilot app

The GitHub Copilot app plugin installs Aspire skills and canvas extensions for the current user.

Prerequisites:

Install the plugin:

  1. Click this link to automatically open the Settings > Plugins window in the GitHub Copilot app.
  2. In the Add plugin marketplace? dialog, select Allow.
  3. The Plugins window opens with the microsoft/aspire-skills marketplace. Select Add marketplace.
  4. Expand the aspire-skills entry and select Install on the aspire plugin.

GitHub Copilot CLI

Start Copilot CLI with copilot, then run the following commands inside it.

Add the marketplace (first time only):

/plugin marketplace add microsoft/aspire-skills

Install the plugin:

/plugin install aspire@aspire-skills

Update the plugin:

/plugin update aspire@aspire-skills

Claude Code

Start Claude Code with claude, then run the following commands inside it.

Add the marketplace (first time only):

/plugin marketplace add microsoft/aspire-skills

Install the plugin:

/plugin install aspire@aspire-skills

Update the plugin:

/plugin update aspire@aspire-skills

Gemini CLI

Install the extension:

gemini extensions install https://github.com/microsoft/aspire-skills

Cursor CLI

Install the skills:

mkdir -p ~/.cursor/skills
git clone https://github.com/microsoft/aspire-skills ~/.cursor/skills/aspire-skills

Start Cursor CLI:

agent

Codex CLI

Add the marketplace (first time only):

codex plugin marketplace add microsoft/aspire-skills

Install the plugin:

Start Codex with codex, run /plugins, and install aspire from the aspire-skills marketplace.

OpenCode

Install using APM, then start OpenCode:

apm install microsoft/aspire-skills
opencode

Ollama + Copilot CLI

Launch Copilot with Ollama:

ollama launch copilot

In the Copilot session that opens, run the /plugin commands from GitHub Copilot CLI above to add the marketplace and install or update aspire.

skills.sh via NPX

Use the Skills-compatible installer when your agent host supports skills.sh-managed skill locations.

Install the skills:

npx skills add microsoft/aspire-skills

For hosts that need an explicit skills directory and target agent, install from the skills/ folder:

npx skills add https://github.com/microsoft/aspire-skills/tree/main/skills \
  -a github-copilot -g -y

In that command, -a github-copilot selects the target agent, -g installs globally, and -y accepts prompts.

Repository layout

Path Purpose
skills/ Source skill files, references, and evals
docs/ Documentation
extensions/ Source GitHub Copilot app canvas extensions
hooks/scripts/ Canonical Aspire CLI agent telemetry hooks
.plugin/, .claude-plugin/, .cursor-plugin/ Plugin metadata for marketplaces
.github/plugins/aspire-skills/ Published plugin mirror
evals/ Shared evaluation fixtures and helpers

Development

npm run bundle

npm run bundle builds both bundle artifacts:

Artifact Contents
aspire-skills-v<version>.tgz Agent skill files, canonical telemetry hooks, and skill-manifest.json with hook commit/SHA-512 provenance
aspire-extensions-v<version>.tgz GitHub Copilot app canvas extension files and extension-manifest.json

The skills manifest records the release commit and LF-normalized SHA-512 hash for each file under hooks/scripts/. Downstream consumers can copy the hooks object directly instead of maintaining hook provenance separately.

The hooks attribute AI_AGENT=github_copilot_app_agent to copilot-app before checking COPILOT_CLI=1 or a CLI-compatible toolArgs payload. Without the app marker, Copilot CLI, VS Code, and Claude Code attribution stays unchanged.

Use npm run bundle:skills or npm run bundle:extensions to build one bundle type.

Both archives declare Aspire CLI/SDK compatibility with >=13.5.0 <13.7.0. Individual features can have narrower requirements: aspire-project-v2-migration remains discoverable on 13.5 but refuses edits unless the actual AppHost targets 13.6+ and exposes the required APIs. Bundle compatibility never authorizes an implicit application upgrade, downgrade, or migration. Guidance and examples labeled 13.5.3 remain specific to the 13.5 family.

For a separately validated release target, the bundle generator accepts --supports-aspire-cli and --supports-aspire-sdk overrides for both archives. Current Aspire consumers check the skills archive's range as a whole; the manifest does not provide per-skill installation-time version filtering.

Publishing releases

Merging a same-repository release/<version> PR into main runs the publisher. It tags the exact merged commit, copies the approved changelog notes into the GitHub release, builds and attests both bundles, and uploads only the skills bundle. It uses GITHUB_TOKEN, not a repo bot or stored personal token. Reruns preserve the tag's commit and notes. See the development guide for the release flow.

Contributing

See CONTRIBUTING.md for contribution guidelines. See the development guide for local development.

License

MIT