{"id":47711129,"url":"https://github.com/webmaxru/enonic-agent-skills","last_synced_at":"2026-04-02T18:32:15.404Z","repository":{"id":347527961,"uuid":"1194365132","full_name":"webmaxru/enonic-agent-skills","owner":"webmaxru","description":"Agent skills for Enonic XP CMS development — API reference, content migration, content types, Guillotine queries, Next.XP integration, sandbox management, webhooks, and controller generation.","archived":false,"fork":false,"pushed_at":"2026-03-28T11:14:51.000Z","size":558,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-28T13:40:07.554Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/webmaxru.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-28T08:54:43.000Z","updated_at":"2026-03-28T10:32:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/webmaxru/enonic-agent-skills","commit_stats":null,"previous_names":["webmaxru/enonic-agent-skills"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/webmaxru/enonic-agent-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webmaxru%2Fenonic-agent-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webmaxru%2Fenonic-agent-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webmaxru%2Fenonic-agent-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webmaxru%2Fenonic-agent-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/webmaxru","download_url":"https://codeload.github.com/webmaxru/enonic-agent-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webmaxru%2Fenonic-agent-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31312917,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-02T18:32:14.724Z","updated_at":"2026-04-02T18:32:15.384Z","avatar_url":"https://github.com/webmaxru.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Enonic XP Agent Skills\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/repo-banner.svg\" alt=\"Enonic XP Agent Skills\" width=\"100%\" /\u003e\n\u003c/p\u003e\n\nA maintained collection of agent skills for [Enonic XP](https://developer.enonic.com/docs) CMS development. These skills cover the core Enonic XP development surface: server-side APIs, content modeling, content migration, Guillotine GraphQL queries, Next.js headless integration, controller generation, webhook/event integrations, and local development environment management.\n\nThe repository follows the [agentskills.io](https://agentskills.io) style: lean `SKILL.md` files, progressive disclosure through `references/` and `assets/`, and deterministic helper scripts where guessing would be brittle.\n\n\u003e **Disclaimer:** This project is not affiliated with, endorsed by, or officially connected to [Enonic](https://enonic.com/) in any way. It is an independent community effort.\n\n## Contents\n\n- [Install](#install)\n  - [Install via Plugin Marketplace (recommended)](#install-via-plugin-marketplace-recommended)\n  - [Install Individual Skills](#install-individual-skills)\n- [Skills in This Repository](#skills-in-this-repository)\n  - [Enonic API Reference Skill](#enonic-api-reference-skill)\n  - [Enonic Content Migration Skill](#enonic-content-migration-skill)\n  - [Enonic Content Type Generator Skill](#enonic-content-type-generator-skill)\n  - [Enonic Guillotine Query Builder Skill](#enonic-guillotine-query-builder-skill)\n  - [Enonic Next.XP Integration Skill](#enonic-nextxp-integration-skill)\n  - [Enonic Sandbox Manager Skill](#enonic-sandbox-manager-skill)\n  - [Enonic Webhook Integrator Skill](#enonic-webhook-integrator-skill)\n  - [Enonic Controller Generator Skill](#enonic-controller-generator-skill)\n- [Repository Conventions](#repository-conventions)\n- [Common Workflows](#common-workflows)\n\n## Install\n\n### Install via Plugin Marketplace (recommended)\n\nThe easiest way to get all Enonic XP skills is through the [webmaxru/ai-native-dev](https://github.com/webmaxru/ai-native-dev) plugin marketplace. Add the marketplace, then install the **enonic-skills** plugin from it.\n\n#### GitHub Copilot CLI\n\n```\n\u003e /plugin marketplace add webmaxru/ai-native-dev\n\u003e /plugin install enonic-skills@webmaxru/ai-native-dev\n```\n\n#### VS Code (GitHub Copilot)\n\nRun **Chat: Install Plugin From Source** from the Command Palette and enter:\n\n```\nhttps://github.com/webmaxru/ai-native-dev\n```\n\nOr add to your `settings.json`:\n\n```json\n\"chat.plugins.marketplaces\": [\n  \"webmaxru/ai-native-dev\"\n]\n```\n\nThen open the Extensions sidebar, search `@agentPlugins enonic-skills`, and click **Install**.\n\n#### Claude Code\n\n```\n\u003e /plugin marketplace add webmaxru/ai-native-dev\n\u003e /plugin install enonic-skills@webmaxru/ai-native-dev\n```\n\nAfter installation, your coding agent has access to all Enonic XP skills — no per-skill setup required.\n\n### Install Individual Skills\n\nIf you prefer to install specific skills rather than the full marketplace, use [Agent Package Manager (APM)](https://github.com/microsoft/apm) or the `skills` npm package.\n\n#### APM\n\n```bash\napm init          # if the target repo does not already use APM\napm install webmaxru/enonic-agent-skills/skills/SKILL_NAME\n```\n\n#### npm\n\n```bash\nnpx skills add webmaxru/enonic-agent-skills --skill SKILL_NAME\n```\n\nThe concrete install commands for each available skill are listed in the relevant skill sections below.\n\n## Skills in This Repository\n\n### Enonic API Reference Skill\n\n`skills/enonic-api-reference` provides a server-side JavaScript/TypeScript API reference for all `/lib/xp/*` libraries. It covers function signatures, parameters, return types, and usage examples for lib-content, lib-node, lib-auth, lib-portal, lib-context, lib-event, lib-task, lib-repo, lib-io, lib-mail, and lib-schema.\n\nInstall with APM:\n\n```bash\napm install webmaxru/enonic-agent-skills/skills/enonic-api-reference\n```\n\nInstall with npm:\n\n```bash\nnpx skills add webmaxru/enonic-agent-skills --skill enonic-api-reference\n```\n\nIt covers:\n\n- looking up Enonic XP library functions, parameter shapes, and return types\n- mapping queries to the correct reference file for each `/lib/xp/*` library\n- composing cross-library usage patterns (e.g., creating content as admin)\n- generating reusable import blocks from the provided template\n- troubleshooting common API errors and version mismatches\n\nIts support files are split by purpose:\n\n- `references/lib-content-reference.md` for lib-content function signatures and usage\n- `references/lib-node-reference.md` for lib-node function signatures and usage\n- `references/lib-auth-reference.md` for lib-auth function signatures and usage\n- `references/lib-portal-reference.md` for lib-portal function signatures and usage\n- `references/lib-context-reference.md` for lib-context, lib-event, and lib-task functions\n- `references/lib-utilities-reference.md` for lib-io, lib-mail, lib-repo, and lib-schema functions\n- `references/examples.md` for cross-library usage patterns\n- `references/troubleshooting.md` for common errors and version-compatibility notes\n- `assets/enonic-imports.template.ts` for a reusable import block template\n\n### Enonic Content Migration Skill\n\n`skills/enonic-content-migration` generates Enonic XP scripts for bulk content operations — creating, updating, querying, migrating, and transforming content using lib-content and lib-node APIs.\n\nInstall with APM:\n\n```bash\napm install webmaxru/enonic-agent-skills/skills/enonic-content-migration\n```\n\nInstall with npm:\n\n```bash\nnpx skills add webmaxru/enonic-agent-skills --skill enonic-content-migration\n```\n\nIt covers:\n\n- bulk content creation, update, and deletion scripts\n- querying with NoQL syntax, aggregations, and paginated retrieval\n- migrating content between environments using branch operations\n- wrapping long-running operations in task controllers with progress reporting\n- batch processing with configurable batch sizes and error tracking\n\nIts support files are split by purpose:\n\n- `references/migration-reference.md` for query DSL patterns, batch processing strategies, and branch handling rules\n- `references/examples.md` for complete query and aggregation patterns\n- `references/compatibility.md` for version-specific API differences\n- `references/troubleshooting.md` for duplicate handling, timeout, and permission issues\n- `assets/bulk-update.template.ts` for a reusable batch update controller template\n- `assets/task-migration.template.ts` for a reusable task controller template with progress reporting\n- `scripts/find-enonic-targets.mjs` for deterministic scanning of Enonic XP project markers\n\n### Enonic Content Type Generator Skill\n\n`skills/enonic-content-type-generator` generates Enonic XP content type XML schema definitions from natural-language descriptions. It covers structured content modeling including input types, form layout, option sets, item sets, mixins, x-data, and content-type inheritance.\n\nInstall with APM:\n\n```bash\napm install webmaxru/enonic-agent-skills/skills/enonic-content-type-generator\n```\n\nInstall with npm:\n\n```bash\nnpx skills add webmaxru/enonic-agent-skills --skill enonic-content-type-generator\n```\n\nIt covers:\n\n- creating content type XML schemas from natural-language field descriptions\n- mapping field descriptions to correct Enonic XP input types and configurations\n- generating mixins, x-data, item sets, and option sets\n- validating output XML for well-formedness and correct input type usage\n- scaffolding the correct directory structure under `site/content-types/`\n\nIts support files are split by purpose:\n\n- `references/content-type-reference.md` for input types, super-types, and schema structure\n- `references/examples.md` for complete content type definition patterns\n- `references/troubleshooting.md` for XML validation errors and input type mismatches\n- `assets/content-type.template.xml` for a starter content type template\n- `scripts/find-enonic-targets.mjs` for deterministic scanning of Enonic XP project markers\n\n### Enonic Guillotine Query Builder Skill\n\n`skills/enonic-guillotine-query-builder` composes, debugs, and optimizes Guillotine GraphQL queries for Enonic XP headless content delivery.\n\nInstall with APM:\n\n```bash\napm install webmaxru/enonic-agent-skills/skills/enonic-guillotine-query-builder\n```\n\nInstall with npm:\n\n```bash\nnpx skills add webmaxru/enonic-agent-skills --skill enonic-guillotine-query-builder\n```\n\nIt covers:\n\n- constructing GraphQL queries using Query DSL input types\n- building content type fragments with inline fragment type-name deriving\n- filtering, sorting, pagination, aggregations, and highlighting\n- migrating from deprecated 5.x string-based queries to 6.x+ DSL syntax\n- generating TypeScript types from Guillotine query responses\n\nIts support files are split by purpose:\n\n- `references/guillotine-reference.md` for the Guillotine API surface and query patterns\n- `references/examples.md` for complete query construction patterns\n- `references/compatibility.md` for version migration and breaking changes\n- `references/troubleshooting.md` for null results, type errors, and deprecated API usage\n- `assets/guillotine-query.template.ts` for a reusable typed query template\n- `scripts/find-guillotine-targets.mjs` for deterministic scanning of Guillotine markers in the workspace\n\n### Enonic Next.XP Integration Skill\n\n`skills/enonic-nextxp-integration` guides setup, development, and troubleshooting of the Next.js and Enonic XP headless integration (Next.XP framework).\n\nInstall with APM:\n\n```bash\napm install webmaxru/enonic-agent-skills/skills/enonic-nextxp-integration\n```\n\nInstall with npm:\n\n```bash\nnpx skills add webmaxru/enonic-agent-skills --skill enonic-nextxp-integration\n```\n\nIt covers:\n\n- configuring the `@enonic/nextjs-adapter` package and environment variables\n- mapping Enonic content types to React components via `ComponentRegistry`\n- wiring Guillotine GraphQL data fetching in Next.js with typed queries\n- enabling Content Studio preview mode with draft/master branch switching\n- deploying Enonic + Next.js to production (Enonic Cloud + Vercel)\n\nIts support files are split by purpose:\n\n- `references/nextxp-reference.md` for adapter configuration, component registry API, and deployment checklist\n- `references/examples.md` for complete content type mapping examples including queries, views, and processors\n- `references/compatibility.md` for version requirements between the adapter, Next.js, and Enonic XP\n- `references/troubleshooting.md` for preview failures, blank pages, and configuration issues\n- `assets/nextxp-page.template.tsx` for a reusable page component template\n\n### Enonic Sandbox Manager Skill\n\n`skills/enonic-sandbox-manager` guides developers through Enonic CLI commands for sandbox management, project scaffolding, local development, app deployment, and CI/CD pipeline generation.\n\nInstall with APM:\n\n```bash\napm install webmaxru/enonic-agent-skills/skills/enonic-sandbox-manager\n```\n\nInstall with npm:\n\n```bash\nnpx skills add webmaxru/enonic-agent-skills --skill enonic-sandbox-manager\n```\n\nIt covers:\n\n- creating, starting, stopping, upgrading, and deleting Enonic XP sandboxes\n- scaffolding new projects from starters (`starter-vanilla`, `starter-headless`, `starter-nextjs`)\n- running dev mode with hot-reload, building, deploying, and testing Enonic apps\n- managing applications on running XP instances\n- generating GitHub Actions CI/CD workflows for Enonic projects\n\nIts support files are split by purpose:\n\n- `references/cli-reference.md` for the full Enonic CLI command catalog\n- `references/examples.md` for common CLI workflow patterns\n- `references/compatibility.md` for CLI-to-XP version compatibility\n- `references/troubleshooting.md` for sandbox startup failures, port conflicts, and deployment issues\n- `assets/enonic-ci.template.yml` for a GitHub Actions CI/CD workflow template\n- `assets/sandbox-setup.template.sh` for a sandbox setup script template\n- `scripts/find-enonic-targets.mjs` for deterministic scanning of Enonic XP project markers\n\n### Enonic Webhook Integrator Skill\n\n`skills/enonic-webhook-integrator` sets up Enonic XP event listeners, webhook configurations, and external system integrations triggered by content lifecycle events.\n\nInstall with APM:\n\n```bash\napm install webmaxru/enonic-agent-skills/skills/enonic-webhook-integrator\n```\n\nInstall with npm:\n\n```bash\nnpx skills add webmaxru/enonic-agent-skills --skill enonic-webhook-integrator\n```\n\nIt covers:\n\n- registering event listeners for content publish, create, update, and delete events\n- configuring outbound webhooks via `com.enonic.xp.webhooks.cfg`\n- building HTTP service controllers for inbound webhook endpoints\n- wiring async processing with lib-task for heavy or long-running event handlers\n- calling external systems with lib-httpClient from event callbacks\n\nIts support files are split by purpose:\n\n- `references/event-reference.md` for event types, listener patterns, and task event lifecycle\n- `references/webhook-reference.md` for outbound webhook configuration and inbound service endpoints\n- `references/examples.md` for CDN invalidation, search reindexing, and notification patterns\n- `references/troubleshooting.md` for event non-firing, webhook delivery failures, and 404 service errors\n- `assets/event-listener.template.ts` for a reusable event listener scaffold\n- `assets/http-service.template.ts` for a reusable inbound webhook service scaffold\n- `scripts/find-enonic-targets.mjs` for deterministic scanning of Enonic XP project markers\n\n### Enonic Controller Generator Skill\n\n`skills/enonic-controller-generator` generates Enonic XP controller files (TypeScript/JavaScript) and paired XML descriptors for pages, parts, and layouts.\n\nInstall with APM:\n\n```bash\napm install webmaxru/enonic-agent-skills/skills/enonic-controller-generator\n```\n\nInstall with npm:\n\n```bash\nnpx skills add webmaxru/enonic-agent-skills --skill enonic-controller-generator\n```\n\nIt covers:\n\n- scaffolding page controllers with regions, part controllers with config access, and layout controllers with multi-region support\n- generating paired XML descriptors with display names, forms, and region definitions\n- generating Thymeleaf or Mustache view templates with proper region wiring\n- creating response processors for site-level HTTP response modification\n- updating `build.gradle` with required library dependencies\n\nIts support files are split by purpose:\n\n- `references/controller-reference.md` for XML descriptor schema and Portal API surface\n- `references/examples.md` for known-good controller patterns\n- `references/compatibility.md` for TypeScript vs JavaScript differences\n- `references/troubleshooting.md` for descriptor mismatches and rendering issues\n- `assets/page-controller.template.ts` for a reusable page controller template\n- `assets/part-controller.template.ts` for a reusable part controller template\n- `assets/layout-controller.template.ts` for a reusable layout controller template\n- `scripts/find-enonic-targets.mjs` for deterministic scanning of Enonic XP project markers\n\n## Repository Conventions\n\nWhen adding or revising a skill here, keep these rules intact:\n\n1. The skill directory name must match the YAML `name` exactly.\n2. Skill descriptions should be precise enough to route correctly and include both positive and negative triggers.\n3. `SKILL.md` should stay lean, procedural, and agent-oriented.\n4. Large examples, verbose rules, and schemas belong in `references/` or `assets/`.\n5. File paths inside skills should stay relative and use forward slashes.\n6. Skill folders should remain flat under `scripts/`, `references/`, and `assets/`.\n7. Human-oriented files such as per-skill `README.md` or `CHANGELOG.md` should not be added inside skill directories.\n\n## Common Workflows\n\n### Scan a Workspace for Enonic XP Targets\n\n```bash\nnode skills/enonic-content-migration/scripts/find-enonic-targets.mjs .\n```\n\nThe scanner locates Enonic XP project markers: `build.gradle` with `com.enonic.xp` dependencies, `src/main/resources/` directory structure, and `gradle.properties` with `xpVersion`.\n\n### Scan a Workspace for Guillotine Targets\n\n```bash\nnode skills/enonic-guillotine-query-builder/scripts/find-guillotine-targets.mjs .\n```\n\nThe scanner inventories files containing Guillotine markers such as query strings, library imports, `queryDsl`, `queryDslConnection`, and `/lib/guillotine` references.\n\n## References\n\n- Enonic XP documentation: https://developer.enonic.com/docs\n- agentskills.io best practices: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebmaxru%2Fenonic-agent-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebmaxru%2Fenonic-agent-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebmaxru%2Fenonic-agent-skills/lists"}