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.

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

Bump UBI / RHEC base image tags and refresh @sha256 digests in rhdh and rhdh-operator (see rhdh-repos).

• update-base-image — Analyze and update Containerfile / Dockerfile using rhdh-downstream scripts (build/scripts/). Tags must be major.minor-buildid or x.y.z-buildid; bare numeric registry tags are ignored. Bundled analyze-base-images.sh; run updateBaseImages.sh per repo. Requires skopeo login registry.redhat.io.

npx skills add redhat-developer/rhdh-skill --skill update-base-image

Local Testing

Test plugins in a local RHDH instance before deploying.

• rhdh-local — Enable/disable plugins, switch between customized and pristine configs, run health checks, backup/restore configurations via the rhdh-local-setup customization system.

Jira