aspire-skills
Microsoft Aspire skills marketplace — agent skills for Aspire distributed application development with the Aspire CLI.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/microsoft--aspire-skills)HTML
<a href="/listings/microsoft--aspire-skills"><img src="/api/listings/microsoft--aspire-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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 in Aspire 13.6 and earlier. In Aspire 17.0 and later, it registers the aspire-skills plugin in agent settings instead. 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 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
In Aspire 17.0 and later, pass `--scope project` (default) or `--scope global`. The default source is the [`microsoft/aspire-skills` repository](https://github.com/microsoft/aspire-skills). Aspire `skillSources` settings can add, override, or disable sources, so review each source before you enable it. Skills copied by older CLIs can take precedence. Run `aspire doctor` to find them. See also [Automatic updates and version pinning](#automatic-updates-and-version-pinning).
**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](https://gh.io/app) installed. - A GitHub Copilot subscription (paid or free).
**Install the plugin:**
1. Click [this link](https://github.com/copilot/app/launch?entry_point=aspire_skills_docs&open=ghapp%3A%2F%2Fplugins%2Fmarketplace%2Fadd%3Fsource%3Dmicrosoft%2Faspire-skills) 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](https://github.com/microsoft/apm), then start OpenCode:**
apm install microsoft/aspire-skills opencode
Skill catalogs
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 48 lines
- {
- "name": "aspire-skills",
- "owner": {
- "name": "Microsoft",
- "url": "https://www.microsoft.com"
- },
- "description": "Microsoft Aspire skills marketplace — agent skills for Aspire distributed application development with the Aspire CLI.",
- "homepage": "https://github.com/microsoft/aspire-skills",
- "repository": "https://github.com/microsoft/aspire-skills",
- "license": "MIT",
- "plugins": [
- {
- "name": "aspire",
- "source": "./",
- "description": "Aspire skills plugin for AI coding agents. Eight skills covering routing, init, AppHost wiring, Project v2 migration, lifecycle, deployment, observability, and terminals. Includes Aspire 13.6+ Project v2 migration guidance.",
- "version": "0.0.6",
- "author": {
- "name": "Microsoft",
- "url": "https://www.microsoft.com"
- },
- "homepage": "https://github.com/microsoft/aspire-skills",
- "repository": "https://github.com/microsoft/aspire-skills",
- "license": "MIT",
- "category": "developer-tools",
- "keywords": [
- "aspire",
- "dotnet",
- "cloud-native",
- "orchestration",
- "observability",
- "deployment",
- "microsoft"
- ],
- "tags": [
- "aspire",
- "dotnet",
- "cloud-native",
- "azure",
- "kubernetes",
- "docker-compose"
- ],
- "policy": {
- "installation": "AVAILABLE",
- "authentication": "ON_INSTALL"
- }
- }
- ]
- }
README.md · README · 309 lines
- # 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 |
- | `aspire-terminals` | Authors resource/dock/dialog/headless terminals, reuses REPLs, and automates terminal input and VHS-subset tapes |
- `aspire-terminals` covers Aspire 13.5 resource terminals and capability-gated
- 13.6 terminal services, prompts, REPLs and tape playback. Its
- [tape reference](skills/aspire-terminals/references/tapes.md) documents Aspire's
- supported VHS syntax and plain-text output formats, not all upstream VHS features.
- ### 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 in Aspire 13.6 and earlier. In Aspire 17.0 and later, it registers the aspire-skills plugin in agent settings instead. 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 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:
- ```bash
- aspire new
- ```
- **Add Aspire to an existing repository** and opt into agent guidance when prompted:
- ```bash
- aspire init
- ```
- **Add, update, or reconfigure agent guidance** in an existing Aspire workspace:
- ```bash
- aspire agent init
- ```
- In Aspire 17.0 and later, pass `--scope project` (default) or `--scope global`. The default
- source is the [`microsoft/aspire-skills` repository](https://github.com/microsoft/aspire-skills).
- Aspire `skillSources` settings can add, override, or disable sources, so review each source
- before you enable it. Skills copied by older CLIs can take precedence. Run `aspire doctor` to
- find them. See also [Automatic updates and version pinning](#automatic-updates-and-version-pinning).
- **Configure the Aspire MCP server** only when you want it (Aspire 13.6+):
- ```bash
- 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](https://gh.io/app) installed.
- - A GitHub Copilot subscription (paid or free).
- **Install the plugin:**
- 1. Click [this link](https://github.com/copilot/app/launch?entry_point=aspire_skills_docs&open=ghapp%3A%2F%2Fplugins%2Fmarketplace%2Fadd%3Fsource%3Dmicrosoft%2Faspire-skills)
- 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):
- ```text
- /plugin marketplace add microsoft/aspire-skills
- ```
- **Install the plugin:**
- ```text
- /plugin install aspire@aspire-skills
- ```
- **Update the plugin:**
- ```text
- /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):
- ```text
- /plugin marketplace add microsoft/aspire-skills
- ```
- **Install the plugin:**
- ```text
- /plugin install aspire@aspire-skills
- ```
- **Update the plugin:**
- ```text
- /plugin update aspire@aspire-skills
- ```
- ### Gemini CLI
- **Install the extension:**
- ```bash
- gemini extensions install https://github.com/microsoft/aspire-skills
- ```
- ### Cursor CLI
- **Install the skills:**
- ```bash
- mkdir -p ~/.cursor/skills
- git clone https://github.com/microsoft/aspire-skills ~/.cursor/skills/aspire-skills
- ```
- **Start Cursor CLI:**
- ```bash
- agent
- ```
- ### Codex CLI
- **Add the marketplace** (first time only):
- ```bash
- 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](https://github.com/microsoft/apm), then start OpenCode:**
- ```bash
- apm install microsoft/aspire-skills
- opencode
- ```
- #### Skill catalogs
- As an alternative to APM, configure OpenCode to load the skills directly from
- an HTTP catalog. Add the configuration for your OpenCode version to
- `opencode.json` or `opencode.jsonc`, preserving any existing settings.
- **OpenCode V2:**
- ```json
- {
- "$schema": "https://opencode.ai/config.json",
- "skills": [
- "https://raw.githubusercontent.com/microsoft/aspire-skills/main/opencode/v2/"
- ]
- }
- ```
- **OpenCode V1:**
- ```json
- {
- "$schema": "https://opencode.ai/config.json",
- "skills": {
- "urls": [
- "https://raw.githubusercontent.com/microsoft/aspire-skills/main/opencode/v1/"
- ]
- }
- }
- ```
- See OpenCode's [skill sources documentation](https://opencode.ai/v2/docs/skills#sources)
- for configuration guidance.
- ### Ollama + Copilot CLI
- **Launch Copilot with Ollama:**
- ```bash
- ollama launch copilot
- ```
- In the Copilot session that opens, run the `/plugin` commands from
- [GitHub Copilot CLI](#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:**
- ```bash
- npx skills add microsoft/aspire-skills
- ```
- For hosts that need an explicit skills directory and target agent, install from the `skills/` folder:
- ```bash
- 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.
- ## Automatic updates and version pinning
- The Aspire CLI registers skill sources but does not fetch or update their
- content. Agent clients handle acquisition and updates. Aspire preserves matching
- registrations and existing client-side pins when you run `aspire agent init`.
- Re-running the command does not move a pin to a newer version.
- If your agent client supports automatic updates, keep them enabled to receive
- security and bug fixes.
- If your client supports pinning, you can pin a release tag or specific version
- instead. Monitor security notices and update the pin manually to receive fixes.
- ## Repository layout
- | Path | Purpose |
- |------|---------|
- | `skills/` | Source skill files, references, and evals |
- | `opencode/` | Generated OpenCode V1 and V2 skill catalogs |
- | `docs/` | Documentation |
- | `extensions/` | Source GitHub Copilot app canvas extensions |
- | `.plugin/`, `.claude-plugin/`, `.cursor-plugin/` | Plugin metadata for marketplaces |
- | `.github/plugins/aspire-skills/` | Published plugin mirror |
- | `evals/` | Shared evaluation fixtures and helpers |
- Aspire CLI owns agent telemetry hooks and their tests in `microsoft/aspire`.
- The plugins do not register telemetry hooks.
- ## Development
- Regenerate the OpenCode catalogs after changing shipped skills, references, or
- assets, and commit the output with the source changes:
- ```bash
- npm run catalog
- npm run catalog:check
- ```
- The catalog check verifies that the committed V1 and V2 catalogs match the
- committed skill source, including file lists and SHA-512 content versions.
- ### Publishing releases
- Merging a same-repository `release/<version>` PR into `main` runs
- [the publisher](.github/workflows/publish.yml). It tags the exact merged commit,
- copies the approved changelog notes into a source-only GitHub release, and uploads
- no generated archives. It uses `GITHUB_TOKEN`, not a repo bot or stored personal
- token. Reruns preserve the tag's commit and notes.
- See [the development guide](docs/development.md) for the release flow.
- ## Contributing
- See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
- See the [development guide](docs/development.md) for local development.
- ## License
- [MIT](LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.