Skills

Each skill teaches your AI assistant (Claude Code or Cursor) how to work with a specific DevOps tool. Skills include a SKILL.md definition and reference documentation fetched from the tool’s upstream repository.

Available Skills

Skill Description Source Repository
AgnosticD v2 Ansible Agnostic Deployer for cloud provisioning via the agd CLI agnosticd/agnosticd-v2
Field-Sourced Content RHDP self-service catalog items via GitOps (Helm and Ansible patterns) rhpds/field-sourced-content-template
Patternizer Bootstrap Git repos into Validated Patterns for OpenShift tosin2013/patternizer
Showroom RHDP lab guide and terminal system (Antora/AsciiDoc content + Helm deployment) rhpds/showroom-deployer
Student Readiness Workshop environment readiness checker — verifies the student experience end-to-end Self-contained
Workshop Tester AI-as-student module tester — executes exercises and classifies failures Self-contained
AgnosticD Refactor Audit and improve existing AgnosticD v2 configs and workload roles against RHDP best practices Self-contained
VP Refactor Audit and improve existing Validated Pattern repos toward VP Operator and tier submission Self-contained
Skill Researcher Resolve open (RESEARCH NEEDED) questions by fetching upstream docs and writing findings back into all affected skills Self-contained
AgnosticD Deploy Test Validate an AgnosticD v2 deployment end-to-end — provisioning, workload completion, agnosticd_user_info data flow, and stop/start lifecycle Self-contained
VP Deploy Test Validate a Validated Pattern deployment end-to-end — VP Operator install, ArgoCD convergence, secrets delivery, and imperative jobs Self-contained
VP Deploy Validator Health check an already-running Validated Pattern — ArgoCD convergence, secrets, and jobs without reinstalling Self-contained
AgnosticD Hub-Student Architect, size, provision, and validate hub+student cluster topologies — Showroom on hub, each student on a separate SNO/compact cluster, with cloud quota pre-flight for AWS, GCP, and Azure Self-contained
VP Submission Audit a Validated Pattern against VP tier requirements (Community, Tested, Maintained) and guide the PR submission to validatedpatterns/docs Self-contained

Cross-Skill Relationships

Some skills work together. The installer and AI assistants recognize these relationships via the related_skills field in each SKILL.md. Currently:

Skill A Skill B Integration
AgnosticD v2 Field-Sourced Content AgnosticD provisions the OpenShift cluster; Field Content deploys onto it via the ocp4_workload_field_content workload role
AgnosticD v2 Showroom AgnosticD deploys Showroom as an infra_workload to serve lab guides on the cluster
Field-Sourced Content Showroom Field Content’s Helm example includes a components/showroom/ directory to deploy Showroom alongside the demo
AgnosticD v2 Student Readiness After agd provision, run student-readiness checks to verify the environment before handing to students
Showroom Student Readiness Verify Showroom lab guide accessibility, terminal functionality, and content-environment match
Student Readiness Workshop Tester Run readiness checks before module testing; workshop-tester depends on student-readiness passing
Showroom Workshop Tester Workshop-tester parses Showroom AsciiDoc for executable steps ([source,role="execute"])
AgnosticD v2 Workshop Tester Infra / Deployment Fix failures from testing often require AgnosticD config changes
AgnosticD v2 AgnosticD Refactor Refactor skill audits existing configs built with AgnosticD; escalates to agnosticd skill for deployment failures
AgnosticD Refactor Student Readiness After fixing audit findings, use student-readiness to verify the corrected environment end-to-end
AgnosticD Refactor Workshop Tester Infra / Deployment Fix failures in workshop-tester often require agnosticd-refactor audit to find root cause
Patternizer VP Refactor Refactor skill audits patterns initialized by Patternizer; escalates to patternizer for init/upgrade operations
Skill Researcher AgnosticD Refactor skill-researcher resolves AgnosticD RQ-1 through RQ-7 by writing verified findings into agnosticd-refactor audit areas
Skill Researcher VP Refactor skill-researcher resolves Validated Patterns RQ-1 through RQ-8 by writing verified findings into vp-refactor audit areas
AgnosticD v2 AgnosticD Deploy Test agnosticd-deploy-test validates deployments produced by agd provision; escalates back to agnosticd for setup issues
AgnosticD Refactor AgnosticD Deploy Test agnosticd-deploy-test escalates to agnosticd-refactor when provisioning or workload failures are found
Student Readiness AgnosticD Deploy Test agnosticd-deploy-test activates student-readiness after Phase 3 validation passes
Patternizer VP Deploy Test vp-deploy-test validates patterns initialized by patternizer
VP Refactor VP Deploy Test vp-deploy-test escalates to vp-refactor when convergence or secrets failures are found
Student Readiness VP Deploy Test vp-deploy-test activates student-readiness after Phase 4 validation passes
VP Deploy Test VP Deploy Validator vp-deploy-validator is the health-check-only complement — use for pre-demo checks or after CI/CD deploy without reinstalling
VP Deploy Validator VP Refactor vp-deploy-validator escalates to vp-refactor when convergence or secrets failures are found
VP Deploy Validator Student Readiness vp-deploy-validator activates student-readiness after health checks pass
AgnosticD v2 AgnosticD Hub-Student agnosticd-hub-student extends the AgnosticD topology to hub+student multi-cluster deployments
AgnosticD Deploy Test AgnosticD Hub-Student agnosticd-hub-student is the multi-cluster variant; agnosticd-deploy-test validates single-cluster deployments
Showroom AgnosticD Hub-Student agnosticd-hub-student wires Showroom’s terminal to student cluster APIs rather than the hub
Student Readiness AgnosticD Hub-Student agnosticd-hub-student activates student-readiness per student cluster after Phase 3
Skill Researcher AgnosticD Hub-Student skill-researcher resolves RQ-HUB-1 through RQ-HUB-7 for the hub+student topology
VP Deploy Validator VP Submission vp-deploy-validator surfaces vp-submission as the next step after HEALTHY; triggers destroy-and-redeploy gate on irrecoverable failures
VP Deploy Test VP Submission vp-deploy-test detects SUBMISSION_BLOCKING non-interactive install failures before patterns can be submitted
VP Refactor VP Submission vp-submission escalates structural pattern issues to vp-refactor before re-auditing tier readiness
Patternizer VP Submission vp-submission audits patterns initialized by patternizer for VP tier compliance
Skill Researcher VP Submission skill-researcher resolves VP-SUB-1 through VP-SUB-5 for submission criteria and docs structure

