Skip to content

Commit 691d827

Browse files
richlanderclaude
andcommitted
Add whats-new skill for release highlights queries
New skill for "What's new in .NET X?" and "Release highlights?" queries. Documents path to manifest.json links: - whats-new-rendered → Microsoft Learn overview - release-blog-rendered → DevBlogs announcement - compatibility / compatibility-rendered → breaking changes (cross-ref) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>
1 parent eb56957 commit 691d827

File tree

2 files changed

+72
-0
lines changed

2 files changed

+72
-0
lines changed

release-notes/skills/dotnet-releases/SKILL.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,7 @@ Fetch when your query matches. **Core Rules apply to all.**
1919
| ----- | ---------- | --- |
2020
| cve-queries | "Critical CVEs in .NET 8?" "CVEs fixed last 3 months?" | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/cve-queries/SKILL.md> |
2121
| breaking-changes | "Breaking changes in .NET 10?" "Migration impact?" | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/breaking-changes/SKILL.md> |
22+
| whats-new | "What's new in .NET 10?" "Release highlights?" | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/whats-new/SKILL.md> |
2223
| version-eol | "When does .NET 8 go EOL?" "What versions are supported?" | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/version-eol/SKILL.md> |
2324
| os-support | "Does .NET 10 support Ubuntu 24.04?" "What packages needed?" | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/os-support/SKILL.md> |
2425
| navigation-flows | Multi-hop query, unsure which links to follow | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/navigation-flows/SKILL.md> |
Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
---
2+
name: whats-new
3+
description: Release highlights, new features, and announcements for .NET versions
4+
---
5+
6+
# What's New Queries
7+
8+
## Stop Criteria
9+
10+
**STOP when you have the manifest.json.** It contains links to "What's New" docs and release blog posts. These are `-rendered` links (HTML pages)—fetch only if you need to summarize content.
11+
12+
## Quick Answers (from manifest.json)
13+
14+
Once you have `manifest.json._links`:
15+
16+
- What's new docs URL? → `whats-new-rendered.href`
17+
- Release announcement URL? → `release-blog-rendered.href`
18+
- Downloads page? → `downloads-rendered.href`
19+
20+
## Navigation Flow (2 fetches for URLs, 3 to read content)
21+
22+
```
23+
llms.json
24+
25+
└─► _embedded.latest_patches[] ─► _links["release-manifest"]
26+
27+
28+
manifest.json
29+
30+
├─► _links["whats-new-rendered"] ─► Microsoft Learn (HTML)
31+
32+
└─► _links["release-blog-rendered"] ─► DevBlogs announcement (HTML)
33+
```
34+
35+
## Common Queries
36+
37+
### What's new in .NET X? (2-3 fetches)
38+
39+
1. `llms.json` → find version in `_embedded.latest_patches[]`
40+
2. Follow `_links["release-manifest"]` → manifest.json
41+
3. Return `whats-new-rendered.href` or fetch and summarize
42+
43+
### Release announcement for .NET X? (2-3 fetches)
44+
45+
Same path, use `release-blog-rendered.href`
46+
47+
## Available Links
48+
49+
| Relation | Content |
50+
|----------|---------|
51+
| `whats-new-rendered` | Microsoft Learn "What's New" overview |
52+
| `release-blog-rendered` | DevBlogs release announcement |
53+
| `compatibility` | Breaking changes JSON (see breaking-changes skill) |
54+
| `compatibility-rendered` | Breaking changes HTML view |
55+
| `downloads-rendered` | .NET download page |
56+
| `usage-markdown-rendered` | Runtime/SDK usage guidance |
57+
58+
## Common Mistakes
59+
60+
| Mistake | Why It's Wrong |
61+
|---------|----------------|
62+
| Looking for raw markdown | Only `-rendered` (HTML) versions exist for announcements |
63+
| Constructing docs.microsoft.com URLs | Follow `_links` from manifest |
64+
| Fetching HTML when URL is enough | If user just needs link, don't fetch the page |
65+
66+
## Tips
67+
68+
- `-rendered` links are HTML (human-friendly), not raw data
69+
- `whats-new-rendered` has comprehensive feature overview
70+
- `release-blog-rendered` has highlights and context
71+
- For LLM summarization, fetch the HTML and extract key points

0 commit comments

Comments
 (0)