RHDH Users Skill Pack

Agent Skills for adopting and using Red Hat Developer Hub (RHDH) effectively.

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

What's included

Skill	Use when you want to…
rhdh-templates	Author and validate RHDH Software Templates with AI-guided workflows
rhdh-upgrade-helper	Prepare for an RHDH upgrade — resolves OCI plugin references, validates tags, searches RHDHBUGS Jira for known bugs, filters breaking changes by your config, and computes a 0–100 Readiness Score
skill-maker	Create, audit, and consolidate Agent Skills following the open standard

Upgrade assessment (rhdh-upgrade-helper)

Analyzes your RHDH configuration against a target release and produces a personalized migration plan — showing exactly what affects your setup and what doesn't. Works with Helm, Operator, and rhdh-local deployments.

• rhdh-upgrade-helper — Upgrade assessment for RHDH. Resolves OCI references for every plugin via the rhdh-plugin-export-overlays overlay repo workspace metadata and validates existing OCI plugin tags against the target release. Searches the RHDHBUGS Jira project per-plugin for known bugs affecting your versions. Filters breaking changes into "Affects You" vs "Does NOT Affect You" based on your actual config. Computes a 0–100 Readiness Score with transparent breakdown. Bundled release notes for RHDH 1.4–1.10. Workflows:
  • full-report — Generate a complete upgrade report from config files or a .rhdh-upgrade-helper.yaml.
  • interactive — Guided assessment when no config files are available.
  • help — Show usage, arguments, and examples.

Example prompts:

• "Analyze my values.yaml for upgrading from RHDH 1.8 to 1.10"
• "What breaks if I upgrade to RHDH 1.10?"
• "Run an upgrade assessment on my rhdh-local project"

Software Templates (rhdh-templates)

Interactive authoring for RHDH Scaffolder templates — templatize an existing repo, create from scratch, fix common gotchas, and validate locally or against a running instance.

• rhdh-templates — Interactive authoring and validation for Software Templates. Includes curated reference catalog (official library + AI quickstarts), worked examples (nodejs-backend, java-springboot) and bundled JSON Schema validation. Sub-commands:
  • init — Check tooling, scaffold template repo layout, optional RHDH connectivity.
  • templatize — Convert existing codebase into a parameterized template.
  • create — Guided from-scratch template authoring when no reference code exists.
  • add-parameter — Add a parameter or parameter group to existing template.yaml.
  • add-step — Add a scaffolder step to existing template.yaml.
  • add-skeleton — Add or parameterize skeleton files with Nunjucks.
  • create-location — Generate or update root location.yaml for catalog registration.
  • fix-gotchas — Auto-fix common RHDH template mistakes (raw/endraw blocks, catalog-info path, etc.).
  • validate — Local YAML schema, gotcha validation, and optional Nunjucks lint via --lint-skeleton (no RHDH required).
  • list-actions — List available Scaffolder actions from a running RHDH instance.
  • dry-run — Test template execution via Scaffolder v2 dry-run API.
  • explain-action — Show action input schema or template parameter schema.
  • example-catalog — Browse curated reference templates (official library, AI quickstarts, bundled).

Example prompts:

• "Help me turn this Node.js repo into an RHDH Software Template"
• "Validate my template.yaml and fix Scaffolder gotchas"
• "List scaffolder actions available on my RHDH instance"

Agent Skills authoring (skill-maker)

Create, audit, or consolidate Agent Skills — useful when packaging your own RHDH workflows or contributing skills to this pack.

• skill-maker — Interviews the user about intent, scope, and edge cases before drafting. Covers SKILL.md structure, frontmatter, progressive disclosure, description optimization, script bundling, sub-command architecture, and review. Capabilities:
  • Create — Guided interview and drafting of a new skill from scratch.
  • Audit — Review, improve, or debug an existing SKILL.md (trigger issues, structure, description).
  • Consolidate — Merge multiple skills into fewer using router patterns.

Example prompts:

• "Help me create a skill for our team's RHDH onboarding workflow"
• "Audit this SKILL.md — it never triggers when I expect it to"
• "Merge these two skills into one router skill"

Installation

npx skills add redhat-developer/rhdh-users-skill-pack

Or install only one skill:

npx skills add redhat-developer/rhdh-users-skill-pack --skill rhdh-templates
npx skills add redhat-developer/rhdh-users-skill-pack --skill skill-maker

List skills without installing

npx skills add redhat-developer/rhdh-users-skill-pack --list

Target a specific agent

npx skills add redhat-developer/rhdh-users-skill-pack -a claude-code
npx skills add redhat-developer/rhdh-users-skill-pack -a cursor

Supported agents include Claude Code, Cursor, Codex, Pi, and many others.

Local checkout (development)

git clone https://github.com/redhat-developer/rhdh-users-skill-pack.git
npx skills add ./rhdh-users-skill-pack

How to use

1. Install the pack (see above).
2. Open your project in an agent-enabled editor or CLI.
3. Describe your goal in plain language — for example, "help me turn this repo into an RHDH Software Template."

You can also name the skill explicitly:

Use the rhdh-templates skill to validate my template.yaml
Use the skill-maker skill to audit my SKILL.md

Frequently asked questions

What is an Agent Skill?

A folder with a SKILL.md file (YAML front matter + instructions) that agents load when relevant. See the Agent Skills specification.

How is this different from redhat-developer/rhdh-skill?

This repository is the user-facing skill pack — skills for adopting and operating RHDH. The rhdh-skill repo adds skills used by the RHDH engineering team (Jira, release management, Extensions Catalog, lifecycle checks, CI tooling) that are not needed for most RHDH users.

Can I contribute a new skill?

Yes. See CONTRIBUTING.md. Proposed skills should help RHDH users adopt or operate the platform and follow the Agent Skills open standard. Use skill-maker to draft and review new skills before opening a PR.

Where do I get help?

• RHDH product documentation: Red Hat Developer Hub
• Issues and feature requests: JIRA (RHIDP)

Development

For contributors validating changes locally:

git clone https://github.com/redhat-developer/rhdh-users-skill-pack.git
cd rhdh-users-skill-pack
uv sync --extra dev
git config core.hooksPath .githooks
uv run pytest

See CONTRIBUTING.md and AGENTS.md for contribution guidelines.

License

Apache-2.0 — see LICENSE.