From 3a1b92945a0c5c35759bd04bf1f0b868b963a7ee Mon Sep 17 00:00:00 2001
From: James Newton-King <james@newtonking.com>
Date: Fri, 10 Jul 2026 13:56:42 +0800
Subject: [PATCH] Document --skills and --skill-locations flags for init and
 new commands

Add documentation for the --skills and --skill-locations options on
aspire init and aspire new commands. These flags were added in
microsoft/aspire#18191 and microsoft/aspire#18192 to support
non-interactive mode for controlling which agent skills are installed
during initialization.
---
 .../reference/cli/commands/aspire-init.mdx    | 20 +++++++++++++++++++
 .../reference/cli/commands/aspire-new.mdx     | 20 +++++++++++++++++++
 2 files changed, 40 insertions(+)

diff --git a/src/frontend/src/content/docs/reference/cli/commands/aspire-init.mdx b/src/frontend/src/content/docs/reference/cli/commands/aspire-init.mdx
index 7981425e4..995e6a287 100644
--- a/src/frontend/src/content/docs/reference/cli/commands/aspire-init.mdx
+++ b/src/frontend/src/content/docs/reference/cli/commands/aspire-init.mdx
@@ -102,6 +102,14 @@ The following options are available:
 
   The AppHost language to scaffold (`csharp`, `typescript`).
 
+- **`--skill-locations <skill-locations>`**
+
+  Comma-separated list of skill locations to configure. Use `all` to configure all supported locations or `none` to skip skill location configuration. When not specified, the command prompts interactively. Useful for non-interactive mode in scripts and CI environments. For the list of available locations, see the [`aspire agent init` command reference](../aspire-agent-init/#options).
+
+- **`--skills <skills>`**
+
+  Comma-separated list of skills to install. Use `all` to install all available skills or `none` to skip skill installation. When not specified, the command prompts interactively. Useful for non-interactive mode in scripts and CI environments. For the list of available skills, see the [`aspire agent init` command reference](../aspire-agent-init/#options).
+
 - <Include relativePath="reference/cli/includes/option-help.md" />
 
 - <Include relativePath="reference/cli/includes/option-log-level.md" />
@@ -133,3 +141,15 @@ The following options are available:
   ```bash title="Aspire CLI"
   aspire init --channel daily
   ```
+
+- Initialize Aspire support non-interactively without installing any agent skills:
+
+  ```bash title="Aspire CLI"
+  aspire init --non-interactive --skills none
+  ```
+
+- Initialize Aspire support non-interactively, installing all skills in the standard location:
+
+  ```bash title="Aspire CLI"
+  aspire init --non-interactive --language csharp --skill-locations standard --skills all
+  ```
diff --git a/src/frontend/src/content/docs/reference/cli/commands/aspire-new.mdx b/src/frontend/src/content/docs/reference/cli/commands/aspire-new.mdx
index b8cd93487..3e5d69bcd 100644
--- a/src/frontend/src/content/docs/reference/cli/commands/aspire-new.mdx
+++ b/src/frontend/src/content/docs/reference/cli/commands/aspire-new.mdx
@@ -122,6 +122,14 @@ The following options are available:
 
   Suppress the prompt to initialize MCP server configuration for agent environments after project creation.
 
+- **`--skill-locations <skill-locations>`**
+
+  Comma-separated list of skill locations to configure. Use `all` to configure all supported locations or `none` to skip skill location configuration. When not specified, the command prompts interactively. Useful for non-interactive mode in scripts and CI environments. For the list of available locations, see the [`aspire agent init` command reference](../aspire-agent-init/#options).
+
+- **`--skills <skills>`**
+
+  Comma-separated list of skills to install. Use `all` to install all available skills or `none` to skip skill installation. When not specified, the command prompts interactively. Useful for non-interactive mode in scripts and CI environments. For the list of available skills, see the [`aspire agent init` command reference](../aspire-agent-init/#options).
+
 - <Include relativePath="reference/cli/includes/option-help.md" />
 
 - <Include relativePath="reference/cli/includes/option-log-level.md" />
@@ -179,6 +187,18 @@ The `aspire-py-starter` template accepts the following additional options:
   aspire new aspire-starter --channel daily
   ```
 
+- Create a new project non-interactively without installing any agent skills:
+
+  ```bash title="Aspire CLI"
+  aspire new aspire-starter --name myapp --skills none --non-interactive
+  ```
+
+- Create a new project non-interactively and install all skills in all supported locations:
+
+  ```bash title="Aspire CLI"
+  aspire new aspire-starter --name myapp --skill-locations all --skills all --non-interactive
+  ```
+
 ## Troubleshooting
 
 ### Language support not found