Skip to content
Closed
Changes from all commits
Commits
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
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 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:
Expand All @@ -43,7 +54,7 @@ The following options are available:

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

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

Expand Down
Loading