Is this skill safe for production clusters?

Yes, it performs strictly read-only operations (kubectl get and ovn-nbctl list) and requires explicit confirmation if write permissions are detected in your kubeconfig.

Does it support OVN Interconnect mode?

Yes, it includes specialized logic to analyze UUID patterns and correctly differentiate between per-node and cluster-wide components in interconnect environments.

Which cluster types are supported?

It supports OVN-Kubernetes clusters, including OpenShift and Kind-based setups, and automatically scans standard locations for relevant kubeconfigs.

What output format does it provide?

It generates Mermaid.js markdown code which can be rendered directly in GitHub, VS Code, or other Mermaid-supported documentation tools.

OpenShift OVN Topology Generator

Name: OpenShift OVN Topology Generator
Author: openshift-eng

byopenshift-eng

•

Cloud Infrastructure

Generates interactive Mermaid-based network topology diagrams for OVN-Kubernetes clusters directly from live environments.

The OpenShift OVN Topology Generator is a specialized diagnostic skill designed to map complex OVN-Kubernetes network architectures. It automates the discovery of clusters, performs deep data collection of logical switches, routers, and ports, and intelligently distinguishes between per-node and cluster-wide components. By converting raw OVN database information into structured Mermaid diagrams, it enables developers and network engineers to visualize connectivity flows, verify IP/MAC assignments, and troubleshoot distributed network infrastructure with ease and security.

Key Features

01Detailed extraction of logical switches, routers, and port configurations

0229 GitHub stars

03Mermaid-formatted output for easy rendering in documentation and GitHub

04Intelligent placement analysis for per-node vs. cluster-wide OVN components

05Automated discovery of OVN-Kubernetes clusters across multiple kubeconfigs

06Read-only safety verification with explicit warnings for high-privilege credentials

Use Cases

01Generating up-to-date infrastructure documentation for OpenShift clusters

02Visualizing complex OVN Interconnect architectures for network debugging

03Auditing IP and MAC address assignments across logical network components

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add openshift-eng/ai-helpers generating-ovn-topology

For use in Claude.ai and ChatGPT

Download Skill