Skip to content

Add verify-releases and update-release-graph skills#10332

Merged
richlander merged 5 commits intomainfrom
consolidated-skills
Apr 1, 2026
Merged

Add verify-releases and update-release-graph skills#10332
richlander merged 5 commits intomainfrom
consolidated-skills

Conversation

@richlander
Copy link
Copy Markdown
Member

@richlander richlander commented Mar 31, 2026

Consolidates two new Copilot skills from separate PRs/branches into a single validated PR.

New skills

Skill Purpose Tool
verify-releases Validate release URLs, SHA512 hashes, CDN latest.version, aka.ms redirects dotnet-release verify releases
update-release-graph Regenerate HAL+JSON release information graph (version, timeline, llms indexes) dotnet-release generate indexes

Validation results

Each skill was tested against live data:

Skill Test Result
verify-releases dotnet-release verify releases 9.0 release-notes --skip-hash ✅ 56/56 URLs, CDN, aka.ms all passed
update-release-graph dotnet-release generate indexes release-notes /tmp/output ✅ Full graph generated — 14 versions, llms.json correct
update-supported-os (existing) dotnet-release generate supported-os 10.0 release-notes ✅ Regenerated, already current
update-os-packages (existing) dotnet-release generate os-packages 10.0 release-notes ✅ Regenerated, already current
update-distro-packages (existing) dotnet-release generate dotnet-dependencies 10.0 release-notes ✅ Generated successfully

Files

File Purpose
.github/skills/verify-releases/SKILL.md Skill definition with prerequisites, commands, process, troubleshooting
.github/skills/verify-releases/references/verify-output-example.md Real verification output from all supported versions
.github/skills/update-release-graph/SKILL.md Skill definition covering graph architecture, generators, source data, workflows

Supersedes

richlander and others added 4 commits March 31, 2026 14:03
Documents the workflow for regenerating the HAL+JSON release
information graph using the VersionIndex, ShipIndex, and LlmsIndex
generators from distroessed. Covers source data conventions,
graph topology, and validation steps.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
New Copilot skill that validates .NET release data using dotnet-release
v0.5.0+ verify releases command. Checks URL liveness, SHA512 file hashes,
CDN latest.version files, and aka.ms redirect targets.

Includes:
- SKILL.md with full process documentation, commands, timing expectations,
  troubleshooting, and report template
- Reference example with actual verification output from all supported
  versions (8.0, 9.0, 10.0, 11.0)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Describes how to use the dotnet-cve-enricher tool to synthesize, validate,
and enrich cve.json files in the release-notes timeline directory.

Covers:
- Synthesizing CVE records from releases.json + MSRC data
- Validating existing cve.json for data integrity
- Updating lookup dictionaries and CVSS/CNA data
- Agent usage with --json output mode

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Remove --version "0.*" workaround from all skill prerequisites now
that 1.1.0 is the latest version on the GitHub Packages feed.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

## When to use

- A new .NET security update ships and needs a `cve.json` file created
Copy link
Copy Markdown
Member

@leecow leecow Mar 31, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Given that we're going to start handling cve.json generation on the backend, I have concerns about this directive. Does the skill take this into account? How does the skill interact with existing cve.json files?

- A new .NET security update ships and needs a `cve.json` file created
- Backfilling historical months that don't yet have CVE timeline data
- Validating existing `cve.json` files for data integrity issues
- Enriching CVE records with CVSS scores, CWE, acknowledgments from MSRC/CVE.org
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is required data on the backend

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Excellent points. There are two aspects about that:

  • When will that happen?
  • We still need these capabilities for CVE enrichment after the fact if CVE information changes, particularly for old CVEs.

dotnet tool install -g Dotnet.Release.Tools \
--add-source https://nuget.pkg.github.com/richlander/index.json \
--version "0.*"
--add-source https://nuget.pkg.github.com/richlander/index.json
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

are these urls correct?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes and no.

  • the repo should move from richlander to dotnet org
  • The intent is to continue using GH packages and not nuget.org because the packages have a very limited audience.


### 2. Validate — check existing cve.json

Run validation before committing or after manual edits:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The current plan is that no edits happen outside of the cve authoring UI and generation process. This seems to conflict with that goal.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What happens if CVSS score or title changes after the fact? I thought that this sometimes happens?

We can remove the CVE-enricher skill. that's likely a good idea until we resolve the workflow.

The cve-enricher tool isn't ready yet. Remove the skill to keep
the PR focused on verify-releases and update-release-graph.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@richlander richlander changed the title Add verify-releases, update-release-graph, and cve-enricher skills Add verify-releases and update-release-graph skills Mar 31, 2026
@richlander richlander merged commit 73d2535 into main Apr 1, 2026
5 checks passed
@richlander richlander deleted the consolidated-skills branch April 1, 2026 01:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants