playbooks

home / skills / hyva-themes / hyva-ai-tools / hyva-theme-list

hyva-theme-list skill

/skills/hyva-theme-list

This skill lists all Hyvä theme paths in a Magento 2 project by detecting themes with web/tailwind/package.json and theme.xml.

npx playbooks add skill hyva-themes/hyva-ai-tools --skill hyva-theme-list

Review the files below or copy the command above to add this skill to your agents.

Files (2)
SKILL.md
1.8 KB
---
name: hyva-theme-list
description: List all Hyvä theme paths in a Magento 2 project. This skill should be used when the user wants to find Hyvä themes, list available themes, discover theme paths, or when other skills need to locate Hyvä themes. Trigger phrases include "list hyva themes", "find themes", "show themes", "available themes", "theme paths".
---

# Hyvä Theme Listing

Lists all Hyvä theme paths in a Magento 2 project. Themes are identified by the presence of `web/tailwind/package.json`.

## Usage

**Important:** Execute this script from the Magento project root directory.

Run the discovery script to list all Hyvä themes:

```bash
bash <skill_path>/scripts/list_hyva_themes.sh
```

Where `<skill_path>` is the directory containing this SKILL.md file (e.g., `.claude/skills/hyva-theme-list`).

**Output format:** One theme path per line (relative to project root), or empty output if no themes found.

```
app/design/frontend/Example/customTheme
vendor/hyva-themes/magento2-default-theme-csp
```

## Search Locations

The script searches two locations:

| Location | Description |
|----------|-------------|
| `app/design/frontend/` | Custom themes developed for the project |
| `vendor/` | Installed themes from any vendor (not limited to hyva-themes) |

## Theme Identification

A directory is identified as a Hyvä theme when it contains both:
1. `web/tailwind/package.json` (Hyvä/Tailwind structure)
2. `theme.xml` (valid Magento theme)

## Integration with Other Skills

Other skills that need to locate Hyvä themes should invoke this skill by name:

```markdown
Invoke the `hyva-theme-list` skill to discover available themes.
```

The output can be processed line-by-line or stored in a variable for selection prompts.

<!-- Copyright © Hyvä Themes https://hyva.io. All rights reserved. Licensed under OSL 3.0 -->

Overview

This skill lists all Hyvä theme paths in a Magento 2 project so you can quickly locate Hyvä/Tailwind-based themes. It identifies themes by checking for the Hyvä Tailwind structure alongside a valid Magento theme descriptor. Use it from the project root to get one relative theme path per line, or empty output when none are found.

How this skill works

The script scans common theme locations inside a Magento project (app/design/frontend and vendor) and inspects each candidate directory for two markers: a Tailwind package file under web/tailwind and a theme.xml descriptor. When both files exist, the directory is reported as a Hyvä theme. Output is plain lines with relative paths, suitable for piping into other tools or selection prompts.

When to use it

  • You need to find all Hyvä themes installed or developed in a project.
  • Preparing to run theme-specific build or Tailwind workflows that require theme paths.
  • Other automation skills need a list of Hyvä theme paths to operate on.
  • Auditing a project to verify Hyvä adoption or locate third-party Hyvä packages.
  • Quickly confirm whether any Hyvä themes are present after dependency changes.

Best practices

  • Run the script from the Magento project root so paths are relative and accurate.
  • Use the output in pipes or variables for automated workflows (CI, deploy scripts, other skills).
  • Verify vendor-installed themes are present by running composer install before discovery.
  • Treat results as authoritative only for Hyvä themes that use the web/tailwind layout convention.

Example use cases

  • List Hyvä themes before triggering a per-theme Tailwind build step in CI.
  • Populate a selection prompt so an extension can ask which Hyvä theme to operate on.
  • Scan a codebase to find custom project themes that use Hyvä/Tailwind structure.
  • Confirm a newly installed vendor Hyvä theme appears under vendor/ after installation.

FAQ

Where must I run this script?

Execute it from the Magento project root so returned paths are correct and relative to the project.

How does the script identify a Hyvä theme?

It looks for both a web/tailwind package file (Tailwind structure) and a theme.xml Magento descriptor in the same directory.