See ADR-010 for cross-skill dependencies, ADR-011 for validation and troubleshooting, ADR-012 for workshop module testing strategy, ADR-013 for refactor skills design, ADR-014 for the skill researcher workflow, ADR-015 for deployment pipeline testing and the operator confidence chain, ADR-016 for the hub+student topology skill, and ADR-017 for the VP submission skill and validator redeploy gate.

Validation Lifecycle

The validation skills follow a clear confidence-building progression. The goal of every step is to give an operator confidence they can run the workload with limited or no issues before going live.

agnosticd-deploy-test  →  student-readiness  →  workshop-tester  →  ftl:rhdp-lab-validator
vp-deploy-test         →  vp-deploy-validator →  student-readiness → workshop-tester  →  vp-submission
(pipeline worked?)        (still healthy?)       (student POV)        (exercises work?)    (submit to VP)
  1. AgnosticD Deploy Test / VP Deploy Test verifies the deployment pipeline produced a correct, fully-working result (provisioning, convergence, lifecycle). VP Deploy Test also detects SUBMISSION_BLOCKING non-interactive install failures.
  2. VP Deploy Validator (VP only) health-checks an already-running pattern without reinstalling. Activates the destroy-and-redeploy gate after two failed remediation cycles or on non-interactive install failure.
  3. Student Readiness verifies the deployed environment is accessible and ready from the student’s perspective
  4. Workshop Tester executes module exercises against the live environment and classifies failures — the final confidence gate before going live
  5. VP Submission (VP only) audits the pattern against Community, Tested, and Maintained tier criteria and guides the PR submission to validatedpatterns/docs
  6. ftl:rhdp-lab-validator (marketplace) generates grading automation for passing modules

Complementary: RHDP Skills Marketplace

The RHDP Skills Marketplace provides additional validation skills that complement this project:

Tool Purpose
/showroom:verify-content Content quality validation (AsciiDoc, Red Hat standards)
/health:deployment-validator Infrastructure health checks (pods, routes, operators)
/agnosticv:validator Catalog configuration validation
/ftl:rhdp-lab-validator Lab grading automation (Solve/Validate buttons)

Install a Skill 

./install.sh install --skill agnosticd          # one skill
./install.sh install --all                       # all skills
./install.sh install --skill patternizer --ide cursor  # specific IDE

How Skills Are Structured 

~/.claude/skills/agnosticd/     # or ~/.cursor/skills-cursor/agnosticd/
  SKILL.md                      # Instructions and "When to Use" triggers
  references/
    REFERENCE.md                # Index of fetched docs
    setup.adoc                  # Actual upstream documentation
    contributing.adoc
    ...

The AI assistant reads SKILL.md to understand when and how to help, then consults references/ for detailed documentation.

Table of contents