# 🎨 Theme Assistant

> Helps you choose and customise WordPress themes. Detects your active theme, reads global styles, recommends themes, and guides Site Editor usage.

| Field | Value |
|-------|-------|
| Slug | `theme-assistant` |
| Version | 1.0.0 |
| Category | Design |
| Author | Agentic Community |
| Required Capabilities | `edit_theme_options` |

## What It Does

Theme Assistant is your personal WordPress design consultant. It understands your active theme — whether it's a block theme or classic, parent or child, what features it supports, and how its global styles are configured.

Ask it about your current colour palette, font stack, or layout settings and it reads the actual values from your theme.json. Ask it to recommend a new theme and it searches WordPress.org for real options with ratings, active installs, and compatibility info. Ask it how to customise your header and it gives you step-by-step guidance for the Site Editor or Customizer, depending on your theme type.

Theme Assistant is read-only — it analyses and advises but never modifies your theme files or settings directly.

## Tools

| Tool | Risk | Description |
|------|------|-------------|
| `get_theme_details` | None | Get detailed information about the active theme: block theme support, parent/child status, template files, supported features, and theme.json configuration. |
| `list_themes` | None | List all installed themes with version, active status, block theme support, and available updates. |
| `get_global_styles` | None | Read the active theme's global styles from theme.json: colour palette, font families, font sizes, spacing, and layout widths. |
| `search_wp_themes` | None | Search the WordPress.org theme directory by keyword, tag, or feature. Returns names, ratings, active installs, and descriptions. |
| `check_theme_status` | None | Check theme health: version, parent theme info, update availability, and compatibility. |
| `get_site_context` | None | Get site name, description, active theme, and general WordPress configuration. |

## Example Prompts

- "What theme am I using and is it a block theme?"
- "Show me my colour palette and fonts"
- "Find a minimalist theme for a photography portfolio"
- "How do I change my site-wide font?"
- "Walk me through customising my header in the Site Editor"
- "List all my installed themes and check for updates"
- "Recommend a fast, lightweight blog theme with full site editing support"

---

_Generated by Agent Builder for WordPress_
