/showroom:blog-generate
✍️ Blog Post Generation
Transform Red Hat Showroom workshop content into Red Hat Developer blog post format.
Prerequisites
Complete Workshop Content
``` # Your Showroom repository with finished workshop: content/modules/ROOT/pages/ ├── index.adoc ├── module-01.adoc ├── module-02.adoc └── module-03.adoc ```Verified Content Quality
- Run
/showroom:verify-contentfirst - All modules complete
- Standards compliance checked
Blog Metadata Ready
- Target publication date
- Blog categories/tags
- Author bio
- Featured image (optional)
What You’ll Need
Completed Workshop
Finished and verified content
Blog Title
May differ from workshop title
Target Audience
For blog readers
Call-to-Action
Try the workshop, sign up, etc.
Quick Start
Navigate to Repository
Open your workshop repository directory
Run Generation
/showroom:blog-generateAnswer Questions
Provide blog-specific metadata
Review & Submit
Edit blog and submit to Red Hat Developer
What It Creates
blog/
├── blog-post.md # Blog post in Markdown
├── assets/
│ └── featured-image.png # Hero image for post
└── metadata.yml # Publication metadata
Common Workflow
-
Create and Verify Workshop
``` /showroom:create-lab → Generate workshop content /showroom:verify-content → Ensure quality ``` -
Generate Blog Post
``` /showroom:blog-generate → Transform to blog format → Add narrative flow → Include call-to-action ``` -
Review and Edit
Polish the content for blog readers:
- Read for blog audience (less technical)
- Add personal insights or experiences
- Include links to workshop and resources
- Add screenshots or diagrams
-
Submit for Publication
- Follow Red Hat Developer blog submission process
- Include metadata.yml
- Provide featured image
- Coordinate publication date
Blog vs Workshop Differences
Workshop
Hands-on Learning
- Step-by-step instructions
- Technical commands
- Know/Do/Check structure
- Complete procedures
- For hands-on learning
Blog Post
Reading and Inspiration
- Narrative explanation
- Conceptual overview
- Story-driven flow
- Highlights and insights
- For reading and inspiration
Tips & Best Practices
Overview Style
Blog posts are overview, not full tutorial
Focus on Why
Emphasize what you learned
Link to Workshop
Include link to full workshop for details
Personal Touch
Add your perspective and insights
Word Count
Aim for 800–1200 words
Conversational Tone
Use friendly, accessible language
Clear CTA
Add a strong call-to-action at the end
Visual Appeal
Include diagrams and screenshots
Troubleshooting
Skill not found?
- Restart Claude Code or VS Code - Verify installation: `ls ~/.claude/skills/blog-generate` (Claude Code) or `ls ~/.cursor/skills/showroom-blog-generate` (Cursor) - Check the [Troubleshooting Guide](../reference/troubleshooting.html)Generated blog is too technical?
Make It More Accessible:
- Edit to focus on concepts over commands
- Add more narrative and context
- Simplify technical jargon
- Use analogies and examples
- Explain the "why" before the "how"
Blog doesn't flow well?
- Restructure sections for storytelling - Add transitions between sections - Focus on reader journey, not lab steps - Start with a compelling hook - End with clear next stepsRed Hat Developer Blog Resources
Helpful Links: