# hyva-theme-list

Walks a Magento 2 project and prints the path of every Hyvä theme it finds. Useful when the agent has to know which theme it is editing.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1300 installs · ★ 85
- Author: hyva-themes
- License: OSL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hyva-themes/hyva-ai-tools/tree/HEAD/skills/hyva-theme-list/SKILL.md
- Updated: 2026-07-31
- HTML: https://affpapa.org/en/nevibecode/skills/hyva-theme-list

## What it does

The skill runs `scripts/list_hyva_themes.sh` and prints one path per line, relative to the project root. No themes means empty output. Run it from the Magento project root, or the paths come out wrong.

Two places get scanned: `app/design/frontend/` for themes built for the project, and `vendor/` for installed packages. A folder counts as a Hyvä theme only when it holds both `web/tailwind/package.json` and `theme.xml`. A plain Magento theme without the Tailwind layout stays out of the list.

Other skills call this one by name when they need to locate themes. The output works line by line, or you can keep it in a variable and build a selection prompt. Handy on projects with several themes, where the agent keeps guessing which one to touch.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add hyva-themes/hyva-ai-tools --skill hyva-theme-list -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/hyva-theme-list/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/hyva-theme-list/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add hyva-themes/hyva-ai-tools --skill hyva-theme-list -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/hyva-theme-list/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add hyva-themes/hyva-ai-tools --skill hyva-theme-list -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/hyva-theme-list/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hyva-themes/hyva-ai-tools hyva-theme-list
```

2. **Manually: put the files in place**
- File: `.github/skills/hyva-theme-list/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add hyva-themes/hyva-ai-tools --skill hyva-theme-list -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/hyva-themes/hyva-ai-tools --path skills/hyva-theme-list
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/hyva-theme-list/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add hyva-themes/hyva-ai-tools --skill hyva-theme-list -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hyva-themes/hyva-ai-tools/tree/HEAD/skills/hyva-theme-list/SKILL.md

## When to use it
- find every Hyvä theme in a Magento 2 project
- tell a Hyvä theme apart from a regular Magento theme
- get a theme path to hand to another skill
- build a theme list before editing templates

## Example prompts
- List the Hyvä themes in this project
- Find the paths of all available Hyvä themes
- Which Hyvä themes are installed under `vendor/`?

## Similar
- [frontend-design](https://affpapa.org/en/nevibecode/skills/frontend-design.md) — skill · 1025790 installs
- [design-taste-frontend](https://affpapa.org/en/nevibecode/skills/design-taste-frontend.md) — skill · 678700 installs
- [prototype](https://affpapa.org/en/nevibecode/skills/prototype.md) — skill · 986201 installs
- [hyperframes](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes.md) — skill · 1200000 installs
- [hyperframes-cli](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes-cli.md) — skill · 1300000 installs
- [webapp-testing](https://affpapa.org/en/nevibecode/skills/webapp-testing.md) — skill · 186758 installs

From the same set: [hyva-themes/hyva-ai-tools](https://affpapa.org/en/nevibecode/by/hyva-themes/hyva-ai-tools.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md