microsoft/aspire-skills
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.
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 ToolsREADME.md
OriginalAspire 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 newandaspire initrun preselects the recommended repository-local skills, includingaspireify. It doesn't offer MCP configuration. - Standalone
aspire agent initkeeps 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:
- GitHub Copilot app installed.
- A GitHub Copilot subscription (paid or free).
Install the plugin:
- Click this link to automatically open the Settings > Plugins window in the GitHub Copilot app.
- In the Add plugin marketplace? dialog, select Allow.
- The Plugins window opens with the
microsoft/aspire-skillsmarketplace. Select Add marketplace. - Expand the
aspire-skillsentry and select Install on theaspireplugin.
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.