{
  "markdown": "# Hyva AI Skills\n\nAI-powered skills for Magento 2 development with Hyva Theme.\nThese skills extend AI coding assistants with specialized knowledge for creating Hyva themes,\nmodules, and CMS components.\n\n## Installation\n\n### Install Individual Skills (Recommended)\n\nClone this repository, then use `install-hyva-skill.sh` to install individual skills by name.\nDependencies are resolved automatically.\n\n```bash\ngit clone https://github.com/hyva-themes/hyva-ai-tools.git\n\n# Install a skill for a specific agent (from your project directory)\n./hyva-ai-tools/install-hyva-skill.sh hyva-child-theme claude\n\n# Or let the installer auto-detect the agent directory\n./hyva-ai-tools/install-hyva-skill.sh hyva-cms-component\n\n# List all available skills\n./hyva-ai-tools/install-hyva-skill.sh --list\n```\n\nSkills are symlinked into the target agent's skills directory.\nTo update all installed skills, simply run `git pull` inside the cloned repository. Every symlinked skill picks up the changes immediately.\n\nUse `--copy` to copy skills instead of symlinking (e.g. when the repo is on the host but the agent runs in a container):\n\n```bash\n./hyva-ai-tools/install-hyva-skill.sh --copy hyva-child-theme claude\n```\n\nCopied skills won't update automatically with `git pull`. Re-run the install command to update them.\n\nWhen no agent argument is given, the installer will:\n\n1. Use the `HYVA_SKILLS_AGENT` environment variable if set\n2. Auto-detect an existing agent directory (e.g. `.claude/skills/`) in the current working directory\n3. Prompt you to choose an agent and whether to install globally (`~/`) or locally (`./`)\n\nSupported agents: `claude`, `codex`, `copilot`, `cursor`, `gemini`, `junie`, `opencode`\n\n### Install All Skills at Once (Legacy)\n\nTo install all skills in one go (copies instead of symlinks):\n\n```bash\n# Replace \"claude\" with your agent: codex, copilot, cursor, gemini, junie, opencode\ncurl -fsSL https://raw.githubusercontent.com/hyva-themes/hyva-ai-tools/refs/heads/main/install.sh | sh -s claude\n```\n\n## Usage\n\nOnce installed, the AI agent will automatically use these skills when relevant. You can also invoke them directly:\n\n- \"Create an Alpine component for a dropdown menu\"\n- \"Create a Hyva child theme\"\n- \"Add a CMS component for a hero banner\"\n- \"Compile Tailwind CSS\"\n- \"Apply the gallery component from Hyva UI\"\n- `/hyva-child-theme` (explicit slash command invocation)\n\n## Available Skills\n\n### Theme & Module Development\n\n| Skill                                                                 | Description                                                                                  |\n| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |\n| [hyva-tailwind-include-exclude](skills/hyva-tailwind-include-exclude/) | Add a module path to the `include` or `exclude` list in `hyva.config.json` for Tailwind CSS |\n| [hyva-child-theme](skills/hyva-child-theme/)                           | Create a Hyva child theme with directory structure, Tailwind CSS, and theme inheritance     |\n| [hyva-create-module](skills/hyva-create-module/)                       | Scaffold new Magento 2 modules in `app/code/`                                               |\n| [hyva-alpine-component](skills/hyva-alpine-component/)                 | Write CSP-compatible Alpine.js components for Hyvä themes following best practices           |\n| [hyva-ui-component](skills/hyva-ui-component/)                         | Install Hyva UI template-based components (headers, footers, galleries, etc.) to themes     |\n| [hyva-render-media-image](skills/hyva-render-media-image/)             | Generate responsive `<picture>` elements using the Hyva Media view model                    |\n| [hyva-playwright-test](skills/hyva-playwright-test/)                   | Write Playwright tests for Hyvä themes with Alpine.js                                        |\n\n### CMS Components\n\n| Skill                                                  | Description                                                                                |\n| ------------------------------------------------------ | ------------------------------------------------------------------------------------------ |\n| [hyva-cms-component](skills/hyva-cms-component/)       | Create custom Hyva CMS components with field presets, variant support, and PHTML templates |\n| [hyva-cms-custom-field](skills/hyva-cms-custom-field/) | Create custom field types and field handlers for Hyvä CMS components                       |\n\n### Utility Skills\n\n> Utility skills are mainly intended to be invoked by other skills, but can also be used directly.\n\n| Skill                                                          | Description                                                                           |\n| -------------------------------------------------------------- | ------------------------------------------------------------------------------------- |\n| [hyva-compile-tailwind-css](skills/hyva-compile-tailwind-css/) | Compile Tailwind CSS for Hyva themes                                                  |\n| [hyva-exec-shell-cmd](skills/hyva-exec-shell-cmd/)             | Detect development env (docker, local) and execute commands with appropriate wrappers |\n| [hyva-theme-list](skills/hyva-theme-list/)                     | List all Hyva theme paths in a Magento 2 project                                      |\n| [hyva-cms-components-dump](skills/hyva-cms-components-dump/)   | Dump combined JSON of all available Hyvä CMS components from active modules           |\n\n## License\n\nLicensed under the OSL-3.0.\n\n---\n\nCopyright (c) Hyva Themes https://hyva.io. All rights reserved.\n",
  "bytes": 5754,
  "sha": "aedac71b873d2dc4ece6b1f760c6c5e14fc358ace2c4d3d6125396953cfc1621",
  "repo_slug": "hyva-themes/hyva-ai-tools",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_hyva_themes_hyva_ai_tools_hyva_playwrigh_71daaacf/readme"
}