Reorder skills doc

Author: richlander

release-notes/skills/SKILL.md

@@ -9,7 +9,20 @@ Machine-readable .NET release, CVE, and compatibility data via HAL hypermedia.
 
 ## Entry Point
 
-https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/llms.json
+<https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/llms.json>
+
+## Skills
+
+Fetch when your query matches. **Core Rules apply to all.**
+
+| Skill | Fetch When | URL |
+| ----- | ---------- | --- |
+| cve.md | CVE severity, CVSS, history | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/cve.md> |
+| breaking-changes.md | Compatibility, migration | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/breaking-changes.md> |
+| version-eol.md | EOL versions, lifecycle | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/version-eol.md> |
+| os-support.md | Distros, packages, glibc | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/os-support.md> |
+| navigation.md | Multi-hop, unsure which links | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/navigation.md> |
+| schema.md | Document structure, properties | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/schema.md> |
 
 ## Core Rules
 
@@ -20,27 +33,15 @@ https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-n
 ## llms.json Contents
 
 | Property | Contains |
-|----------|----------|
+| -------- | -------- |
 | `supported_releases` | Supported .NET versions |
 | `_embedded.latest_patches[]` | Latest patch per version with EOL, CVE counts |
 | `_links` | Navigation to indexes, timeline, security months |
 
-## Skills
-
-Fetch when your query matches. **Core Rules apply to all.**
-
-| Skill | Fetch When | URL |
-|-------|------------|-----|
-| cve.md | CVE severity, CVSS, history | https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/cve.md |
-| breaking-changes.md | Compatibility, migration | https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/breaking-changes.md |
-| version-eol.md | EOL versions, lifecycle | https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/version-eol.md |
-| os-support.md | Distros, packages, glibc | https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/os-support.md |
-| navigation.md | Multi-hop, unsure which links | https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/navigation.md |
-| schema.md | Document structure, properties | https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/schema.md |
-
 ## Quick Answers (1 fetch)
 
 From `llms.json._embedded.latest_patches[]`:
+
 - Latest patch for .NET X → filter by `release`
 - Is .NET X supported? → `supported`, `eol_date`
 - CVE count → `cve_count`
@@ -50,15 +51,15 @@ From `llms.json._embedded.latest_patches[]`:
 From `_embedded.latest_patches[]._links`:
 
 | Relation | Target |
-|----------|--------|
+| -------- | ------ |
 | `release-manifest` | manifest.json (OS, breaking changes) |
 | `latest-sdk` | SDK index |
 | `latest-security` | Last security patch |
 
 From `llms.json._links`:
 
 | Relation | Target |
-|----------|--------|
+| -------- | ------ |
 | `latest`, `latest-lts` | Newest release |
 | `latest-security-month` | Current security month |
 | `releases-index` | All versions including EOL |