{
  "markdown": "# Enonic XP Agent Skills\n\n<p align=\"center\">\n  <img src=\"assets/repo-banner.svg\" alt=\"Enonic XP Agent Skills\" width=\"100%\" />\n</p>\n\nA maintained collection of agent skills for [Enonic XP 7](https://developer.enonic.com/docs) 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> **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 Library Reference Skill](#enonic-library-reference-skill)\n  - [Enonic Content Management Skill](#enonic-content-management-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 App Manager Skill](#enonic-app-manager-skill)\n  - [Enonic Event Manager Skill](#enonic-event-manager-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> /plugin marketplace add webmaxru/ai-native-dev\n> /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> /plugin marketplace add webmaxru/ai-native-dev\n> /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 Library Reference Skill\n\n`skills/enonic-library-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, lib-schema, lib-project, lib-export, lib-scheduler, lib-value, lib-i18n, lib-websocket, lib-admin, lib-app, lib-auditlog, lib-cluster, lib-common, lib-grid, and lib-vhost.\n\nInstall with APM:\n\n```bash\napm install webmaxru/enonic-agent-skills/skills/enonic-library-reference\n```\n\nInstall with npm:\n\n```bash\nnpx skills add webmaxru/enonic-agent-skills --skill enonic-library-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/lib-cms-reference.md` for lib-project, lib-export, lib-scheduler, and lib-value functions\n- `references/lib-web-reference.md` for lib-i18n and lib-websocket functions\n- `references/lib-platform-reference.md` for lib-admin, lib-app, lib-auditlog, lib-cluster, lib-common, lib-grid, and lib-vhost 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 Management Skill\n\n`skills/enonic-content-management` 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-management\n```\n\nInstall with npm:\n\n```bash\nnpx skills add webmaxru/enonic-agent-skills --skill enonic-content-management\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 App Manager Skill\n\n`skills/enonic-app-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-app-manager\n```\n\nInstall with npm:\n\n```bash\nnpx skills add webmaxru/enonic-agent-skills --skill enonic-app-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 Event Manager Skill\n\n`skills/enonic-event-manager` 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-event-manager\n```\n\nInstall with npm:\n\n```bash\nnpx skills add webmaxru/enonic-agent-skills --skill enonic-event-manager\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-management/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",
  "bytes": 16991,
  "sha": "91d297bb38ca0686431a1856e83ecb323e94e70b447d7eea2aaffeac3befd0d9",
  "repo_slug": "webmaxru/enonic-agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_webmaxru_enonic_agent_skills_enonic_cont_fcd82845/readme"
}