From 9d92524b90a7633a8fa1450010f40b4e2cea3f48 Mon Sep 17 00:00:00 2001 From: "aspire-repo-bot[bot]" <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Date: Wed, 27 May 2026 18:01:17 +0000 Subject: [PATCH 1/2] docs: update aspire agent init - embedded fallback and summary output MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Documents changes from microsoft/aspire#17548: - aspire agent init now shows a consolidated installation summary instead of per-skill messages - Added documentation for the three-tier skill bundle acquisition strategy (local cache → GitHub release asset → embedded fallback) so users know the command works in air-gapped/offline environments Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../reference/cli/commands/aspire-agent-init.mdx | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) 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..b899e7243 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 @@ -25,10 +25,24 @@ The `aspire agent init` command initializes skill files and MCP (Model Context P 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. -3. **Apply selections** — installs the chosen skills into each selected location and sets up the MCP server connection. +3. **Apply selections** — installs the chosen skills into each selected location and sets up the MCP server connection. On completion, the command prints a single installation summary listing the installed skills and their locations, for example: + + ```output + Installed Aspire agent skills: + Skills: aspire, playwright-cli + Locations: .agents/skills + ``` The command also removes skill files from any locations that were deselected, keeping your workspace clean. +### Skill bundle acquisition + +Aspire skill files are distributed as a versioned bundle. The `aspire agent init` command acquires the bundle by trying the following sources in order: + +1. **Local cache** — a previously downloaded and verified bundle is reused. +2. **GitHub release asset** — the bundle is downloaded from the verified `microsoft/aspire-skills` GitHub release and cached locally. +3. **Embedded fallback** — a validated snapshot of the skills bundle is embedded directly in the CLI. This fallback is used when neither the local cache nor the GitHub release asset is available (for example, in air-gapped or offline environments), ensuring that `aspire agent init` can always complete successfully. + ## Options The following options are available: From d375243517523bc4e667f5b159c81365512c3d37 Mon Sep 17 00:00:00 2001 From: David Pine <7679720+IEvangelist@users.noreply.github.com> Date: Fri, 29 May 2026 21:33:20 -0500 Subject: [PATCH 2/2] Address review feedback (2 threads) - PRRT_kwDOQK_VN86FMnh-: Use a titled text output block and match the robot-prefixed summary output. - PRRT_kwDOQK_VN86FMnif: Scope the embedded fallback claim to bundle availability. Verified against microsoft/aspire@565af538808300046a1b7cbe125358661d336a4c 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, 5 insertions(+), 5 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 b899e7243..ccf5d3d8b 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 @@ -27,10 +27,10 @@ The `aspire agent init` command initializes skill files and MCP (Model Context P 2. **Select skills and tools** — choose which skills to install (Aspire skill, Playwright CLI, dotnet-inspect skill). All options are pre-selected by default. 3. **Apply selections** — installs the chosen skills into each selected location and sets up the MCP server connection. On completion, the command prints a single installation summary listing the installed skills and their locations, for example: - ```output - Installed Aspire agent skills: - Skills: aspire, playwright-cli - Locations: .agents/skills + ```text title="Output" + 🤖 Installed Aspire agent skills: + Skills: aspire, playwright-cli + Locations: .agents/skills ``` The command also removes skill files from any locations that were deselected, keeping your workspace clean. @@ -41,7 +41,7 @@ Aspire skill files are distributed as a versioned bundle. The `aspire agent init 1. **Local cache** — a previously downloaded and verified bundle is reused. 2. **GitHub release asset** — the bundle is downloaded from the verified `microsoft/aspire-skills` GitHub release and cached locally. -3. **Embedded fallback** — a validated snapshot of the skills bundle is embedded directly in the CLI. This fallback is used when neither the local cache nor the GitHub release asset is available (for example, in air-gapped or offline environments), ensuring that `aspire agent init` can always complete successfully. +3. **Embedded fallback** — a validated snapshot of the skills bundle is embedded directly in the CLI. This fallback is used when neither the local cache nor the GitHub release asset is available (for example, in air-gapped or offline environments), ensuring a bundle source is available for skill installation. ## Options