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 613fbed71..97748bf46 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,11 +24,22 @@ aspire agent init [options] The `aspire agent init` command initializes Aspire skills, companion tools, 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 and companion tools to install, such as Aspire skills and Playwright CLI. Aspire workflow skills are selected by default; optional companion tools can be selected explicitly. +2. **Select skills and tools** — choose which skills and companion tools to install, such as Aspire skills and Playwright CLI. The Aspire workflow skills from [microsoft/aspire-skills](https://github.com/microsoft/aspire-skills) are selected by default: `aspire`, `aspire-init`, `aspireify`, `aspire-orchestration`, `aspire-deployment`, and `aspire-monitoring`; optional companion tools can be selected explicitly 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 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 skills from [microsoft/aspire-skills](https://github.com/microsoft/aspire-skills#whats-included) are installed in the standard workspace and user-level locations: + +```text +🤖 Installed Aspire agent skills: + Skills: aspire, aspire-init, aspireify, aspire-orchestration, aspire-deployment, aspire-monitoring + 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) skip the skills and locations summary and print only the final completion message. + ## Options The following options are available: @@ -43,7 +54,7 @@ The following options are available: - **`--skills `** - Comma-separated list of skills to enable, such as `aspire`, `aspire-init`, `aspire-orchestration`, `aspire-monitoring`, `aspire-deployment`, `aspireify`, or `playwright-cli`. The available list can vary by Aspire CLI version and project type. 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 Aspire skill names are loaded dynamically from [microsoft/aspire-skills](https://github.com/microsoft/aspire-skills#whats-included): `aspire`, `aspire-init`, `aspireify`, `aspire-orchestration`, `aspire-deployment`, and `aspire-monitoring`. CLI-provided tool skills can 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. -