Theme Factory

Instructions

Step 1: Understand Context

Determine:

• What artifact is being styled (slides, document, HTML page, report, etc.)
• Target audience and purpose
• Any branding constraints or preferences
• Whether user wants a preset theme or a custom one

If $ARGUMENTS specifies a theme name, skip to Step 3. If $ARGUMENTS describes an aesthetic, skip to Step 4 (custom theme).

Step 2: Present Theme Options

1. Display theme-showcase.pdf so the user can visually browse all themes. Do not modify this file.
2. List the available themes:

3. Wait for explicit user selection before proceeding. Do not auto-select a theme.

Step 3: Apply Theme

1. Read the selected theme file from themes/{theme-name}.md
2. Apply colors and fonts consistently throughout the artifact:
   • Background colors
   • Text colors (headings, body, accents)
   • Font families for headers and body
3. Ensure proper contrast and readability
4. Maintain the theme's visual identity across all pages/slides

Step 4: Custom Theme (when no preset fits)

1. Discuss aesthetic direction with the user
2. Generate a new theme specification following the same structure as files in themes/
3. Give it a descriptive name reflecting the font/color combination
4. Present the specification for review before applying
5. Once approved, apply as in Step 3

Examples

Applying a preset theme to a slide deck

User: "Apply a professional theme to this presentation"

1. Show theme-showcase.pdf for visual browsing
2. User selects "Ocean Depths"
3. Read themes/ocean-depths.md for color palette and fonts
4. Apply navy backgrounds, teal accents, seafoam highlights, and DejaVu Sans throughout

Creating a custom theme

User: "I need a warm, organic theme for a coffee shop website"

1. Generate custom theme with earth tones, warm browns, cream backgrounds
2. Present specification for approval
3. Apply approved theme to the HTML artifact

Beautifying an existing document

User: "Make this report look more modern"

1. Suggest Tech Innovation or Modern Minimalist themes
2. User picks Modern Minimalist
3. Apply charcoal, slate gray, and clean white palette with DejaVu Sans

Troubleshooting

Theme showcase PDF not displaying

Cause: PDF viewer not available or file path issue Solution: Fall back to text descriptions of each theme with color swatches (hex codes) and font specifications. User can still select by name.

Theme doesn't match user's vision

Cause: Ambiguous aesthetic direction Solution: Present 2-3 theme variations. Ask user which direction resonates, then refine.

Theme breaks artifact structure

Cause: Overly aggressive styling replacing functional elements Solution: Apply theme to visual elements only (colors, fonts, spacing). Preserve original layout, component hierarchy, and functionality.

Notes

• Always wait for user theme selection — do not auto-select
• Theme files are specifications, not rigid templates — interpret creatively for each artifact type
• For HTML artifacts, consider using CSS variables for easy theme switching
• Preserve the artifact's original content and structure when applying themes
• Ensure color contrast meets accessibility standards (4.5:1 for body text, 3:1 for headings)