RHDP Skills Marketplace

AI-powered skills for Red Hat Demo Platform content creation and provisioning.

Supports: Claude Code | VS Code with Claude Extension | Cursor 2.4+

✅ Note: All platforms support the Agent Skills open standard. Skills work natively in Claude Code, VS Code with Claude extension, and Cursor 2.4+.

📚 Full Documentation | Changelog | Contributing

PUBLIC REPOSITORY – DO NOT COMMIT SENSITIVE DATA

This is a public, world-readable repository. Everything committed here – skills, examples, templates, documentation – is visible to anyone on the internet.

NEVER include in any file (SKILL.md, examples, templates, docs, or code):

• Passwords, API keys, tokens, or secrets (real or internal)
• Internal hostnames, IP addresses, or non-public URLs
• Customer names, account IDs, or PII
• VPN endpoints, bastion addresses, or infrastructure details
• Service account credentials or kubeconfig data
• SSH keys, certificates, or private key material

Use placeholders (e.g., {password}, ``, example.com) instead. See the Security Guidelines section below.

---

🎯 I Want To…

Create a customer demo or workshop? → You want Showroom skills

• /showroom:create-demo - Build a presenter-led demo (you present, customers watch)
• /showroom:create-lab - Build a hands-on workshop (customers follow along step-by-step)

What you need:

1. Claude Code (CLI) or VS Code with Claude extension
2. This installer (see Quick Start below)
3. Your demo idea

What you DON’T need:

• No coding required
• No Git knowledge needed
• No command line experience required

RHDP Internal Team? → See Advanced Setup for AgnosticV and Health skills

---

Quick Start

Installation (Marketplace Method - Recommended)

Prerequisites: Install Claude Code first from https://claude.com/claude-code

Step 1: Start Claude Code in your terminal:

claude

Step 2: In Claude Code chat (NOT in terminal), add the RHDP marketplace:

# If you have SSH keys configured (shorter)
/plugin marketplace add rhpds/rhdp-skills-marketplace

# If you don't have SSH configured (use this)
/plugin marketplace add https://github.com/rhpds/rhdp-skills-marketplace

Step 3: In Claude Code chat, install the plugins you need:

# For workshop/demo creation
/plugin install showroom@rhdp-marketplace

# For AgnosticV catalogs (RHDP internal)
/plugin install agnosticv@rhdp-marketplace

# For deployment health checks (RHDP internal)
/plugin install health@rhdp-marketplace

Benefits:

• ✅ Standard installation (like dnf/brew)
• ✅ Automatic updates with /plugin marketplace update
• ✅ Version management and rollback
• ✅ Clean uninstall

See MARKETPLACE.md for complete plugin list and usage.

Available Plugins

Showroom Plugin (showroom@rhdp-marketplace) - Workshop and demo creation:

• /showroom:create-lab - Generate workshop lab modules
• /showroom:create-demo - Generate presenter-led demo content
• /showroom:verify-content - AI-powered quality validation
• /showroom:blog-generate - Transform content into blog posts

AgnosticV Plugin (agnosticv@rhdp-marketplace) - RHDP infrastructure automation:

• /agnosticv:catalog-builder - Create/update AgnosticV catalog items & Virtual CIs
• /agnosticv:validator - Validate catalog configurations

Health Plugin (health@rhdp-marketplace) - Deployment validation:

• /health:deployment-validator - Create Ansible validation roles

FTL Plugin (ftl@rhdp-marketplace) - Full Test Lifecycle:

• /ftl:rhdp-lab-validator - Generate ZT runtime-automation playbooks for RHDP showroom labs (OCP/RHEL/AAP)

---

Namespaces

🎓 showroom (Public - Content Creation)

Purpose: Create high-quality workshop and demo content for Red Hat Showroom

Skills:

Workflow:

/create-lab → Write content → /verify-content → /blog-generate

Documentation: showroom/README.md

---

⚙️ agnosticv (RHDP Internal/Advanced - Provisioning)

Purpose: Manage RHDP catalog infrastructure provisioning and validation

Skills:

Workflow:

/agnosticv-catalog-builder → Test in RHDP → /create-lab (with UserInfo) → Deploy

Documentation: agnosticv/README.md

---

🏥 health (RHDP Internal/Advanced - Validation & Testing)

Purpose: Post-deployment validation, health checks, and automated testing

Skills:

Workflow:

Deploy catalog → /deployment-validator → Health checks → Verify readiness

Documentation: health/README.md

---

🧪 ftl (RHDP Internal/Advanced - Full Test Lifecycle)

Purpose: Generate automated grader and solver playbooks for Showroom workshop labs

Skills:

Workflow:

