rhdh

RHDH Skill

Agent skills for the Red Hat Developer Hub team. Covers plugin development, overlay management, local testing, Jira workflows, and day-to-day RHDH engineering — so your agent knows the ecosystem instead of hallucinating through it.

Quick start: npx skills add redhat-developer/rhdh-skill — works with 50+ coding agents.

Why This Exists

RHDH spans a dozen repositories, four Jira projects, version-specific Backstage compatibility, overlay CI pipelines, and a copy-sync customization system for local testing. Without guidance, agents hallucinate version numbers, use the legacy backend system, construct OCI URLs by hand, and miss project-specific conventions that are impossible to learn from training data alone.

These skills encode the gotchas, workflows, and tribal knowledge so you don't re-explain them every session.

What's Inside

Plugin Development

Build dynamic plugins from scratch — backend or frontend — and get them deployed.

• create-plugin — Full plugin lifecycle: scaffold, implement, export, package, and wire RHDH dynamic plugins. Sub-commands for backend, frontend, export, and wiring.
  • backend — Backend plugins (APIs, scaffolder actions, catalog processors) using the new backend system.
  • frontend — Frontend plugins (pages, entity cards, themes) with Scalprum federation.
  • export — Export, package (OCI/tgz/npm), and push to a container registry.
  • wiring — Analyze plugin source and generate dynamic-plugins.yaml wiring config.

NFS Migration

Migrate your plugins from the legacy Backstage frontend system to the New Frontend System (NFS).

• nfs-migration -- Analyzes your existing plugin, applies the right Blueprint patterns, updates exports, and verifies the result. Two approaches: alpha (default, NFS at ./alpha) or colocated (NFS + legacy both from root). Reference files cover every extension type, mount point mapping, operator config, gotchas, and verification.

Backstage Upgrade

Upgrade @backstage/* dependencies in your plugin to align with a target RHDH or Backstage release.

• backstage-upgrade -- Discovers current versions, determines the target using the RHDH→Backstage version matrix, runs backstage-cli versions:bump, migrates moved packages, guides through breaking changes from upstream changelogs, and verifies the result. Composable — the NFS migration skill chains into it automatically when deps are outdated.

Extensions Catalog

Manage plugins in the rhdh-plugin-export-overlays repository.

• overlay — Onboard new plugins, update versions, fix CI failures, triage and analyze PRs, trigger /publish. Covers both plugin-owner and core-team workflows.

Konflux / Tekton

Update Konflux task digests and apply MIGRATION.md pipeline changes in rhdh-plugin-catalog or rhdh midstream.

• konflux-tekton-updates — Run .tekton/updateDigests.sh --minor --no-push, apply build-definitions task migrations, update shared pipelines/templates and PLR generators. Repo-specific file lists: plugin-catalog, RHDH midstream.

npx skills add redhat-developer/rhdh-skill --skill konflux-tekton-updates

Platform Lifecycle

Check version support status for platforms and integrations used by RHDH.

• lifecycle — Check version lifecycle and support status for OCP, AKS, EKS, GKE, RHDH releases, RHBK, Quay, PostgreSQL, and any Red Hat product via the Product Life Cycles API.

CI / Prow

Manage Prow CI job configurations and trigger nightly E2E tests.

• prow — Manage Prow CI job configurations for RHDH in the openshift/release repository. List, generate, add, and remove OCP test entries and cluster pools. List K8s platform test entries (AKS, EKS, GKE). Analyze coverage gaps. Commission new release branches and decommission end-of-life ones.
• prow-trigger-nightly — Trigger RHDH nightly ProwJobs on demand via the OpenShift CI Gangway REST API. Supports both rhdh and rhdh-plugin-export-overlays repos with Gangway overrides for catalog index image, chart version, and Playwright version.

Base image