Add Learn CLI fallback to all skills#123
Conversation
There was a problem hiding this comment.
Pull request overview
This PR adds a "CLI Alternative" section to all three skills (microsoft-docs, microsoft-code-reference, microsoft-skill-creator) so that agents can fall back to the mslearn CLI via Bash when the Learn MCP server is unavailable. Each section shows npx and global install usage, and maps MCP tools to their CLI equivalents.
Changes:
- Added CLI fallback documentation with MCP tool → CLI command mapping tables to all three SKILL.md files
- Included additional CLI option hints (
--section,--max-chars,--json) in relevant skills - Instructed the skill-creator to propagate CLI fallback tables into generated skills
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| skills/microsoft-docs/SKILL.md | Adds CLI Alternative section mapping search and fetch tools |
| skills/microsoft-code-reference/SKILL.md | Adds CLI Alternative section mapping all three tools, plus --json hint |
| skills/microsoft-skill-creator/SKILL.md | Adds CLI Alternative section and instruction for generated skills to include it |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
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>
…lates - Update compatibility frontmatter in all 3 skills to reflect CLI fallback - Move "Why Use This" above "CLI Alternative" in microsoft-docs skill - Add CLI Alternative section to the example generated skill in skill-creator - Add CLI mapping table to the top of skill-templates.md so generated skills can reference CLI equivalents without duplicating in every template Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
TianqiZhang
force-pushed
the
skills/add-cli-alternative
branch
from
edaa450 to
69c8844
Compare
There was a problem hiding this comment.
Pull request overview
This PR adds a "CLI Alternative" section to all three skills (microsoft-docs, microsoft-code-reference, microsoft-skill-creator) and the skill templates reference, documenting how agents can fall back to the mslearn CLI when the Learn MCP server is unavailable. It also softens the compatibility frontmatter from "Requires" to "Works best with."
Changes:
- Updated compatibility frontmatter in all three SKILL.md files to indicate CLI fallback support
- Added CLI Alternative sections with MCP tool → CLI command mapping tables and usage examples to each skill
- Updated the skill-creator's template reference and example generated skill to include the CLI fallback table
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| skills/microsoft-docs/SKILL.md | Softened compatibility, added CLI fallback section with search and fetch mappings |
| skills/microsoft-code-reference/SKILL.md | Softened compatibility, added CLI fallback section with all three command mappings |
| skills/microsoft-skill-creator/SKILL.md | Softened compatibility, added CLI fallback as a subsection of tools and in the example generated skill |
| skills/microsoft-skill-creator/references/skill-templates.md | Added CLI fallback mapping table for use in generated skill templates |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Summary
microsoft-docs,microsoft-code-reference,microsoft-skill-creator)mslearnCLI equivalent so agents can fall back to the CLI via Bash when the Learn MCP server is unavailablenpx @microsoft/learn-cli(no install) andnpm install -g(global install) usageTest plan
🤖 Generated with Claude Code