Skip to content

[docs] Update aspire agent init output documentation #1087

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
aspire-repo-bot wants to merge 2 commits into
base: release/13.4
Choose a base branch
from
+13 −2
Open

[docs] Update aspire agent init output documentation #1087

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2431d46
docs: update aspire agent init output description
aspire-repo-bot[bot] May 27, 2026
b36d716
Address review feedback (2 threads)
IEvangelist May 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 13 additions & 2 deletions src/frontend/src/content/docs/reference/cli/commands/aspire-agent-init.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,11 +24,22 @@ 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 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:
Skills: aspire, aspireify, aspire-deployment
Locations: .agents/skills, ~/.agents/skills
Comment thread
IEvangelist marked this conversation as resolved.
✅ 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:
Expand All @@ -43,7 +54,7 @@ The following options are available:

- **`--skills <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.

- <Include relativePath="reference/cli/includes/option-help.md" />

Expand Down
Loading