Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions rh-basic/.catalog/collection.json
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
{
"description": "CVE Explanation and Severity Rating",
"name": "red-hat-cve-explainer",
"summary_markdown": "Explain a CVE using Red Hat's severity rating system and recommend a course of action.\n**Use when:**\n- What is CVE-2024-1234?\n- How severe is this CVE?\n- Should I patch CVE-X immediately?\n**What it does:**\n- Looks up CVE metadata via Lightspeed MCP or Red Hat CVE pages\n- Maps to Red Hat severity (Critical/Important/Moderate/Low)\n- Links to applicable security advisories (RHSA/RHBA/RHEA)\n- Gives a concrete action recommendation per severity\n"
"summary_markdown": "Explain a CVE using Red Hat's severity rating system and recommend a course of action.\n**Use when:**\n- What is CVE-2024-1234?\n- How severe is this CVE?\n- Should I patch CVE-X immediately?\n**What it does:**\n- Looks up CVE metadata via the Red Hat Security MCP or Red Hat CVE pages\n- Maps to Red Hat severity (Critical/Important/Moderate/Low)\n- Links to applicable security advisories (RHSA/RHBA/RHEA)\n- Gives a concrete action recommendation per severity\n"
},
{
"description": "Diagnostic Data Gathering for Red Hat Support",
Expand All @@ -30,7 +30,7 @@
{
"description": "Product Lifecycle Status and Support Phase Lookup",
"name": "red-hat-product-lifecycle",
"summary_markdown": "Report the current lifecycle phase and support dates for any Red Hat product or version.\n**Use when:**\n- Is RHEL 8.6 still supported?\n- When does OpenShift 4.14 reach end of maintenance?\n- What App Streams are available for RHEL 9?\n**What it does:**\n- Retrieves lifecycle dates via Lightspeed MCP or Red Hat lifecycle pages\n- Explains what updates each phase receives (security, bug, features)\n- Gives a concrete action recommendation (upgrade, EUS, patch normally)\n- Explains Red Hat's backporting model when relevant\n"
"summary_markdown": "Report the current lifecycle phase and support dates for any Red Hat product or version.\n**Use when:**\n- Is RHEL 8.6 still supported?\n- When does OpenShift 4.14 reach end of maintenance?\n- What App Streams are available for RHEL 9?\n**What it does:**\n- Retrieves lifecycle dates via the Red Hat Security MCP or Red Hat lifecycle pages\n- Explains what updates each phase receives (security, bug, features)\n- Gives a concrete action recommendation (upgrade, EUS, patch normally)\n- Explains Red Hat's backporting model when relevant\n"
},
{
"description": "Support Ticket Severity and SLA Guidance",
Expand Down Expand Up @@ -125,9 +125,9 @@
"url": "https://access.redhat.com/product-life-cycles/"
},
{
"description": "Red Hat Insights console for inventory, CVE data, and patch advisory information.",
"title": "Red Hat Lightspeed",
"url": "https://console.redhat.com/insights"
"description": "Red Hat Security API MCP server providing live CVE, advisory, and errata data via browser SSO.",
"title": "Red Hat Security MCP",
"url": "https://security-mcp.api.redhat.com/mcp"
},
{
"description": "Official severity levels and SLA commitments for Red Hat support subscriptions.",
Expand Down
10 changes: 5 additions & 5 deletions rh-basic/.catalog/collection.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ contents:
- How severe is this CVE?
- Should I patch CVE-X immediately?
**What it does:**
- Looks up CVE metadata via Lightspeed MCP or Red Hat CVE pages
- Looks up CVE metadata via the Red Hat Security MCP or Red Hat CVE pages
- Maps to Red Hat severity (Critical/Important/Moderate/Low)
- Links to applicable security advisories (RHSA/RHBA/RHEA)
- Gives a concrete action recommendation per severity
Expand Down Expand Up @@ -70,7 +70,7 @@ contents:
- When does OpenShift 4.14 reach end of maintenance?
- What App Streams are available for RHEL 9?
**What it does:**
- Retrieves lifecycle dates via Lightspeed MCP or Red Hat lifecycle pages
- Retrieves lifecycle dates via the Red Hat Security MCP or Red Hat lifecycle pages
- Explains what updates each phase receives (security, bug, features)
- Gives a concrete action recommendation (upgrade, EUS, patch normally)
- Explains Red Hat's backporting model when relevant
Expand Down Expand Up @@ -151,9 +151,9 @@ resources:
- title: Red Hat Product Life Cycles
url: https://access.redhat.com/product-life-cycles/
description: Lifecycle phase dates for RHEL, OpenShift, Ansible, and other Red Hat products.
- title: Red Hat Lightspeed
url: https://console.redhat.com/insights
description: Red Hat Insights console for inventory, CVE data, and patch advisory information.
- title: Red Hat Security MCP
url: https://security-mcp.api.redhat.com/mcp
description: Red Hat Security API MCP server providing live CVE, advisory, and errata data via browser SSO.
- title: Red Hat Support Severity Definitions
url: https://access.redhat.com/support/policy/support_process
description: Official severity levels and SLA commitments for Red Hat support subscriptions.
Expand Down
6 changes: 3 additions & 3 deletions rh-basic/CLAUDE.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# rh-basic Plugin

You are a Red Hat assistant for IT professionals working with Red Hat products. You help users understand CVE severity and remediation, gather diagnostics for support cases, check product lifecycle status, determine support ticket severity, and configure the Red Hat Lightspeed MCP server.
You are a Red Hat assistant for IT professionals working with Red Hat products. You help users understand CVE severity and remediation, gather diagnostics for support cases, check product lifecycle status, and determine support ticket severity.

## Skill-First Rule

ALWAYS use the appropriate skill for Red Hat workflows. Do NOT call MCP tools (`lightspeed-mcp`) directly β€” skills enforce correct tool sequencing, fallback logic, and credential safety.
ALWAYS use the appropriate skill for Red Hat workflows. Do NOT call MCP tools (`red-hat-security`) directly β€” skills enforce correct tool sequencing, fallback logic, and credential safety.

To invoke a skill, use the Skill tool with the skill name (e.g., `/red-hat-cve-explainer`).

Expand Down Expand Up @@ -34,6 +34,6 @@ Skills fall back to `WebFetch` on public Red Hat documentation when this server
## Global Rules

1. **Never expose credentials** β€” do not display API keys, tokens, or client secrets. Only report whether required environment variables appear set.
2. **Skill-first** β€” always route through a skill rather than calling `lightspeed-mcp` tools directly.
2. **Skill-first** β€” always route through a skill rather than calling `red-hat-security` tools directly.
3. **Fallback gracefully** β€” skills fall back to `WebFetch` when MCP tools are unavailable; never decline a request solely because a tool is missing.
4. **Suggest next steps** β€” after completing a skill, suggest related skills the user might run next.
23 changes: 19 additions & 4 deletions rh-basic/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ Essential Red Hat skills for IT professionals working with Red Hat products. Thi

The agentic skill pack for Red Hat customers provides lightweight, self-contained skills that work with or without a configured MCP server. Each skill falls back to web sources when MCP tools are unavailable.

- **5 skills** covering the most common Red Hat support and operations workflows
- **1 MCP server integration** (Red Hat Lightspeed) for live CVE and inventory data
- **6 skills** covering the most common Red Hat support and operations workflows
- **1 MCP server integration** (Red Hat Security MCP) for live CVE and advisory data
- **Self-installing** via the `red-hat-get-started` skill

## Quick Start
Expand Down Expand Up @@ -72,7 +72,7 @@ Reports the current lifecycle phase and support dates for any Red Hat product or
- "What App Streams are available for RHEL 9?"

**What it does:**
- Retrieves lifecycle dates via Lightspeed MCP or Red Hat lifecycle pages
- Retrieves lifecycle dates via the Red Hat Security MCP or Red Hat lifecycle pages
- Explains what updates each phase receives (security, bug, features)
- Gives a concrete action recommendation (upgrade, EUS, patch normally)
- Explains Red Hat's backporting model
Expand All @@ -99,6 +99,20 @@ Fetches and installs all skills from the agentic skill pack for Red Hat customer
**Use when:**
- Setting up Red Hat skills for the first time in a project

### 6. **red-hat-security-mcp-setup** - Red Hat Security MCP Configuration

Adds the Red Hat Security MCP server to the current project's `.mcp.json` using HTTP transport and browser SSO.

**Use when:**
- "Set up the Red Hat Security MCP server"
- "Add red-hat-security to my MCP config"

**What it does:**
- Locates or creates `.mcp.json` in the project root
- Merges the `red-hat-security` HTTP transport entry without removing existing servers
- Explains the Red Hat Customer Portal SSO browser login flow
- Advises the user to restart Claude Code for the new server to take effect

## Skills Decision Guide

| User Request | Skill | Reason |
Expand All @@ -108,6 +122,7 @@ Fetches and installs all skills from the agentic skill pack for Red Hat customer
| "Is RHEL 8 still supported?" | **red-hat-product-lifecycle** | Lifecycle date lookup |
| "What severity is my support case?" | **red-hat-support-severity** | SLA guidance |
| "Install Red Hat skills" | **red-hat-get-started** | First-time setup |
| "Set up the Red Hat Security MCP server" | **red-hat-security-mcp-setup** | MCP server configuration |

## MCP Server Integration

Expand Down Expand Up @@ -139,13 +154,13 @@ rh-basic/
β”œβ”€β”€ red-hat-diagnostics/SKILL.md
β”œβ”€β”€ red-hat-get-started/SKILL.md
β”œβ”€β”€ red-hat-product-lifecycle/SKILL.md
β”œβ”€β”€ red-hat-security-mcp-setup/SKILL.md
└── red-hat-support-severity/SKILL.md
```

## References

- [Red Hat Customer Portal](https://access.redhat.com/)
- [Red Hat Lightspeed](https://console.redhat.com/insights)
- [Red Hat Product Lifecycle](https://access.redhat.com/product-life-cycles/)
- [Red Hat CVE Database](https://access.redhat.com/security/security-updates/#/cve)
- [Lola Package Manager](https://github.com/RedHatProductSecurity/lola)
Expand Down
Loading