Showroom Namespace Setup

Content Creation Skills

Complete setup guide for Red Hat Showroom workshop and demo content creation.

Overview

ℹ️

The showroom namespace provides AI-powered skills for creating Red Hat Showroom workshop and demo content. These skills focus purely on content creation without infrastructure provisioning.

Target Audience: Content creators, technical writers, workshop developers

Installation

ℹ️

Install the showroom namespace:

Claude Code
/plugin marketplace add rhpds/rhdp-skills-marketplace
/plugin install showroom@rhdp-marketplace
Cursor
curl -fsSL https://raw.githubusercontent.com/rhpds/rhdp-skills-marketplace/main/install-cursor.sh | bash

Included Skills

📝

/showroom:create-lab

Generate workshop lab modules with Red Hat Showroom structure

  • Know/Do/Check pedagogical structure
  • Multi-module workshops
  • Proper AsciiDoc formatting
  • Dynamic content placeholders
View detailed documentation →
🎭

/showroom:create-demo

Generate presenter-led demo content

  • Know/Show demo structure
  • Presenter notes
  • Show-first approach
  • Time estimates per section
View detailed documentation →
✓

/showroom:verify-content

AI-powered quality validation for workshop and demo content

  • AsciiDoc syntax checking
  • Know/Do/Check structure validation
  • Exercise clarity checks
  • Red Hat style guide compliance
View detailed documentation →
📰

/showroom:blog-generate

Transform completed lab/demo content into blog posts

  • Blog-appropriate formatting
  • Key takeaways extraction
  • Call-to-action generation
  • Red Hat Developer blog style
View detailed documentation →

Prerequisites

Required

  • Claude Code or Cursor installed
  • Basic understanding of AsciiDoc (helpful but not required)

Optional

  • Red Hat Showroom template repository
  • GitHub account for publishing
  • Red Hat Developer account (for blog publishing)

Typical Workflow

  1. /showroom:create-lab or /showroom:create-demo

  2. Review and edit generated content

  3. /showroom:verify-content

  4. Fix any issues identified

  5. /showroom:blog-generate (optional)

  6. Publish to Showroom and/or blog

Example: Creating a Workshop Lab

  1. Run /showroom:create-lab

    In Claude Code or Cursor:
/showroom:create-lab

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

  2. Generated Structure

    content/modules/ROOT/
├── pages/
│   ├── index.adoc
│   ├── module-01.adoc
│   ├── module-02.adoc
│   └── module-03.adoc
├── partials/
│   └── _attributes.adoc
└── nav.adoc

  3. Verify Quality

    /showroom:verify-content

Reviews:
✓ AsciiDoc syntax
✓ Know/Do/Check structure
✓ Exercise clarity
⚠️ Suggestions for improvement

  4. Generate Blog (Optional)

    /showroom:blog-generate

Creates:
- Blog post from workshop content
- Introduction and conclusion
- Key takeaways
- Call-to-action

Content Structure

ℹ️

Module Format (Know/Do/Check)

Each module follows this structure:

= Module Title

== Know (2 minutes)

Brief explanation of the concept...

== Do (8 minutes)

Hands-on exercise:

.Procedure
. Step 1
. Step 2
. Step 3

.Verification
After completing...you should see...
ℹ️

Placeholder Attributes

Use these in your content:

Attribute Usage
{openshift_console_url} Console URL
{user} Username
{password} Password
{user_namespace} Namespace
{api_url} API URL

Defined in partials/_attributes.adoc

Tips & Best Practices

Content Creation

  1. Start with clear objectives - Know what learners should achieve
  2. Keep modules focused - One concept per module
  3. Use active voice - "Create a pipeline" not "A pipeline is created"
  4. Test exercises - Ensure steps work as documented
  5. Add verification - Help learners confirm success

Using Skills

  1. Be specific with prompts - More detail = better output
  2. Iterate on content - Run /showroom:create-lab multiple times if needed
  3. Verify early - Run /showroom:verify-content before extensive edits
  4. Leverage examples - Ask skills for similar examples

Troubleshooting

Skill Not Found

Problem: /showroom:create-lab not recognized

Solution:

  1. Restart your editor
  2. Verify installation: ls ~/.claude/skills/ or ls ~/.cursor/skills/
  3. Reinstall if needed
Generated Content Has Issues

Problem: Content doesn't meet quality standards

Solution:

  1. Run /showroom:verify-content to identify specific issues
  2. Edit content based on suggestions
  3. Re-verify after changes
Attributes Not Rendering

Problem: {openshift_console_url} shows as literal text

Solution:

Ensure _attributes.adoc is defined in partials/:

:openshift_console_url: https://console-openshift-console.apps.cluster.example.com
:user: user1
:password: openshift

Next Steps

View All Skills

Explore skill documentation

Quick Reference

Common commands & workflows

Troubleshooting

Common issues & solutions
← Back to Setup Next: AgnosticV Setup →