From 6c15214f24d66cc15f169b1a9705e2b1f2e87c3f Mon Sep 17 00:00:00 2001 From: "aspire-repo-bot[bot]" <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Date: Fri, 29 May 2026 19:29:53 +0000 Subject: [PATCH 1/2] docs: update aspire agent init for bundle-derived skill catalog (13.4) The aspire agent init command now loads the available skill catalog from the Aspire skills bundle manifest instead of a hardcoded list. This surfaces bundle-only skills (aspire-init, aspire-monitoring, aspire-orchestration) in the interactive prompt and via --skills. Key behavior changes documented: - Available skills are loaded dynamically from the bundle manifest. - CLI-defined skills (playwright-cli, dotnet-inspect) remain as static options. - One-time setup skills (aspireify) are no longer pre-selected by default in standalone aspire agent init runs. - New aspireSkillsRemoteFetchEnabled feature flag (default: false) controls whether the CLI may download the bundle from GitHub. Documents changes from microsoft/aspire#17673. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../reference/cli/commands/aspire-agent-init.mdx | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/src/frontend/src/content/docs/reference/cli/commands/aspire-agent-init.mdx b/src/frontend/src/content/docs/reference/cli/commands/aspire-agent-init.mdx index 2b89972ec..9f04acb4b 100644 --- a/src/frontend/src/content/docs/reference/cli/commands/aspire-agent-init.mdx +++ b/src/frontend/src/content/docs/reference/cli/commands/aspire-agent-init.mdx @@ -24,7 +24,7 @@ aspire agent init [options] The `aspire agent init` command initializes skill files and MCP (Model Context Protocol) server configuration for your development environment. It presents an interactive multi-step flow to configure AI coding agent support: 1. **Select skill locations** — choose where skill files are installed (Standard `.agents/skills/`, Claude Code `.claude/skills/`, GitHub Skills `.github/skills/`, OpenCode `.opencode/skill/`). The **Standard** location is the only option that defaults as pre-selected. -2. **Select skills and tools** — choose which skills to install (Aspire skill, Playwright CLI, dotnet-inspect skill). All options are pre-selected by default. +2. **Select skills and tools** — the available skill catalog is loaded from the Aspire skills bundle manifest, so the list includes all bundle-provided skills (such as `aspire-init`, `aspire-monitoring`, and `aspire-orchestration`) in addition to the CLI-defined skills (`playwright-cli`, `dotnet-inspect`). All catalog skills are pre-selected by default, except one-time workspace-wiring skills (such as `aspireify`) that are omitted from the defaults when running against an existing project. 3. **Apply selections** — installs the chosen skills into each selected location and sets up the MCP server connection. The command also removes skill files from any locations that were deselected, keeping your workspace clean. @@ -43,7 +43,11 @@ The following options are available: - **`--skills `** - Comma-separated list of skills to enable, such as `aspire`, `aspireify`, `playwright-cli`, or `dotnet-inspect`. Use `all` to enable all available skills or `none` to skip skill installation. When not specified, the command prompts interactively. + Comma-separated list of skills to install. Bundle skills are loaded dynamically from the Aspire skills bundle manifest and include skills such as `aspire-init`, `aspire-monitoring`, and `aspire-orchestration`. CLI-provided skills include `playwright-cli` and `dotnet-inspect`. Use `all` to enable all available skills or `none` to skip skill installation. When not specified, the command prompts interactively. + + :::note + The full list of available bundle skills depends on the Aspire skills bundle cached or embedded in the CLI. To enable remote fetch of the latest bundle from GitHub, set the `aspireSkillsRemoteFetchEnabled` feature flag to `true` in your Aspire CLI configuration (disabled by default in 13.4). + ::: - @@ -71,6 +75,12 @@ The following options are available: aspire agent init --skills all --skill-locations all ``` +- Install specific bundle skills by name: + + ```bash title="Aspire CLI" + aspire agent init --skills aspire-monitoring,aspire-orchestration + ``` + - Initialize agent configuration from a specific workspace root: ```bash title="Aspire CLI" From 2851df598a0a46d6dd1c1dc133b4c6b85f11ae76 Mon Sep 17 00:00:00 2001 From: David Pine <7679720+IEvangelist@users.noreply.github.com> Date: Sat, 30 May 2026 04:46:47 -0500 Subject: [PATCH 2/2] Address review feedback (3 threads) - Clarify standalone agent init aspireify defaulting (PRRT_kwDOQK_VN86FycNq) - Use install terminology for --skills all (PRRT_kwDOQK_VN86Fx165) - Add the features-prefixed config command for remote bundle fetch (PRRT_kwDOQK_VN86Fx15-) Verified against microsoft/aspire@11bea2eb9fbb655614bcf9814c55c88a3fdd1126 on branch release/13.4. Edited per the doc-writer skill. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../docs/reference/cli/commands/aspire-agent-init.mdx | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/src/frontend/src/content/docs/reference/cli/commands/aspire-agent-init.mdx b/src/frontend/src/content/docs/reference/cli/commands/aspire-agent-init.mdx index 9f04acb4b..7cb0e7308 100644 --- a/src/frontend/src/content/docs/reference/cli/commands/aspire-agent-init.mdx +++ b/src/frontend/src/content/docs/reference/cli/commands/aspire-agent-init.mdx @@ -24,7 +24,7 @@ aspire agent init [options] The `aspire agent init` command initializes skill files and MCP (Model Context Protocol) server configuration for your development environment. It presents an interactive multi-step flow to configure AI coding agent support: 1. **Select skill locations** — choose where skill files are installed (Standard `.agents/skills/`, Claude Code `.claude/skills/`, GitHub Skills `.github/skills/`, OpenCode `.opencode/skill/`). The **Standard** location is the only option that defaults as pre-selected. -2. **Select skills and tools** — the available skill catalog is loaded from the Aspire skills bundle manifest, so the list includes all bundle-provided skills (such as `aspire-init`, `aspire-monitoring`, and `aspire-orchestration`) in addition to the CLI-defined skills (`playwright-cli`, `dotnet-inspect`). All catalog skills are pre-selected by default, except one-time workspace-wiring skills (such as `aspireify`) that are omitted from the defaults when running against an existing project. +2. **Select skills and tools** — the available skill catalog is loaded from the Aspire skills bundle manifest, so the list includes all bundle-provided skills (such as `aspire-init`, `aspire-monitoring`, and `aspire-orchestration`) in addition to the CLI-defined skills (`playwright-cli`, `dotnet-inspect`). In this standalone command, all catalog skills are pre-selected by default except one-time workspace-wiring skills (such as `aspireify`). Use `aspire init` to create an AppHost in an existing repo and pre-select `aspireify` as part of that flow. 3. **Apply selections** — installs the chosen skills into each selected location and sets up the MCP server connection. The command also removes skill files from any locations that were deselected, keeping your workspace clean. @@ -43,10 +43,14 @@ The following options are available: - **`--skills `** - Comma-separated list of skills to install. Bundle skills are loaded dynamically from the Aspire skills bundle manifest and include skills such as `aspire-init`, `aspire-monitoring`, and `aspire-orchestration`. CLI-provided skills include `playwright-cli` and `dotnet-inspect`. Use `all` to enable all available skills or `none` to skip skill installation. When not specified, the command prompts interactively. + Comma-separated list of skills to install. Bundle skills are loaded dynamically from the Aspire skills bundle manifest and include skills such as `aspire-init`, `aspire-monitoring`, and `aspire-orchestration`. CLI-provided skills include `playwright-cli` and `dotnet-inspect`. Use `all` to install all available skills or `none` to skip skill installation. When not specified, the command prompts interactively. :::note - The full list of available bundle skills depends on the Aspire skills bundle cached or embedded in the CLI. To enable remote fetch of the latest bundle from GitHub, set the `aspireSkillsRemoteFetchEnabled` feature flag to `true` in your Aspire CLI configuration (disabled by default in 13.4). + The full list of available bundle skills depends on the Aspire skills bundle cached or embedded in the CLI. To enable remote fetch of the latest bundle from GitHub, set the `features.aspireSkillsRemoteFetchEnabled` feature flag to `true` in your Aspire CLI configuration (disabled by default in 13.4): + + ```bash title="Aspire CLI" + aspire config set features.aspireSkillsRemoteFetchEnabled true + ``` ::: -