devskill 2.0.7 → 2.0.8

package/skills/microsoft-docs/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: microsoft-docs
+description: 'Query official Microsoft documentation to find concepts, tutorials, and code examples across Azure, .NET, Agent Framework, Aspire, VS Code, GitHub, and more. Uses Microsoft Learn MCP as the default, with Context7 and Aspire MCP for content that lives outside learn.microsoft.com.'
+---
+
+# Microsoft Docs
+
+Research skill for the Microsoft technology ecosystem. Covers learn.microsoft.com and documentation that lives outside it (VS Code, GitHub, Aspire, Agent Framework repos).
+
+---
+
+## Default: Microsoft Learn MCP
+
+Use these tools for **everything on learn.microsoft.com** — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows, and more. This is the primary tool for the vast majority of Microsoft documentation queries.
+
+| Tool | Purpose |
+|------|---------|
+| `microsoft_docs_search` | Search learn.microsoft.com — concepts, guides, tutorials, configuration |
+| `microsoft_code_sample_search` | Find working code snippets from Learn docs. Pass `language` (`python`, `csharp`, etc.) for best results |
+| `microsoft_docs_fetch` | Get full page content from a specific URL (when search excerpts aren't enough) |
+
+Use `microsoft_docs_fetch` after search when you need complete tutorials, all config options, or when search excerpts are truncated.
+
+### CLI Alternative
+
+If the Learn MCP server is not available, use the `mslearn` CLI from your terminal or shell (for example, Bash, PowerShell, or cmd) 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.
+
+---
+
+## Exceptions: When to Use Other Tools
+
+The following categories live **outside** learn.microsoft.com. Use the specified tool instead.
+
+### .NET Aspire — Use Aspire MCP Server (preferred) or Context7
+
+Aspire docs live on **aspire.dev**, not Learn. The best tool depends on your Aspire CLI version:
+
+**CLI 13.2+** (recommended) — The Aspire MCP server includes built-in docs search tools:
+
+| MCP Tool | Description |
+|----------|-------------|
+| `list_docs` | Lists all available documentation from aspire.dev |
+| `search_docs` | Weighted lexical search across aspire.dev content |
+| `get_doc` | Retrieves a specific document by slug |
+
+These ship in Aspire CLI 13.2 ([PR #14028](https://github.com/dotnet/aspire/pull/14028)). To update: `aspire update --self --channel daily`. Ref: https://davidpine.dev/posts/aspire-docs-mcp-tools/
+
+**CLI 13.1** — The MCP server provides integration lookup (`list_integrations`, `get_integration_docs`) but **not** docs search. Fall back to Context7:
+
+| Library ID | Use for |
+|---|---|
+| `/microsoft/aspire.dev` | Primary — guides, integrations, CLI reference, deployment |
+| `/dotnet/aspire` | Runtime source — API internals, implementation details |
+| `/communitytoolkit/aspire` | Community integrations — Go, Java, Node.js, Ollama |
+
+### VS Code — Use Context7
+
+VS Code docs live on **code.visualstudio.com**, not Learn.
+
+| Library ID | Use for |
+|---|---|
+| `/websites/code_visualstudio` | User docs — settings, features, debugging, remote dev |
+| `/websites/code_visualstudio_api` | Extension API — webviews, TreeViews, commands, contribution points |
+
+### GitHub — Use Context7
+
+GitHub docs live on **docs.github.com** and **cli.github.com**.
+
+| Library ID | Use for |
+|---|---|
+| `/websites/github_en` | Actions, API, repos, security, admin, Copilot |
+| `/websites/cli_github` | GitHub CLI (`gh`) commands and flags |
+
+### Agent Framework — Use Learn MCP + Context7
+
+Agent Framework tutorials are on learn.microsoft.com (use `microsoft_docs_search`), but the **GitHub repo** has API-level detail that is often ahead of published docs — particularly DevUI REST API reference, CLI options, and .NET integration.
+
+| Library ID | Use for |
+|---|---|
+| `/websites/learn_microsoft_en-us_agent-framework` | Tutorials — DevUI guides, tracing, workflow orchestration |
+| `/microsoft/agent-framework` | API detail — DevUI REST endpoints, CLI flags, auth, .NET `AddDevUI`/`MapDevUI` |
+
+**DevUI tip:** Query the Learn website source for how-to guides, then the repo source for API-level specifics (endpoint schemas, proxy config, auth tokens).
+
+---
+
+## Context7 Setup
+
+For any Context7 query, resolve the library ID first (one-time per session):
+
+1. Call `mcp_context7_resolve-library-id` with the technology name
+2. Call `mcp_context7_query-docs` with the returned library ID and a specific query
+
+---
+
+## Writing Effective Queries
+
+Be specific — include version, intent, and language:
+
+```
+# ❌ Too broad
+"Azure Functions"
+"agent framework"
+
+# ✅ Specific
+"Azure Functions Python v2 programming model"
+"Cosmos DB partition key design best practices"
+"GitHub Actions workflow_dispatch inputs matrix strategy"
+"Aspire AddUvicornApp Python FastAPI integration"
+"DevUI serve agents tracing OpenTelemetry directory discovery"
+"Agent Framework workflow conditional edges branching handoff"
+```
+
+Include context:
+- **Version** when relevant (`.NET 8`, `Aspire 13`, `VS Code 1.96`)
+- **Task intent** (`quickstart`, `tutorial`, `overview`, `limits`, `API reference`)
+- **Language** for polyglot docs (`Python`, `TypeScript`, `C#`)

package/skills/microsoft-docs/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/microsoft-docs`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/microsoft-skill-creator/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/microsoft-skill-creator/SKILL.md

@@ -0,0 +1,250 @@
+---
+name: microsoft-skill-creator
+description: 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 essential knowledge locally while enabling dynamic deeper investigation.
+context: fork
+compatibility: Works best with Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp). Can also use the mslearn CLI as a fallback.
+---
+
+# 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
+
+```
+skill-name/
+├── SKILL.md (required)     # Frontmatter (name, description) + instructions
+├── references/             # Documentation loaded into context as needed
+├── sample_codes/           # Working code examples
+└── assets/                 # Files used in output (templates, etc.)
+```
+
+### 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:
+
+```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
+
+Build deep understanding using Learn MCP tools in three phases:
+
+**Phase 1 - Scope Discovery:**
+```
+microsoft_docs_search(query="{technology} overview what is")
+microsoft_docs_search(query="{technology} concepts architecture")
+microsoft_docs_search(query="{technology} getting started tutorial")
+```
+
+**Phase 2 - Core Content:**
+```
+microsoft_docs_fetch(url="...")  # Fetch pages from Phase 1
+microsoft_code_sample_search(query="{technology}", language="{lang}")
+```
+
+**Phase 3 - Depth:**
+```
+microsoft_docs_search(query="{technology} best practices")
+microsoft_docs_search(query="{technology} troubleshooting errors")
+```
+
+#### 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
+
+```
+{skill-name}/
+├── SKILL.md                    # Core knowledge + Learn MCP guidance
+├── references/                 # Detailed local documentation (if needed)
+└── sample_codes/               # Working code examples
+    ├── getting-started/
+    └── common-patterns/
+```
+
+### 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
+```
+"{name} overview" → purpose, architecture
+"{name} getting started quickstart" → setup steps
+"{name} API reference" → core classes/methods
+"{name} samples examples" → code patterns
+"{name} best practices performance" → optimization
+```
+
+### For Azure Services
+```
+"{service} overview features" → capabilities
+"{service} quickstart {language}" → setup code
+"{service} REST API reference" → endpoints
+"{service} SDK {language}" → client library
+"{service} pricing limits quotas" → constraints
+```
+
+### For Frameworks/Platforms
+```
+"{framework} architecture concepts" → mental model
+"{framework} project structure" → conventions
+"{framework} tutorial walkthrough" → end-to-end flow
+"{framework} configuration options" → customization
+```
+
+## Example: Creating a "Semantic Kernel" Skill
+
+### Investigation
+
+```
+microsoft_docs_search(query="semantic kernel overview")
+microsoft_docs_search(query="semantic kernel plugins functions")
+microsoft_code_sample_search(query="semantic kernel", language="csharp")
+microsoft_docs_fetch(url="https://learn.microsoft.com/semantic-kernel/overview/")
+```
+
+### Generated Skill
+
+```
+semantic-kernel/
+├── SKILL.md
+└── sample_codes/
+    ├── getting-started/
+    │   └── hello-kernel.cs
+    └── common-patterns/
+        ├── chat-completion.cs
+        └── function-calling.cs
+```
+
+### Generated SKILL.md
+
+```markdown
+---
+name: semantic-kernel
+description: Build AI agents with Microsoft Semantic Kernel. Use for LLM-powered apps with plugins, planners, and memory in .NET or Python.
+---
+
+# Semantic Kernel
+
+Orchestration SDK for integrating LLMs into applications with plugins, planners, and memory.
+
+## Key Concepts
+
+- **Kernel**: Central orchestrator managing AI services and plugins
+- **Plugins**: Collections of functions the AI can call
+- **Planner**: Sequences plugin functions to achieve goals
+- **Memory**: Vector store integration for RAG patterns
+
+## Quick Start
+
+See [getting-started/hello-kernel.cs](sample_codes/getting-started/hello-kernel.cs)
+
+## Learn More
+
+| Topic | How to Find |
+|-------|-------------|
+| Plugin development | `microsoft_docs_search(query="semantic kernel plugins custom functions")` |
+| Planners | `microsoft_docs_search(query="semantic kernel planner")` |
+| Memory | `microsoft_docs_fetch(url="https://learn.microsoft.com/en-us/semantic-kernel/frameworks/agent/agent-memory")` |
+
+## CLI Alternative
+
+If the Learn MCP server is not available, use the `mslearn` CLI 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 "..."` |
+
+Run directly with `npx @microsoft/learn-cli <command>` or install globally with `npm install -g @microsoft/learn-cli`.
+```

package/skills/microsoft-skill-creator/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/microsoft-skill-creator`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24