hyva-ui-component — Claude Code skill: use and install
This skill applies template-based Hyvä UI components to a selected theme. It helps choose a component, review its variant and copy the required files.
npx skills add hyva-themes/hyva-ai-tools --skill hyva-ui-component -a claude-codeWhat hyva-ui-component does
The skill works with Hyvä UI’s non-CMS components, including headers, footers, galleries, menus and minicarts. It checks vendor/hyva-themes/hyva-ui/components/, lists available variants and reads the selected component’s README before making changes.
It then locates a theme under app/design/frontend/, copies files from the component’s src/ directory and records which files were created or updated. XML options go into etc/view.xml, while existing layout XML must be merged instead of replaced. Component and plugin dependencies are handled before the files are copied.
Hyva UI must be available at vendor/hyva-themes/hyva-ui or at a custom path. If it is missing, the workflow offers a Composer installation, a custom extraction path or a download from the Hyvä account area. Tailwind compilation is not automatic; the skill asks before invoking it.
What it helps with
- list available non-CMS Hyvä UI components
- choose a component variant for a Hyvä theme
- copy component files into the theme
- add XML options to
etc/view.xml - track created and updated files
Example prompts for the agent
- Add a Hyvä UI gallery to the existing theme and show its available variants.
- Install the
headercomponent into a new Hyvä child theme. - Check dependencies for
minicart, copy its files and report the changes.
How to install hyva-ui-component
1Skills CLI (Vercel)
npx skills add hyva-themes/hyva-ai-tools --skill hyva-ui-component -a claude-code2Manually: put the files in place
~/.claude/skills/hyva-ui-component/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/hyva-ui-component/
1Skills CLI (Vercel)
npx skills add hyva-themes/hyva-ai-tools --skill hyva-ui-component -a codex2Manually: put the files in place
.agents/skills/hyva-ui-component/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hyva-themes/hyva-ai-tools --skill hyva-ui-component -a cursor2Manually: put the files in place
.cursor/skills/hyva-ui-component/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hyva-themes/hyva-ai-tools hyva-ui-component2Manually: put the files in place
.github/skills/hyva-ui-component/SKILL.md1Skills CLI (Vercel)
npx skills add hyva-themes/hyva-ai-tools --skill hyva-ui-component -a gemini-cli2Platform CLI
gemini skills install https://github.com/hyva-themes/hyva-ai-tools --path skills/hyva-ui-componentManually: put the files in place
.devin/skills/hyva-ui-component/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add hyva-themes/hyva-ai-tools --skill hyva-ui-component -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about hyva-ui-component
How do I install hyva-ui-component in Claude Code?
Run npx skills add hyva-themes/hyva-ai-tools --skill hyva-ui-component -a claude-code, then check ~/.claude/skills/hyva-ui-component/SKILL.md.
What does hyva-ui-component do?
It selects a non-CMS Hyvä UI component and variant, reads the component instructions, copies its files into a Hyvä theme and reports the changes.
What does hyva-ui-component require?
Hyvä UI must be available at vendor/hyva-themes/hyva-ui or a custom path. The workflow also uses hyva-exec-shell-cmd, hyva-theme-list, hyva-child-theme and hyva-compile-tailwind-css for related tasks.