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..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 @@ -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: + + ```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. +### 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 a bundle source is available for skill installation. + ## Options The following options are available: