Add Learn CLI alternative to all skills

Add CLI fallback sections to microsoft-docs, microsoft-code-reference,
and microsoft-skill-creator skills so agents can use the mslearn CLI
via Bash when the Learn MCP server is not available. Each section maps
MCP tools to their CLI equivalents and shows both npx and global install
usage.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: TianqiZhang

skills/microsoft-code-reference/SKILL.md

@@ -77,3 +77,24 @@ Before generating code using Microsoft SDKs, verify it's correct:
 3. **Find working sample** — `microsoft_code_sample_search(query: "[task]", language: "[lang]")`
 
 For simple lookups, step 1 alone may suffice. For complex API usage, complete all three steps.
+
+## CLI Alternative
+
+If the Learn MCP server is not available, use the `mslearn` CLI via Bash instead:
+
+```bash
+# Run directly (no install needed)
+npx @microsoft/learn-cli search "BlobClient UploadAsync Azure.Storage.Blobs"
+
+# Or install globally, then run
+npm install -g @microsoft/learn-cli
+mslearn search "BlobClient UploadAsync Azure.Storage.Blobs"
+```
+
+| MCP Tool | CLI Command |
+|----------|-------------|
+| `microsoft_docs_search(query: "...")` | `mslearn search "..."` |
+| `microsoft_code_sample_search(query: "...", language: "...")` | `mslearn code-search "..." --language ...` |
+| `microsoft_docs_fetch(url: "...")` | `mslearn fetch "..."` |
+
+Pass `--json` to `search` or `code-search` to get raw JSON output for further processing.

skills/microsoft-docs/SKILL.md

@@ -50,6 +50,26 @@ Fetch after search when:
 - **Deep dives** — user wants comprehensive coverage
 - **Search excerpt is cut off** — full context needed
 
+## CLI Alternative
+
+If the Learn MCP server is not available, use the `mslearn` CLI via Bash instead:
+
+```bash
+# Run directly (no install needed)
+npx @microsoft/learn-cli search "azure functions timeout"
+
+# Or install globally, then run
+npm install -g @microsoft/learn-cli
+mslearn search "azure functions timeout"
+```
+
+| MCP Tool | CLI Command |
+|----------|-------------|
+| `microsoft_docs_search(query: "...")` | `mslearn search "..."` |
+| `microsoft_docs_fetch(url: "...")` | `mslearn fetch "..."` |
+
+The `fetch` command also supports `--section <heading>` to extract a single section and `--max-chars <number>` to truncate output.
+
 ## Why Use This
 
 - **Accuracy** — live docs, not training data that may be outdated

skills/microsoft-skill-creator/SKILL.md

@@ -37,6 +37,27 @@ skill-name/
 | `microsoft_docs_fetch` | Get full page content | Deep dive into important pages |
 | `microsoft_code_sample_search` | Find code examples | Get implementation patterns |
 
+### CLI Alternative
+
+If the Learn MCP server is not available, use the `mslearn` CLI via Bash instead:
+
+```bash
+# Run directly (no install needed)
+npx @microsoft/learn-cli search "semantic kernel overview"
+
+# Or install globally, then run
+npm install -g @microsoft/learn-cli
+mslearn search "semantic kernel overview"
+```
+
+| MCP Tool | CLI Command |
+|----------|-------------|
+| `microsoft_docs_search(query: "...")` | `mslearn search "..."` |
+| `microsoft_code_sample_search(query: "...", language: "...")` | `mslearn code-search "..." --language ...` |
+| `microsoft_docs_fetch(url: "...")` | `mslearn fetch "..."` |
+
+Generated skills should include this same CLI fallback table so agents can use either path.
+
 ## Creation Process
 
 ### Step 1: Investigate the Topic