
Hyva Theme List
- 785 installs
- 78 repo stars
- Updated July 31, 2026
- hyva-themes/hyva-ai-tools
hyva-theme-list is a Magento 2 discovery skill that lists all Hyvä theme paths in a project by detecting web/tailwind/package.json markers for developers customizing Hyvä storefronts.
About
hyva-theme-list is a Hyvä Themes skill that quickly finds every Hyvä theme directory inside a Magento 2 codebase. Themes are identified by the presence of web/tailwind/package.json, which signals a Hyvä Tailwind frontend setup. Developers run bash scripts/list_hyva_themes.sh from the Magento project root to print available theme paths, making it the first step before Tailwind builds, theme overrides, or chaining other Hyvä AI tools that need a theme location. Trigger phrases include list hyva themes, find themes, show themes, available themes, and theme paths. The skill is intentionally narrow and script-driven, optimized for agents that must locate Hyvä assets without manually grepping vendor and app/design directories. Reach for hyva-theme-list whenever a Magento 2 Hyvä customization session starts and the correct theme path is unknown.
- Discovers Hyvä themes by locating web/tailwind/package.json and theme.xml files
- Searches both app/design/frontend/ for custom themes and vendor/ for installed themes
- Outputs one relative theme path per line or empty output when none found
- Designed as a dependency for other Hyvä-related agent skills that need theme locations
- Runs as a single bash script from the Magento project root
Hyva Theme List by the numbers
- 785 all-time installs (skills.sh)
- +30 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #1,340 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 2, 2026 (Skillselion catalog sync)
npx skills add https://github.com/hyva-themes/hyva-ai-tools --skill hyva-theme-listAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 785 |
|---|---|
| repo stars | ★ 78 |
| Last updated | July 31, 2026 |
| Repository | hyva-themes/hyva-ai-tools ↗ |
How do you find Hyvä theme paths in Magento 2?
Quickly discover and list all Hyvä theme paths inside any Magento 2 project.
Who is it for?
Magento 2 developers customizing Hyvä storefronts who need accurate theme paths before Tailwind or theme edits.
Skip if: Non-Magento projects, Luma-only themes without Hyvä Tailwind package.json markers, or backend catalog API work.
When should I use this skill?
User asks to list hyva themes, find themes, show themes, available themes, or discover theme paths in Magento 2.
What you get
Terminal list of Hyvä theme directory paths identified by web/tailwind/package.json markers.
- Hyvä theme path list
By the numbers
- Identifies themes by web/tailwind/package.json marker
- Includes list_hyva_themes.sh discovery script
Files
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 <skill_path>/scripts/list_hyva_themes.shWhere <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-cspSearch 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:
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 -->
#!/bin/bash
# Lists all Hyvä themes in a Magento 2 project
# Hyvä themes are identified by the presence of web/tailwind/package.json
#
# Searches:
# - app/design/frontend/ (custom themes)
# - vendor/ (installed themes from any vendor)
#
# Usage: list_hyva_themes.sh
# Output: One theme path per line (relative to project root)
set -euo pipefail
# Find themes in app/design/frontend/
# Structure: app/design/frontend/Vendor/ThemeName/web/tailwind/package.json
find app/design/frontend -path "*/web/tailwind/package.json" -type f 2>/dev/null | while read -r package_json; do
theme_path="${package_json%/web/tailwind/package.json}"
# Only include if it has theme.xml (valid Magento theme)
if [ -f "$theme_path/theme.xml" ]; then
echo "$theme_path"
fi
done
# Find themes in vendor/
# Structure: vendor/vendor-name/package-name/web/tailwind/package.json
find vendor -path "*/web/tailwind/package.json" -type f 2>/dev/null | while read -r package_json; do
theme_path="${package_json%/web/tailwind/package.json}"
# Only include if it looks like a theme (has theme.xml)
if [ -f "$theme_path/theme.xml" ]; then
echo "$theme_path"
fi
done
Related skills
How it compares
Use hyva-theme-list for automated Hyvä path discovery instead of manual vendor directory searches in large Magento 2 codebases.
FAQ
How does hyva-theme-list identify Hyvä themes?
hyva-theme-list detects Hyvä themes by the presence of web/tailwind/package.json in theme directories. The list_hyva_themes.sh script must run from the Magento 2 project root.
When should hyva-theme-list run in a Hyvä workflow?
hyva-theme-list runs first when developers need to find, list, or show available Hyvä theme paths before Tailwind builds or other Hyvä AI tools that require a theme directory.