Skip to content

Commit 1918e6f

Browse files
committed
add latest skill
1 parent 34c5f4d commit 1918e6f

1 file changed

Lines changed: 13 additions & 10 deletions

File tree

skills/microsoft-code-reference/SKILL.md

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ compatibility: Requires Microsoft Learn MCP Server (https://learn.microsoft.com/
1212
|------|------|---------|
1313
| API method/class lookup | `microsoft_docs_search` | `"BlobClient UploadAsync Azure.Storage.Blobs"` |
1414
| Working code sample | `microsoft_code_sample_search` | `query: "upload blob managed identity", language: "python"` |
15-
| Full API reference | `microsoft_docs_fetch` | Fetch URL from search (for overloads, full signatures) |
15+
| Full API reference | `microsoft_docs_fetch` | Fetch URL from `microsoft_docs_search` (for overloads, full signatures) |
1616

1717
## Finding Code Samples
1818

@@ -24,8 +24,6 @@ microsoft_code_sample_search(query: "authenticate with managed identity", langua
2424
microsoft_code_sample_search(query: "send message service bus", language: "javascript")
2525
```
2626

27-
Languages: `python`, `csharp`, `javascript`, `typescript`, `java`, `go`, `powershell`, `cli`
28-
2927
**When to use:**
3028
- Before writing code—find a working pattern to follow
3129
- After errors—compare your code against a known-good sample
@@ -50,6 +48,8 @@ Fetch full page when method has multiple overloads or you need complete paramete
5048

5149
## Error Troubleshooting
5250

51+
Use `microsoft_code_sample_search` to find working code samples and compare with your implementation. For specific errors, use `microsoft_docs_search` and `microsoft_docs_fetch`:
52+
5353
| Error Type | Query |
5454
|------------|-------|
5555
| Method not found | `"[ClassName] methods [Namespace]"` |
@@ -61,15 +61,18 @@ Fetch full page when method has multiple overloads or you need complete paramete
6161

6262
## When to Verify
6363

64-
Check before using when:
64+
Always verify when:
6565
- Method name seems "too convenient" (`UploadFile` vs actual `Upload`)
6666
- Mixing SDK versions (v11 `CloudBlobClient` vs v12 `BlobServiceClient`)
6767
- Package name doesn't follow conventions (`Azure.*` for .NET, `azure-*` for Python)
68-
- First time using this API
68+
- Using an API for the first time
69+
70+
## Validation Workflow
71+
72+
Before generating code using Microsoft SDKs, verify it's correct:
6973

70-
## Quick Validation
74+
1. **Confirm method or package exists**`microsoft_docs_search(query: "[ClassName] [MethodName] [Namespace]")`
75+
2. **Fetch full details** (for overloads/complex params) — `microsoft_docs_fetch(url: "...")`
76+
3. **Find working sample**`microsoft_code_sample_search(query: "[task]", language: "[lang]")`
7177

72-
Before generating Microsoft SDK code:
73-
1. **Package exists**`microsoft_docs_search(query: "[PackageName] NuGet")`
74-
2. **Method is real**`microsoft_docs_search(query: "[ClassName] [MethodName] [Namespace]")`
75-
3. **Get working sample**`microsoft_code_sample_search(query: "[what you're doing]", language: "[lang]")`
78+
For simple lookups, step 1 alone may suffice. For complex API usage, complete all three steps.

0 commit comments

Comments
 (0)