openclaw-ghsa-maintainer

Inspect, patch, and publish GitHub Security Advisories with ordered PATCH sequencing.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/JOHNNYWHITEMIKE/openclaw --skill openclaw-ghsa-maintainer-johnnywhitemike
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-ghsa-maintainer
Source: https://github.com/JOHNNYWHITEMIKE/openclaw/tree/main/openclaw/.openclaw/openclaw/.agents/skills/openclaw-ghsa-maintainer
Command: npx skills add https://github.com/JOHNNYWHITEMIKE/openclaw --skill openclaw-ghsa-maintainer-johnnywhitemike

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about openclaw-ghsa-maintainer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish a GitHub Security Advisory without breaking GHSA API rules?

To publish a GitHub Security Advisory safely, you must verify the advisory state, ensure the private fork has no open PRs, construct PATCH payloads with jq, and apply ordered updates to avoid violating GHSA API sequencing constraints.

Why does my GHSA publish fail when setting severity and cvss_vector_string together?

Publishing a GHSA fails when setting severity and cvss_vector_string together because GitHub enforces field-setting constraints. You must apply PATCH calls in the required order to avoid conflicting field updates during advisory publication.

How do I validate a private fork before publishing a GitHub security advisory?

Validating a private fork before publishing a GitHub security advisory requires checking that the linked fork has no open pull requests, which satisfies the mandatory GHSA publish constraints for repository security advisories.

How do I fix escaped newline artifacts in published GHSA descriptions?

To fix escaped newline artifacts in published GHSA descriptions, generate advisory Markdown safely via a temp file and verify description newline integrity post-publish by re-fetching the advisory to confirm correct formatting.

Do I need to check SECURITY.md before updating a GitHub security advisory?

Yes, you need to check SECURITY.md before updating a GitHub security advisory to confirm advisory guardrails and ensure all GHSA-only actions honor the repository's specified security policy constraints.

What is the correct PATCH sequencing for GitHub security advisory fields?

Correct PATCH sequencing for GitHub security advisory fields involves fetching advisory state, validating npm version metadata, using jq for payload correctness, and applying ordered PATCH updates while respecting field constraints like severity and cvss_vector_string.