/ftl:rhdp-lab-validator
  → ftl:content-reader  (reads .adoc + vision analysis of screenshots)
  → ftl:solve-writer    (writes solve.yml with intent-based Playwright)
  → ftl:validate-writer (writes validate.yml with validation_check)
  → ftl:env-connector   (push → test → screenshot evidence → self-heal)

Self-healing: When UI changes break Playwright steps, env-connector takes a live screenshot, passes it to vision, and recovers the selector automatically.

Documentation: ftl/README.md

---

🤖 automation (RHDP Internal/Advanced - Intelligent Automation)

Purpose: Workflow automation, intelligent testing, and environment discovery

Skills:

Workflow:

/create-lab → /ftl:lab-validator (generate grader/solver) → Test workshop → Deploy to RHDP

Documentation: automation/README.md

---

What’s New — v2.15.0

AgnosticV Agent Decomposition

Both agnosticv:catalog-builder and agnosticv:validator are now orchestrators — they spawn parallel specialist agents, same pattern as showroom v2.14.

validator subagents (all run in parallel):

catalog-builder subagents (run in parallel for MODE 1):

Publishing House Headless Mode for AGV

agnosticv:catalog-builder and agnosticv:validator now accept ph_payload — PH automation (phase 7b) can generate catalog files and validate them silently. Returns structured JSON. No PH code changes needed.

YAML Parse Gate

agnosticv:validator stops immediately on broken YAML — no false-positive errors from parallel agents on unreadable files. CI type classification resolved once by the orchestrator.

📖 Full documentation →

---

What’s New — v2.14.0

Agent Orchestrator Pattern (Showroom)

All showroom skills now delegate work to specialized agents running in parallel — skills orchestrate, agents execute.

~6× faster: verify-content on a 6-module lab goes from 8 min → ~90 sec.

Publishing House Integration (Showroom)

verify-content, create-lab, create-demo support headless ph_payload mode. No PH code changes needed.

Personal Writing Style

All content creation skills accept a writing style profile. Auto-humanizer pass runs on all generated content automatically.

📖 Full documentation →

---

Updates

Check for and install updates:

curl -fsSL https://raw.githubusercontent.com/rhpds/rhdp-skills-marketplace/main/update.sh -o /tmp/rhdp-update.sh
bash /tmp/rhdp-update.sh

The updater will:

• Detect your current installation
• Check for newer versions
• Show changelog
• Prompt to update if available

---

Usage Examples

Creating a Workshop Lab

# In Claude Code or Cursor
/create-lab

# Answer the prompts:
# - Lab name: "CI/CD with OpenShift Pipelines"
# - Abstract: "Learn cloud-native CI/CD with Tekton"
# - Technologies: Tekton, OpenShift, Pipelines
# - Module count: 3

# Skill generates:
# ├── content/modules/ROOT/
# │   ├── pages/
# │   │   ├── index.adoc
# │   │   ├── module-01.adoc
# │   │   ├── module-02.adoc
# │   │   └── module-03.adoc
# │   └── partials/
# │       └── _attributes.adoc

Creating an AgnosticV Catalog

# In Claude Code or Cursor
/agnosticv-catalog-builder

# Choose mode: 1 (Full Catalog)
# Git workflow runs automatically (pull main, create branch)
# Answer the prompts:
# - Catalog name: "Agentic AI on OpenShift"
# - Infrastructure: CNV multi-node
# - Multi-user: Yes
# - Workloads: OpenShift AI, LiteLLM, Showroom

# Skill generates and auto-commits:
# ~/work/code/agnosticv/agd_v2/agentic-ai-openshift/
# ├── common.yaml
# ├── description.adoc
# ├── dev.yaml
# └── info-message-template.adoc

Validating a Catalog

# In Claude Code or Cursor
/agnosticv-validator

# Skill checks:
# ✓ UUID format and uniqueness
# ✓ YAML syntax
# ✓ Workload dependencies
# ✓ Infrastructure recommendations
# ⚠️ Best practice suggestions

---

Platform Support

Claude Code (Recommended)

Skills are installed to:

• Skills: ~/.claude/skills/
• Docs: ~/.claude/docs/

Native Agent Skills support - skills work out of the box with /skill-name commands.

VS Code with Claude Extension

Skills are installed to:

• Skills: ~/.claude/skills/
• Docs: ~/.claude/docs/

Native Agent Skills support - same installation as Claude Code, skills work with /skill-name commands in VS Code.

Cursor 2.4+

⚠️ Workaround Installation: Cursor supports Agent Skills but not the Claude Code plugin marketplace. This uses a direct install script.

One-command install (run in your TERMINAL, not in Cursor chat):

curl -fsSL https://raw.githubusercontent.com/rhpds/rhdp-skills-marketplace/main/install-cursor.sh | bash

Installs all 7 skills with prompts and templates bundled. Restart Cursor after installation.

To update (run in your TERMINAL, not in Cursor chat):

