From 2431d4634e45a8e637bd77e4f024ca76e02f0837 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 04:36:32 +0000 Subject: [PATCH 1/2] docs: update aspire agent init output description Document the improved compact summary output introduced in microsoft/aspire#17519. The command now prints one consolidated message listing all installed skills and locations instead of a separate line per skill. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../docs/reference/cli/commands/aspire-agent-init.mdx | 11 +++++++++++ 1 file changed, 11 insertions(+) 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..1cf463913 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 @@ -29,6 +29,17 @@ The `aspire agent init` command initializes skill files and MCP (Model Context P The command also removes skill files from any locations that were deselected, keeping your workspace clean. +When one or more skills are installed, the command prints a single compact summary instead of a separate message per skill. For example: + +```text +🤖 Installed Aspire agent skills: + Skills: aspire, aspireify, aspire-deployment + Locations: .agents/skills, ~/.agents/skills +✅ Agent environment configuration complete. +``` + +If a skill install fails, the error message includes the exact skill path that failed. No-op runs (where every skill was already up to date) stay quiet and print only the final completion message. + ## Options The following options are available: From b36d7161002e914a843f68e2d15902e7e57938f8 Mon Sep 17 00:00:00 2001 From: David Pine <7679720+IEvangelist@users.noreply.github.com> Date: Sat, 30 May 2026 00:39:43 -0500 Subject: [PATCH 2/2] Address review feedback (2 threads) - Clarify installed skill summary examples and available skill-file outputs (PRRT_kwDOQK_VN86E_zkv) - Reword no-op output behavior to avoid quiet ambiguity (PRRT_kwDOQK_VN86E_zk0) 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 | 8 ++++---- 1 file changed, 4 insertions(+), 4 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 1cf463913..fa94e0a70 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,12 +24,12 @@ 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** — choose which skills and tools to install. The available list can include entries such as `aspire`, `aspireify`, `aspire-deployment`, `playwright-cli`, and `dotnet-inspect`. The `aspire` and `aspire-deployment` skills are pre-selected by default; one-time setup and tool-specific entries are available to opt into when applicable. 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. -When one or more skills are installed, the command prints a single compact summary instead of a separate message per skill. For example: +When one or more skill files are installed, the command prints a single compact summary instead of a separate message per skill. The summary lists normalized display locations without trailing slashes. For example, when the `aspire`, `aspireify`, and `aspire-deployment` skills are installed in the standard workspace and user-level locations: ```text 🤖 Installed Aspire agent skills: @@ -38,7 +38,7 @@ When one or more skills are installed, the command prints a single compact summa ✅ Agent environment configuration complete. ``` -If a skill install fails, the error message includes the exact skill path that failed. No-op runs (where every skill was already up to date) stay quiet and print only the final completion message. +If a skill install fails, the error message includes the exact skill path that failed. No-op runs (where every skill was already up to date) skip the skills and locations summary and print only the final completion message. ## Options @@ -54,7 +54,7 @@ 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 enable. Bundle-provided skill names are loaded dynamically, such as `aspire`, `aspireify`, and `aspire-deployment`; 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. -