Skip to content
Back to search

aspire-skills

MarketplaceWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/microsoft--aspire-skills/badge.svg)](/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
  1. {
  2. "name": "aspire-skills",
  3. "owner": {
  4. "name": "Microsoft",
  5. "url": "https://www.microsoft.com"
  6. },
  7. "description": "Microsoft Aspire skills marketplace — agent skills for Aspire distributed application development with the Aspire CLI.",
  8. "homepage": "https://github.com/microsoft/aspire-skills",
  9. "repository": "https://github.com/microsoft/aspire-skills",
  10. "license": "MIT",
  11. "plugins": [
  12. {
  13. "name": "aspire",
  14. "source": "./",
  15. "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.",
  16. "version": "0.0.6",
  17. "author": {
  18. "name": "Microsoft",
  19. "url": "https://www.microsoft.com"
  20. },
  21. "homepage": "https://github.com/microsoft/aspire-skills",
  22. "repository": "https://github.com/microsoft/aspire-skills",
  23. "license": "MIT",
  24. "category": "developer-tools",
  25. "keywords": [
  26. "aspire",
  27. "dotnet",
  28. "cloud-native",
  29. "orchestration",
  30. "observability",
  31. "deployment",
  32. "microsoft"
  33. ],
  34. "tags": [
  35. "aspire",
  36. "dotnet",
  37. "cloud-native",
  38. "azure",
  39. "kubernetes",
  40. "docker-compose"
  41. ],
  42. "policy": {
  43. "installation": "AVAILABLE",
  44. "authentication": "ON_INSTALL"
  45. }
  46. }
  47. ]
  48. }
README.md · README · 309 lines
  1. # Aspire Skills
  2. Aspire Skills is a plugin, skill pack, and extension pack for AI coding agents working on Aspire distributed applications.
  3. 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.
  4. ## What's included
  5. ### Skills
  6. | Skill | Purpose |
  7. |-------|---------|
  8. | `aspire` | Top-level router for Aspire projects |
  9. | `aspire-init` | Creates a new Aspire project or adds an Aspire skeleton to an existing repo |
  10. | `aspireify` | Wires a new AppHost or extends an existing application graph |
  11. | `aspire-project-v2-migration` | Assesses and migrates eligible Aspire 13.6+ legacy project resources to Project v2 after explicit edit approval |
  12. | `aspire-orchestration` | Starts, stops, waits for, and manages Aspire resources |
  13. | `aspire-deployment` | Publishes, deploys, and tears down Aspire apps |
  14. | `aspire-monitoring` | Routes logs, traces, dashboard, telemetry, and diagnostics work |
  15. | `aspire-terminals` | Authors resource/dock/dialog/headless terminals, reuses REPLs, and automates terminal input and VHS-subset tapes |
  16. `aspire-terminals` covers Aspire 13.5 resource terminals and capability-gated
  17. 13.6 terminal services, prompts, REPLs and tape playback. Its
  18. [tape reference](skills/aspire-terminals/references/tapes.md) documents Aspire's
  19. supported VHS syntax and plain-text output formats, not all upstream VHS features.
  20. ### Extensions
  21. | Extension | Purpose |
  22. |-----------|---------|
  23. | `aspire-doctor` | Visualizes `aspire doctor` environment checks, suggested fixes, and detected CLI installations |
  24. | `aspireify` | Presents Aspireify findings and the proposed resource plan for confirmation before AppHost edits |
  25. | `aspire-apphosts` | Workspace and Global AppHost workbench |
  26. ## Install
  27. Choose the path that matches your agent host.
  28. ### Aspire CLI
  29. 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.
  30. - 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.
  31. - 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`.
  32. **Create a new Aspire app** and opt into agent guidance when prompted:
  33. ```bash
  34. aspire new
  35. ```
  36. **Add Aspire to an existing repository** and opt into agent guidance when prompted:
  37. ```bash
  38. aspire init
  39. ```
  40. **Add, update, or reconfigure agent guidance** in an existing Aspire workspace:
  41. ```bash
  42. aspire agent init
  43. ```
  44. In Aspire 17.0 and later, pass `--scope project` (default) or `--scope global`. The default
  45. source is the [`microsoft/aspire-skills` repository](https://github.com/microsoft/aspire-skills).
  46. Aspire `skillSources` settings can add, override, or disable sources, so review each source
  47. before you enable it. Skills copied by older CLIs can take precedence. Run `aspire doctor` to
  48. find them. See also [Automatic updates and version pinning](#automatic-updates-and-version-pinning).
  49. **Configure the Aspire MCP server** only when you want it (Aspire 13.6+):
  50. ```bash
  51. aspire agent init --mcp
  52. ```
  53. In Aspire 13.5, run `aspire agent init` interactively and select the MCP server option; 13.5 has no `--mcp` flag.
  54. ### GitHub Copilot app
  55. The GitHub Copilot app plugin installs Aspire skills and canvas extensions for
  56. the current user.
  57. **Prerequisites:**
  58. - [GitHub Copilot app](https://gh.io/app) installed.
  59. - A GitHub Copilot subscription (paid or free).
  60. **Install the plugin:**
  61. 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)
  62. to automatically open the **Settings** > **Plugins** window in the GitHub
  63. Copilot app.
  64. 2. In the **Add plugin marketplace?** dialog, select **Allow**.
  65. 3. The **Plugins** window opens with the `microsoft/aspire-skills` marketplace.
  66. Select **Add marketplace**.
  67. 4. Expand the `aspire-skills` entry and select **Install** on the `aspire`
  68. plugin.
  69. ### GitHub Copilot CLI
  70. Start Copilot CLI with `copilot`, then run the following commands inside it.
  71. **Add the marketplace** (first time only):
  72. ```text
  73. /plugin marketplace add microsoft/aspire-skills
  74. ```
  75. **Install the plugin:**
  76. ```text
  77. /plugin install aspire@aspire-skills
  78. ```
  79. **Update the plugin:**
  80. ```text
  81. /plugin update aspire@aspire-skills
  82. ```
  83. ### Claude Code
  84. Start Claude Code with `claude`, then run the following commands inside it.
  85. **Add the marketplace** (first time only):
  86. ```text
  87. /plugin marketplace add microsoft/aspire-skills
  88. ```
  89. **Install the plugin:**
  90. ```text
  91. /plugin install aspire@aspire-skills
  92. ```
  93. **Update the plugin:**
  94. ```text
  95. /plugin update aspire@aspire-skills
  96. ```
  97. ### Gemini CLI
  98. **Install the extension:**
  99. ```bash
  100. gemini extensions install https://github.com/microsoft/aspire-skills
  101. ```
  102. ### Cursor CLI
  103. **Install the skills:**
  104. ```bash
  105. mkdir -p ~/.cursor/skills
  106. git clone https://github.com/microsoft/aspire-skills ~/.cursor/skills/aspire-skills
  107. ```
  108. **Start Cursor CLI:**
  109. ```bash
  110. agent
  111. ```
  112. ### Codex CLI
  113. **Add the marketplace** (first time only):
  114. ```bash
  115. codex plugin marketplace add microsoft/aspire-skills
  116. ```
  117. **Install the plugin:**
  118. Start Codex with `codex`, run `/plugins`, and install `aspire` from the
  119. `aspire-skills` marketplace.
  120. ### OpenCode
  121. **Install using [APM](https://github.com/microsoft/apm), then start OpenCode:**
  122. ```bash
  123. apm install microsoft/aspire-skills
  124. opencode
  125. ```
  126. #### Skill catalogs
  127. As an alternative to APM, configure OpenCode to load the skills directly from
  128. an HTTP catalog. Add the configuration for your OpenCode version to
  129. `opencode.json` or `opencode.jsonc`, preserving any existing settings.
  130. **OpenCode V2:**
  131. ```json
  132. {
  133. "$schema": "https://opencode.ai/config.json",
  134. "skills": [
  135. "https://raw.githubusercontent.com/microsoft/aspire-skills/main/opencode/v2/"
  136. ]
  137. }
  138. ```
  139. **OpenCode V1:**
  140. ```json
  141. {
  142. "$schema": "https://opencode.ai/config.json",
  143. "skills": {
  144. "urls": [
  145. "https://raw.githubusercontent.com/microsoft/aspire-skills/main/opencode/v1/"
  146. ]
  147. }
  148. }
  149. ```
  150. See OpenCode's [skill sources documentation](https://opencode.ai/v2/docs/skills#sources)
  151. for configuration guidance.
  152. ### Ollama + Copilot CLI
  153. **Launch Copilot with Ollama:**
  154. ```bash
  155. ollama launch copilot
  156. ```
  157. In the Copilot session that opens, run the `/plugin` commands from
  158. [GitHub Copilot CLI](#github-copilot-cli) above to add the marketplace and install
  159. or update `aspire`.
  160. ### skills.sh via NPX
  161. Use the Skills-compatible installer when your agent host supports skills.sh-managed skill locations.
  162. **Install the skills:**
  163. ```bash
  164. npx skills add microsoft/aspire-skills
  165. ```
  166. For hosts that need an explicit skills directory and target agent, install from the `skills/` folder:
  167. ```bash
  168. npx skills add https://github.com/microsoft/aspire-skills/tree/main/skills \
  169. -a github-copilot -g -y
  170. ```
  171. In that command, `-a github-copilot` selects the target agent, `-g` installs globally, and `-y` accepts prompts.
  172. ## Automatic updates and version pinning
  173. The Aspire CLI registers skill sources but does not fetch or update their
  174. content. Agent clients handle acquisition and updates. Aspire preserves matching
  175. registrations and existing client-side pins when you run `aspire agent init`.
  176. Re-running the command does not move a pin to a newer version.
  177. If your agent client supports automatic updates, keep them enabled to receive
  178. security and bug fixes.
  179. If your client supports pinning, you can pin a release tag or specific version
  180. instead. Monitor security notices and update the pin manually to receive fixes.
  181. ## Repository layout
  182. | Path | Purpose |
  183. |------|---------|
  184. | `skills/` | Source skill files, references, and evals |
  185. | `opencode/` | Generated OpenCode V1 and V2 skill catalogs |
  186. | `docs/` | Documentation |
  187. | `extensions/` | Source GitHub Copilot app canvas extensions |
  188. | `.plugin/`, `.claude-plugin/`, `.cursor-plugin/` | Plugin metadata for marketplaces |
  189. | `.github/plugins/aspire-skills/` | Published plugin mirror |
  190. | `evals/` | Shared evaluation fixtures and helpers |
  191. Aspire CLI owns agent telemetry hooks and their tests in `microsoft/aspire`.
  192. The plugins do not register telemetry hooks.
  193. ## Development
  194. Regenerate the OpenCode catalogs after changing shipped skills, references, or
  195. assets, and commit the output with the source changes:
  196. ```bash
  197. npm run catalog
  198. npm run catalog:check
  199. ```
  200. The catalog check verifies that the committed V1 and V2 catalogs match the
  201. committed skill source, including file lists and SHA-512 content versions.
  202. ### Publishing releases
  203. Merging a same-repository `release/<version>` PR into `main` runs
  204. [the publisher](.github/workflows/publish.yml). It tags the exact merged commit,
  205. copies the approved changelog notes into a source-only GitHub release, and uploads
  206. no generated archives. It uses `GITHUB_TOKEN`, not a repo bot or stored personal
  207. token. Reruns preserve the tag's commit and notes.
  208. See [the development guide](docs/development.md) for the release flow.
  209. ## Contributing
  210. See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
  211. See the [development guide](docs/development.md) for local development.
  212. ## License
  213. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.