microsoft-skill-creator

Create agent skills for Microsoft technologies using Learn MCP tools. Use when users want to create a skill that teaches agents about any Microsoft technology, library, framework, or service (Azure, .NET, M365, VS Code, Bicep, etc.). Investigates topics deeply, then generates a hybrid skill storing

By github · 9,051 installs

npx skills add github/awesome-copilot --skill microsoft-skill-creator

Source repository · Upstream listing

Microsoft Skill Creator Create hybrid skills for Microsoft technologies that store essential knowledge locally while enabling dynamic Learn MCP lookups for deeper details. About Skills Skills are modular packages that extend agent capabilities with specialized knowledge and workflows. A skill transforms a general purpose agent into a specialized one for a specific domain. Skill Structure Key Principles Frontmatter is critical : name and description determine when the skill triggers—be clear and comprehensive Concise is key : Only include what agents don't already know; context window is shared No duplication : Information lives in SKILL.md OR reference files, not both Learn MCP Tools Tool Purpose When to Use microsoft docs search Search official docs First pass discovery, finding topics 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 from a terminal or shell (for example, Bash, PowerShell, or cmd) instead: 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 Build deep understanding using Learn MCP tools in three phases: Phase 1 Scope Discovery: Phase 2 Core Content: Phase 3 Depth: Investigation Checklist After investigating, verify: [ ] Can explain what the technology does in one paragraph [ ] Identified 3 5 key concepts [ ] Have working code for basic usage [ ] Know the most common API patterns [ ] Have search queries for deeper topics Step 2: Clarify with User Present findings and ask: 1. "I found these key areas: [list]. Which are most important?" 2. "What tasks will agents primarily perform with this skill?" 3. "Which programming language should code samples prioritize?" Step 3: Generate the Skill Use the appropriate template from [skill templates.md](references/skill templates.md): Technology Type Template Client library, NuGet/npm package SDK/Library Azure resource Azure Service App development framework Framework/Platform REST API, protocol API/Protocol Generated Skill Structure Step 4: Balance Local vs Dynamic Content Store locally when: Foundational (needed for any task) Frequently accessed Stable (won't change) Hard to find via search Keep dynamic when: Exhaustive reference (too large) Version specific Situational (specific tasks only) Well indexed (easy to search) Content Guidelines Content Type Local Dynamic Core concepts (3 5) ✅ Full Hello world code ✅ Full Common patterns (3 5) ✅ Full Top API methods Signature + example Full docs via fetch Best practices Top 5 bullets Search for more Troubleshooting Search queries Full API reference Doc links Step 5: Validate 1. Review: Is local content sufficient for common tasks? 2. Test: Do suggested search queries return useful results? 3. Verify: Do code samples run without errors? Common Investigation Patterns For SDKs/Libraries For Azure Services For Frameworks/Platforms Example: Creating a "Semantic Kernel" Skill Investigation Generated Skill Generated SKILL.md