jprdonnelly/core
1
0
Fork 0
mirror of synced 2025-12-19 18:06:02 -05:00
Code Issues Projects Releases Wiki Activity

Add example queries and Quick Answers sections

Browse Source 
Main SKILL.md:
- Replace terse "Fetch When" with example questions per skill

Sub-skills:
- Add "Quick Answers" sections showing what fields answer common
  questions once you have the target document (no extra fetches)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Rich Lander
2025-12-18 17:55:36 -08:00
parent 134af63997
commit eb56957439
5 changed files with 42 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
release-notes/skills/breaking-changes/SKILL.md
View File

@@ -9,6 +9,15 @@ description: Compatibility queries, breaking changes, migration guidance, and TF
**STOP when you have `compatibility.json`.** It contains all breaking changes with impact levels and doc links. Only fetch `documentation` URLs if you need detailed migration steps or rationale.
## Quick Answers (from compatibility.json)
Once you have `compatibility.json`, answer directly from `breaks[]`:
- How many breaking changes? → `breaks.length`
- High-impact changes? → filter `impact == "high"`
- Changes by category? → group by `category`
- Change type (behavioral/source)? → `type`
## Navigation Flow (2 fetches)
```

9
release-notes/skills/cve-queries/SKILL.md
View File

@@ -9,6 +9,15 @@ description: CVE queries needing severity, CVSS, affected versions, or security
**STOP when you have the month index.** `_embedded.disclosures[]` contains severity, CVSS, titles, and fix commits. Only fetch `cve.json` for full CVSS vectors, CWE, or package version ranges.
## Quick Answers (from month index)
Once you have the month index, answer directly from `_embedded.disclosures[]`:
- CVE severity? → `cvss_severity`
- CVSS score? → `cvss_score`
- Which versions affected? → `affected_releases`
- Fix commits? → `fixes[].href`
## Navigation Flow
```

12
release-notes/skills/dotnet-releases/SKILL.md
View File

@@ -17,12 +17,12 @@ Fetch when your query matches. **Core Rules apply to all.**
| Skill | Fetch When | URL |
| ----- | ---------- | --- |
| cve-queries | CVE severity, CVSS, history | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/cve-queries/SKILL.md> |
| breaking-changes | Compatibility, migration | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/breaking-changes/SKILL.md> |
| version-eol | EOL versions, lifecycle | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/version-eol/SKILL.md> |
| os-support | Distros, packages, glibc | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/os-support/SKILL.md> |
| navigation-flows | Multi-hop, unsure which links | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/navigation-flows/SKILL.md> |
| schema-reference | Document structure, properties | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/schema-reference/SKILL.md> |
| 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> |
| 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> |
| 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> |
| 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> |
| 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> |
| schema-reference | Need to understand document structure or properties | <https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/release-notes/skills/schema-reference/SKILL.md> |
## Core Rules

9
release-notes/skills/os-support/SKILL.md
View File

@@ -17,6 +17,15 @@ description: OS packages, distro support, glibc/musl requirements
**Pick ONE file** based on your query—don't fetch both.
## Quick Answers (from JSON files)
From `supported-os.json`:
- Is Ubuntu 24.04 supported? → `distributions[].releases[]`
- Minimum glibc version? → `libc[]` where `name == "glibc"`
From `os-packages.json`:
- What packages for Ubuntu? → `distributions[].releases[].packages[]`
## Navigation Flow (2 fetches)
```

9
release-notes/skills/version-eol/SKILL.md
View File

@@ -11,6 +11,15 @@ description: EOL versions, support lifecycle, version history, and release types
**For EOL versions:** STOP at the version index (e.g., `6.0/index.json`). It has `eol_date` and links to last security patch.
## Quick Answers (from llms.json)
For supported versions, answer directly from `_embedded.latest_patches[]`:
- When does .NET X go EOL? → `eol_date`
- Is .NET X LTS or STS? → `release_type`
- Current patch version? → `version`
- In maintenance mode? → `support_phase`
## Key Distinction
- **Supported versions** → data embedded in `llms.json`