curl -fsSL https://raw.githubusercontent.com/rhpds/rhdp-skills-marketplace/main/update-cursor.sh | bash

How to use:

1. Explicit invocation: /showroom-create-lab, /agnosticv-catalog-builder (hyphens, not colons)
2. Natural language: “Help me create a workshop lab”

Note: For full marketplace support with automatic updates, use Claude Code instead.

Requirements: Cursor 2.4.0+ • Full Guide →

---

Architecture

rhdp-skills-marketplace/
├── .claude-plugin/         # Claude Code plugin marketplace
│   └── marketplace.json
│
├── skills/                 # Flat structure for npx skills (Cursor)
│   ├── showroom-create-lab/
│   │   └── SKILL.md (symlink)
│   ├── showroom-create-demo/
│   │   └── SKILL.md (symlink)
│   ├── agnosticv-catalog-builder/
│   │   └── SKILL.md (symlink)
│   └── ... (7 total)
│
├── showroom/               # Plugin structure (Claude Code)
│   ├── .claude-plugin/plugin.json
│   ├── README.md
│   ├── skills/
│   │   ├── create-lab/SKILL.md
│   │   ├── create-demo/SKILL.md
│   │   ├── verify-content/SKILL.md
│   │   └── blog-generate/SKILL.md
│   └── docs/
│
├── agnosticv/              # Plugin structure (Claude Code)
│   ├── .claude-plugin/plugin.json
│   ├── README.md
│   ├── skills/
│   │   ├── catalog-builder/SKILL.md
│   │   └── validator/SKILL.md
│   └── docs/
│
├── health/                 # Plugin structure (Claude Code)
│   ├── .claude-plugin/plugin.json
│   ├── README.md
│   ├── skills/
│   │   └── deployment-validator/SKILL.md
│   └── docs/
│
├── VERSION                 # Current version
├── CHANGELOG.md            # Version history
└── docs/                   # GitHub Pages documentation

Dual Installation Support:

• Claude Code: Plugin marketplace (/plugin marketplace add)
• Cursor: npx skills (npx skills add)

---

Prerequisites

• Claude Code or Cursor installed
• Git installed
• For AgnosticV skills:
  • RHDP access
  • AgnosticV repository cloned to ~/work/code/agnosticv

---

Troubleshooting

Installation fails

# Run with verbose output
bash -x <(curl -fsSL https://raw.githubusercontent.com/rhpds/rhdp-skills-marketplace/main/install.sh)

Skills not showing up

1. Restart your editor (Claude Code or Cursor)
2. Verify installation:

   # For Claude Code
   ls ~/.claude/skills/
   
   # For Cursor
   ls ~/.cursor/skills/
   

Specify platform and namespace

You can skip interactive prompts by using command-line flags:

curl -fsSL https://raw.githubusercontent.com/rhpds/rhdp-skills-marketplace/main/install.sh -o /tmp/rhdp-install.sh
bash /tmp/rhdp-install.sh --platform claude --namespace showroom

# or for Cursor
bash /tmp/rhdp-install.sh --platform cursor --namespace all

---

Security Guidelines

This is a public repository. All content is world-readable and indexed by search engines. Every contributor must follow these rules.

What MUST NOT appear anywhere in this repo

Rules for skill authors

1. Use attribute placeholders – all environment-specific values must use {attribute} or `` syntax, never real values.
2. Examples must be synthetic – example YAML/config files must use example.com, 192.0.2.x (RFC 5737), and dummy UUIDs.
3. Credential patterns only – show the lookup('password', ...) pattern or {password} placeholder, never an actual credential.
4. No internal URLs – references to *.redhat.com internal systems (not public-facing) must be removed or replaced with generic descriptions.
5. Review before committing – scan your changes for anything that looks like a real credential, IP, hostname, or account identifier.

If you find sensitive data

If you discover committed secrets or sensitive data, do not just delete it in a new commit (it remains in git history). Instead:

1. Contact the repository maintainers immediately.
2. Rotate any exposed credentials.
3. The maintainers will rewrite history if necessary.

---

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Development Setup

# Clone repository
git clone [email protected]:rhpds/rhdp-skills-marketplace.git
cd rhdp-skills-marketplace

# Test installation locally
./install.sh --dry-run

---

Support

• Issues: GitHub Issues
• Slack: #forum-demo-developers
• Documentation: https://rhpds.github.io/rhdp-skills-marketplace

---

License

Apache License 2.0 - See LICENSE for details.

---

Credits

RHDP Development Team:

• Wolfgang Kulhanek
• Tony Kay
• Tyrell Reddy
• Juliano Mohr
• Mitesh Sharma
• Ritesh Shah

Maintainers:

• Prakhar Srivastava (@prakhar1985)
• Tony Kay
• Nate Stephany

---

Related Projects

• Red Hat Showroom
• AgnosticD
• AgnosticV