What problem does it solve?
This Skill helps maintainers inspect, validate, and publish GitHub Security Advisory (GHSA) updates without breaking GitHub’s GHSA API rules or accidentally publishing invalid content.
Core Features & Use Cases
- Advisory state inspection: Fetches the target advisory and checks the current npm version to confirm expected vulnerability metadata and payload shape before changes.
- Private fork PR validation: Verifies the linked private fork has no open PRs to satisfy GHSA publish constraints.
- Safe Markdown and JSON preparation: Generates advisory Markdown safely via a temp file and uses jq to construct correct PATCH payloads.
- Correct PATCH sequencing for GHSA fields: Applies GHSA PATCH calls in the required order, including handling field-setting constraints (e.g., not setting severity and cvss_vector_string together).
- Post-publish verification: Re-fetches the advisory and confirms published state, timestamps, and that descriptions do not contain escaped newline artifacts.
Quick Start
Use the openclaw-ghsa-maintainer skill to update and publish the GHSA for a specific advisory number after confirming the advisory guardrails in SECURITY.md and verifying the private fork has no open PRs.