hyva-cms-component — Claude Code skill: Hyvä CMS components

What hyva-cms-component does

The skill covers the whole path from picking a module to writing files. You name the component, give it a label and category, choose fields, and it produces components.json plus a PHTML template. Both new and existing modules are supported. For an existing one it checks that etc/module.xml lists Hyva_CmsBase and that composer.json requires hyva-themes/commerce-module-cms, adding either if missing.

Field types come from the project itself when possible: the skill runs bin/magento hyva:cms:list-fields through the hyva-exec-shell-cmd wrapper and only falls back to references/field-types.md when that command is not there. Icons are picked from the lucide set, skipping any already taken by another component — the skill dumps current components first to know which ones those are. Presets cover Basic Card, Image Card, CTA Block, Text Block, Feature Item, Testimonial and Accordion Item.

Watch the children property. It belongs at the component level, not inside content as a field type; put it in the wrong place and the schema rejects the file. Child-only components use require_parent: true instead. Four companion skills do the heavy lifting — hyva-exec-shell-cmd, hyva-create-module, hyva-cms-components-dump and hyva-render-media-image — so the environment and icon steps depend on them being installed.