fix(azure.ai.docs): address PR review comments and cspell

* ci-build.ps1: correct ldflags module path from azure.ai.skills to azure.ai.docs

* toolbox/overview.md: clarify that any toolbox mutation promotes a new version to default; --default-version is for rollback/repointing

* connection/overview.md and agent/configure.md: align CustomKeys credential shape with auth-types.md (credentials.keys.<header> and PARAM_<CONN>_KEYS_<HEADER>)

* cspell.yaml: add 'parseable' for skill_install.go doc comment

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: therealjohn

cli/azd/extensions/azure.ai.docs/ci-build.ps1

@@ -29,7 +29,7 @@ if ($CodeCoverageEnabled) {
 
 $tagsFlag = "-tags=cfi,cfg,osusergo"
 
-$ldFlag = "-ldflags=-s -w -X azure.ai.skills/internal/cmd.Version=$Version -X azure.ai.skills/internal/cmd.Commit=$SourceVersion -X azure.ai.skills/internal/cmd.BuildDate=$(Get-Date -Format o) "
+$ldFlag = "-ldflags=-s -w -X azure.ai.docs/internal/cmd.Version=$Version -X azure.ai.docs/internal/cmd.Commit=$SourceVersion -X azure.ai.docs/internal/cmd.BuildDate=$(Get-Date -Format o) "
 
 if ($IsWindows) {
     $msg = "Building for Windows"

cli/azd/extensions/azure.ai.docs/cspell.yaml

@@ -38,6 +38,8 @@ words:
   # Filesystem terms used in skill_install.go (target directories + cross-filesystem renames)
   - subdirs
   - tmpfs
+  # Used in skill_install.go comments describing the JSON wire shape
+  - parseable
 overrides:
   - filename: internal/cmd/doc_catalog.go
     words:

cli/azd/extensions/azure.ai.docs/internal/cmd/skills/agent/configure.md

@@ -44,7 +44,8 @@ services:
           target: https://api.githubcopilot.com/mcp
           authType: CustomKeys
           credentials:
-            Authorization: ${PARAM_GITHUB_MCP_CONN_AUTHORIZATION}
+            keys:
+              Authorization: ${PARAM_GITHUB_MCP_CONN_KEYS_AUTHORIZATION}
       toolboxes:
         - name: agent-tools
           description: "MCP toolset bundling GitHub + web search."

cli/azd/extensions/azure.ai.docs/internal/cmd/skills/connection/overview.md

@@ -46,7 +46,8 @@ connections:
     target: https://api.githubcopilot.com/mcp
     authType: CustomKeys
     credentials:
-      Authorization: ${PARAM_GITHUB_MCP_CONN_AUTHORIZATION}
+      keys:
+        Authorization: ${PARAM_GITHUB_MCP_CONN_KEYS_AUTHORIZATION}
 toolboxes:
   - name: agent-tools
     tools:

cli/azd/extensions/azure.ai.docs/internal/cmd/skills/toolbox/overview.md

@@ -33,7 +33,7 @@ Then `azd ai toolbox --help` to see the verbs.
 | `azd ai toolbox update <name> --default-version <ver>`                           | Re-point the default version (the only field `update` supports today). |
 | `azd ai toolbox delete <name> [--version <ver>] [--force]`                       | Delete a whole toolbox, or a single version.                  |
 
-Every mutation publishes a new immutable version. The first version of a new toolbox is automatically the default; subsequent versions require an explicit `update --default-version` to promote.
+Every mutation publishes a new immutable version and promotes it to default (`toolbox create`, `connection add`, `connection remove`). Use `update --default-version` later to re-point at an older version (rollback) or to fix a previous promotion.
 
 ## Connections must already exist