rh-ssg-release-notes

Review Red Hat release notes for Supplementary Style Guide compliance.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/redhat-documentation/redhat-docs-agent-tools --skill rh-ssg-release-notes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rh-ssg-release-notes
Source: https://github.com/redhat-documentation/redhat-docs-agent-tools/tree/main/plugins/docs-tools/skills/rh-ssg-release-notes
Command: npx skills add https://github.com/redhat-documentation/redhat-docs-agent-tools --skill rh-ssg-release-notes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the review of Red Hat release notes, ensuring they adhere to the strict guidelines of the Red Hat Supplementary Style Guide (SSG), thereby improving clarity, consistency, and compliance across documentation.

Core Features & Use Cases

  • SSG Compliance Check: Verifies release notes against specific rules for tense, headings, Jira references, AsciiDoc formatting, and content types (new features, enhancements, rebases, etc.).
  • Targeted Review: Focuses on identifying and flagging deviations from SSG standards, categorizing them as required or suggested improvements.
  • Use Case: A technical writer can use this Skill to quickly audit a set of release notes before publication, catching potential errors in tense, formatting, or missing Jira references, ensuring a higher quality final document.

Quick Start

Use the rh-ssg-release-notes skill to review the attached release notes document for SSG compliance.

Frequently Asked Questions about rh-ssg-release-notes

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

FAQPage Schema
How do I check if my Red Hat release notes meet SSG compliance standards?

To check SSG compliance for Red Hat release notes, review them against the Supplementary Style Guide rules for tense consistency, informative headings, Jira ticket references, and AsciiDoc formatting. This verifies clarity, user impact, and specific content type guidelines like new features and fixed issues.

What is the best way to automate release notes review for tense consistency and AsciiDoc formatting?

Automating release notes review involves processing the document to validate AsciiDoc formatting and verify tense consistency against the Supplementary Style Guide. This process flags deviations as required or suggested improvements, ensuring technical accuracy and adherence to specific content type rules.

Does the SSG compliance check validate Jira ticket references in release notes?

Yes, SSG compliance checks validate Jira ticket references in release notes. The review process specifically scans for missing Jira references and flags them as deviations, ensuring that all technical issues, enhancements, and fixed issues are properly tracked according to Red Hat guidelines.

How do I audit release notes for specific content types like deprecated features and technology previews?

To audit release notes for content types like deprecated features and technology previews, validate the document against the Supplementary Style Guide. This checks adherence to specific rules for each content category, ensuring appropriate user impact descriptions and technical accuracy for rebases and enhancements.

What tense should be used in Red Hat release notes to pass SSG compliance?

Red Hat release notes must maintain tense consistency to pass SSG compliance. The review process checks for deviations from the Supplementary Style Guide standards, flagging any inconsistent tense usage as a required or suggested improvement before the document is published.

Why does my release notes review flag missing AsciiDoc formatting as a required improvement?

AsciiDoc formatting is flagged as a required improvement because SSG compliance mandates strict formatting rules. The review process identifies deviations from these Supplementary Style Guide standards, categorizing formatting errors and missing Jira references to improve clarity and consistency across documentation.