openclaw-ghsa-maintainer

Inspect, patch, and publish GitHub Security Advisories for the OpenClaw repository.

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill openclaw-ghsa-maintainer-amirulandalib
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-ghsa-maintainer
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/.agents/skills/openclaw-ghsa-maintainer
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill openclaw-ghsa-maintainer-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing GitHub Security Advisories (GHSA) involves fragile API constraints, private fork checks, and Markdown formatting pitfalls that can cause failed publishes or malformed advisory content. This Skill encodes the correct workflow so maintainers avoid common footguns like HTTP 422 errors and escaped newline corruption. ## Core Features & Use Cases - Advisory Inspection: Fetch advisory state, linked private fork details, and the latest published npm version before making changes. - Safe Patching Workflow: Build PATCH payloads with jq and heredoc-based Markdown files, applying severity and CVSS vector updates in separate calls as the API requires. - Publish Verification: Confirm private fork PRs are closed, publish by setting state to published, and re-fetch to validate state, published_at, and clean description formatting. - Use Case: A maintainer needs to publish a draft GHSA for a patched vulnerability. The Skill guides them through checking open PRs on the private fork, writing the advisory description safely, sequencing the PATCH calls, and verifying the published result. ## Quick Start Use the openclaw-ghsa-maintainer skill to inspect advisory GHSA-xxxx, prepare its patch payload, and publish it after 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 via the API?

Publish a GHSA by sending a PATCH request to /repos/OWNER/REPO/security-advisories/GHSA with the state field set to published. There is no separate publish endpoint. Verify afterward that state equals published and published_at is set.

How do I update a GHSA description without formatting errors?

Write the advisory Markdown to a temp file using a heredoc, then build the JSON payload with jq using --rawfile to embed the description. Avoid hand-escaped shell JSON or escaped newline strings, which produce literal backslash-n characters in the published advisory.

Why does publishing a GitHub Security Advisory fail with HTTP 422?

Publishing fails with HTTP 422 when required fields are missing or the advisory's private fork still has open pull requests. List open PRs on the private fork with gh pr list and close them before attempting to publish.

Can I set severity and cvss_vector_string in the same GHSA PATCH call?

No, the GHSA API does not accept severity and cvss_vector_string in the same PATCH call. Send them in separate PATCH requests, then verify the updated fields by re-fetching the advisory.

What should security advisory text avoid including before publication?

Advisory draft text and public comments should avoid raw commit hashes, PR titles or numbers, and fix-mechanism summaries. Use patched-version fields or release-only wording, keeping SHAs and implementation notes in internal evidence.