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

Add shows property to ai_skills and clarify CVE embedded data

Browse Source 
- Add shows property to ai_skills explaining what each skill provides
- Expand Shows column in llms.txt skills table
- Add "Quick rule" note clarifying _embedded has counts/IDs only, fetch month index for CVSS

Based on Haiku 4.5 feedback: skills weren't fetched because cost-benefit unclear.

🤖 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-12 15:08:26 -08:00
parent 096c40ce6e
commit a61d51361d
2 changed files with 6 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
llms.txt
View File

@@ -26,8 +26,8 @@ Machine-readable .NET release, CVE, and compatibility data for AI assistants.
| Skill | Trigger (`use_when`) | Shows | | Skill | Trigger (`use_when`) | Shows |
|-------|----------------------|-------| |-------|----------------------|-------|
| `navigation-diagram` | Multi-hop query and unsure which links to follow | Visual fetch sequences | | `navigation-diagram` | Multi-hop query and unsure which links to follow | Visual fetch sequences, link relations, fetch counts |
| `schema-reference` | CVE/security query needing CVSS vectors, CWE, or field definitions | Schema definitions, enums | | `schema-reference` | CVE/security query needing CVSS vectors, CWE, or field definitions | Severity levels, affected package ranges, field enums |
Fetch a skill BEFORE navigating when your query matches its trigger. One extra fetch prevents wrong turns. Fetch a skill BEFORE navigating when your query matches its trigger. One extra fetch prevents wrong turns.
@@ -73,6 +73,8 @@ These shortcuts are the key to efficient navigation — use them to skip the roo
## CVE Queries ## CVE Queries
**Quick rule:** `_embedded.latest_security_month[]` has counts and IDs only — fetch the month index for CVSS scores and severity.
**For current security status:** `_embedded.latest_security_month[]` has `cve_count` and `cve_records[]` (IDs only) per version. For severity/CVSS scores, follow the `self` link to the month index. **For current security status:** `_embedded.latest_security_month[]` has `cve_count` and `cve_records[]` (IDs only) per version. For severity/CVSS scores, follow the `self` link to the month index.
**For CVE history:** Follow `latest-security-month` link, then walk `prev-security` links. Each month index has `_embedded.disclosures[]` with: **For CVE history:** Follow `latest-security-month` link, then walk `prev-security` links. Each month index has `_embedded.disclosures[]` with:

2
release-notes/llms.json
View File

@@ -7,11 +7,13 @@
{ {
"skill": "navigation-diagram", "skill": "navigation-diagram",
"use_when": "Your query spans multiple hops and you're unsure which links to follow", "use_when": "Your query spans multiple hops and you're unsure which links to follow",
"shows": "Visual fetch sequences for every query type, link relations, fetch counts",
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/llms/navigation-diagram.txt" "href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/llms/navigation-diagram.txt"
}, },
{ {
"skill": "schema-reference", "skill": "schema-reference",
"use_when": "CVE/security query needing CVSS vectors, CWE, or field definitions", "use_when": "CVE/security query needing CVSS vectors, CWE, or field definitions",
"shows": "Severity levels, affected package ranges, field enums, file type schemas",
"href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/llms/schema-reference.txt" "href": "https://raw.githubusercontent.com/dotnet/core/refs/heads/release-index/llms/schema-reference.txt"
} }
], ],