hyva-cms-custom-field — Claude Code skill: what it does
Generates custom inputs and modal handlers for Hyvä CMS components. Helps Magento developers extend editor controls without writing boilerplate by hand.
npx skills add hyva-themes/hyva-ai-tools --skill hyva-cms-custom-field -a claude-codeWhat hyva-cms-custom-field does
The skill outlines steps to implement bespoke field types for the Hyvä CMS editor. It covers basic inputs such as sliders or color pickers, as well as complex Alpine.js modal pickers that need separate dialogs.
During generation, the assistant sets up PHTML templates in view/adminhtml/templates/, wires events with Magewire, and configures etc/adminhtml/di.xml. For modal dialogs, it adds layout updates into liveview_editor.xml and produces component definitions for components.json.
This skill only works with Hyvä CMS and fails on standard Magento forms. Your module must declare dependencies on Hyva_CmsBase, Hyva_CmsLiveviewEditor, and hyva-themes/commerce-module-cms.
What it helps with
- build PHTML templates for specialized Hyvä CMS input controls
- wire Alpine.js modal dialogs for component asset selection
- register custom field definitions in
etc/adminhtml/di.xml - declare new input elements in
components.json
Example prompts for the agent
- Build a custom date range picker field for a Hyvä CMS promo block
- Create an Alpine.js modal product picker for Hyvä CMS components
- Register a custom color picker input in di.xml for the CMS editor
How to install hyva-cms-custom-field
1Skills CLI (Vercel)
npx skills add hyva-themes/hyva-ai-tools --skill hyva-cms-custom-field -a claude-code2Manually: put the files in place
~/.claude/skills/hyva-cms-custom-field/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/hyva-cms-custom-field/
1Skills CLI (Vercel)
npx skills add hyva-themes/hyva-ai-tools --skill hyva-cms-custom-field -a codex2Manually: put the files in place
.agents/skills/hyva-cms-custom-field/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hyva-themes/hyva-ai-tools --skill hyva-cms-custom-field -a cursor2Manually: put the files in place
.cursor/skills/hyva-cms-custom-field/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hyva-themes/hyva-ai-tools hyva-cms-custom-field2Manually: put the files in place
.github/skills/hyva-cms-custom-field/SKILL.md1Skills CLI (Vercel)
npx skills add hyva-themes/hyva-ai-tools --skill hyva-cms-custom-field -a gemini-cli2Platform CLI
gemini skills install https://github.com/hyva-themes/hyva-ai-tools --path skills/hyva-cms-custom-fieldManually: put the files in place
.devin/skills/hyva-cms-custom-field/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add hyva-themes/hyva-ai-tools --skill hyva-cms-custom-field -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-cms-custom-field
How to install hyva-cms-custom-field in Claude Code?
Run npx skills add hyva-themes/hyva-ai-tools --skill hyva-cms-custom-field -a claude-code in your terminal. This creates ~/.claude/skills/hyva-cms-custom-field/SKILL.md.
What does hyva-cms-custom-field do?
It guides coding agents through creating custom field templates, Alpine.js handlers, and XML registrations for the Hyvä CMS Liveview editor.
What dependencies are required for this skill?
It requires the hyva-themes/commerce-module-cms package alongside Hyva_CmsBase and Hyva_CmsLiveviewEditor modules, plus companion skills hyva-create-module and hyva-exec-shell-cmd.