Enonic XP Agent Skills

<p align="center">
  <img src="assets/repo-banner.svg" alt="Enonic XP Agent Skills" width="100%" />
</p>

A maintained collection of agent skills for Enonic XP 7 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.

The repository follows the agentskills.io style: lean SKILL.md files, progressive disclosure through references/ and assets/, and deterministic helper scripts where guessing would be brittle.

Disclaimer: This project is not affiliated with, endorsed by, or officially connected to Enonic in any way. It is an independent community effort.

Contents

• Install
  • Install via Plugin Marketplace (recommended)
  • Install Individual Skills
• Skills in This Repository
  • Enonic Library Reference Skill
  • Enonic Content Management Skill
  • Enonic Content Type Generator Skill
  • Enonic Guillotine Query Builder Skill
  • Enonic Next.XP Integration Skill
  • Enonic App Manager Skill
  • Enonic Event Manager Skill
  • Enonic Controller Generator Skill
• Repository Conventions
• Common Workflows

Install

Install via Plugin Marketplace (recommended)

The easiest way to get all Enonic XP skills is through the webmaxru/ai-native-dev plugin marketplace. Add the marketplace, then install the enonic-skills plugin from it.

GitHub Copilot CLI

> /plugin marketplace add webmaxru/ai-native-dev
> /plugin install enonic-skills@webmaxru-ai-native-dev

VS Code (GitHub Copilot)

Run Chat: Install Plugin From Source from the Command Palette and enter:

https://github.com/webmaxru/ai-native-dev

Or add to your settings.json:

"chat.plugins.marketplaces": [
  "webmaxru/ai-native-dev"
]

Then open the Extensions sidebar, search @agentPlugins enonic-skills, and click Install.

Claude Code

> /plugin marketplace add webmaxru/ai-native-dev
> /plugin install enonic-skills@webmaxru-ai-native-dev

After installation, your coding agent has access to all Enonic XP skills — no per-skill setup required.

Install Individual Skills

If you prefer to install specific skills rather than the full marketplace, use Agent Package Manager (APM) or the skills npm package.

APM

apm init          # if the target repo does not already use APM
apm install webmaxru/enonic-agent-skills/skills/SKILL_NAME

npm

npx skills add webmaxru/enonic-agent-skills --skill SKILL_NAME

The concrete install commands for each available skill are listed in the relevant skill sections below.

Skills in This Repository

Enonic Library Reference Skill

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.

Install with APM:

apm install webmaxru/enonic-agent-skills/skills/enonic-library-reference

Install with npm:

npx skills add webmaxru/enonic-agent-skills --skill enonic-library-reference

It covers:

• looking up Enonic XP library functions, parameter shapes, and return types
• mapping queries to the correct reference file for each /lib/xp/* library
• composing cross-library usage patterns (e.g., creating content as admin)
• generating reusable import blocks from the provided template
• troubleshooting common API errors and version mismatches

Its support files are split by purpose:

• references/lib-content-reference.md for lib-content function signatures and usage
• references/lib-node-reference.md for lib-node function signatures and usage
• references/lib-auth-reference.md for lib-auth function signatures and usage
• references/lib-portal-reference.md for lib-portal function signatures and usage
• references/lib-context-reference.md for lib-context, lib-event, and lib-task functions
• references/lib-utilities-reference.md for lib-io, lib-mail, lib-repo, and lib-schema functions
• references/lib-cms-reference.md for lib-project, lib-export, lib-scheduler, and lib-value functions
• references/lib-web-reference.md for lib-i18n and lib-websocket functions
• references/lib-platform-reference.md for lib-admin, lib-app, lib-auditlog, lib-cluster, lib-common, lib-grid, and lib-vhost functions
• references/examples.md for cross-library usage patterns
• references/troubleshooting.md for common errors and version-compatibility notes
• assets/enonic-imports.template.ts for a reusable import block template

Enonic Content Management Skill

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.

Install with APM:

apm install webmaxru/enonic-agent-skills/skills/enonic-content-management

Install with npm:

npx skills add webmaxru/enonic-agent-skills --skill enonic-content-management

It covers:

• bulk content creation, update, and deletion scripts
• querying with NoQL syntax, aggregations, and paginated retrieval
• migrating content between environments using branch operations
• wrapping long-running operations in task controllers with progress reporting
• batch processing with configurable batch sizes and error tracking

Its support files are split by purpose:

• references/migration-reference.md for query DSL patterns, batch processing strategies, and branch handling rules
• references/examples.md for complete query and aggregation patterns
• references/compatibility.md for version-specific API differences
• references/troubleshooting.md for duplicate handling, timeout, and permission issues
• assets/bulk-update.template.ts for a reusable batch update controller template
• assets/task-migration.template.ts for a reusable task controller template with progress reporting
• scripts/find-enonic-targets.mjs for deterministic scanning of Enonic XP project markers

Enonic Content Type Generator Skill

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.

Install with APM:

apm install webmaxru/enonic-agent-skills/skills/enonic-content-type-generator

Install with npm:

npx skills add webmaxru/enonic-agent-skills --skill enonic-content-type-generator

It covers:

• creating content type XML schemas from natural-language field descriptions
• mapping field descriptions to correct Enonic XP input types and configurations
• generating mixins, x-data, item sets, and option sets
• validating output XML for well-formedness and correct input type usage
• scaffolding the correct directory structure under site/content-types/

Its support files are split by purpose:

• references/content-type-reference.md for input types, super-types, and schema structure
• references/examples.md for complete content type definition patterns
• references/troubleshooting.md for XML validation errors and input type mismatches
• assets/content-type.template.xml for a starter content type template
• scripts/find-enonic-targets.mjs for deterministic scanning of Enonic XP project markers

Enonic Guillotine Query Builder Skill

skills/enonic-guillotine-query-builder composes, debugs, and optimizes Guillotine GraphQL queries for Enonic XP headless content delivery.

Install with APM:

apm install webmaxru/enonic-agent-skills/skills/enonic-guillotine-query-builder

Install with npm:

npx skills add webmaxru/enonic-agent-skills --skill enonic-guillotine-query-builder

It covers:

• constructing GraphQL queries using Query DSL input types
• building content type fragments with inline fragment type-name deriving
• filtering, sorting, pagination, aggregations, and highlighting
• migrating from deprecated 5.x string-based queries to 6.x+ DSL syntax
• generating TypeScript types from Guillotine query responses

Its support files are split by purpose:

• references/guillotine-reference.md for the Guillotine API surface and query patterns
• references/examples.md for complete query construction patterns
• references/compatibility.md for version migration and breaking changes
• references/troubleshooting.md for null results, type errors, and deprecated API usage
• assets/guillotine-query.template.ts for a reusable typed query template
• scripts/find-guillotine-targets.mjs for deterministic scanning of Guillotine markers in the workspace

Enonic Next.XP Integration Skill

skills/enonic-nextxp-integration guides setup, development, and troubleshooting of the Next.js and Enonic XP headless integration (Next.XP framework).

Install with APM:

apm install webmaxru/enonic-agent-skills/skills/enonic-nextxp-integration

Install with npm:

npx skills add webmaxru/enonic-agent-skills --skill enonic-nextxp-integration

It covers:

• configuring the @enonic/nextjs-adapter package and environment variables
• mapping Enonic content types to React components via ComponentRegistry
• wiring Guillotine GraphQL data fetching in Next.js with typed queries
• enabling Content Studio preview mode with draft/master branch switching
• deploying Enonic + Next.js to production (Enonic Cloud + Vercel)

Its support files are split by purpose:

• references/nextxp-reference.md for adapter configuration, component registry API, and deployment checklist
• references/examples.md for complete content type mapping examples including queries, views, and processors
• references/compatibility.md for version requirements between the adapter, Next.js, and Enonic XP
• references/troubleshooting.md for preview failures, blank pages, and configuration issues
• assets/nextxp-page.template.tsx for a reusable page component template

Enonic App Manager Skill

skills/enonic-app-manager guides developers through Enonic CLI commands for sandbox management, project scaffolding, local development, app deployment, and CI/CD pipeline generation.

Install with APM:

apm install webmaxru/enonic-agent-skills/skills/enonic-app-manager

Install with npm:

npx skills add webmaxru/enonic-agent-skills --skill enonic-app-manager

It covers:

• creating, starting, stopping, upgrading, and deleting Enonic XP sandboxes
• scaffolding new projects from starters (starter-vanilla, starter-headless, starter-nextjs)
• running dev mode with hot-reload, building, deploying, and testing Enonic apps
• managing applications on running XP instances
• generating GitHub Actions CI/CD workflows for Enonic projects

Its support files are split by purpose:

• references/cli-reference.md for the full Enonic CLI command catalog
• references/examples.md for common CLI workflow patterns
• references/compatibility.md for CLI-to-XP version compatibility
• references/troubleshooting.md for sandbox startup failures, port conflicts, and deployment issues
• assets/enonic-ci.template.yml for a GitHub Actions CI/CD workflow template
• assets/sandbox-setup.template.sh for a sandbox setup script template
• scripts/find-enonic-targets.mjs for deterministic scanning of Enonic XP project markers

Enonic Event Manager Skill

skills/enonic-event-manager sets up Enonic XP event listeners, webhook configurations, and external system integrations triggered by content lifecycle events.

Install with APM:

apm install webmaxru/enonic-agent-skills/skills/enonic-event-manager

Install with npm:

npx skills add webmaxru/enonic-agent-skills --skill enonic-event-manager

It covers:

• registering event listeners for content publish, create, update, and delete events
• configuring outbound webhooks via com.enonic.xp.webhooks.cfg
• building HTTP service controllers for inbound webhook endpoints
• wiring async processing with lib-task for heavy or long-running event handlers
• calling external systems with lib-httpClient from event callbacks

Its support files are split by purpose:

• references/event-reference.md for event types, listener patterns, and task event lifecycle
• references/webhook-reference.md for outbound webhook configuration and inbound service endpoints
• references/examples.md for CDN invalidation, search reindexing, and notification patterns
• references/troubleshooting.md for event non-firing, webhook delivery failures, and 404 service errors
• assets/event-listener.template.ts for a reusable event listener scaffold
• assets/http-service.template.ts for a reusable inbound webhook service scaffold
• scripts/find-enonic-targets.mjs for deterministic scanning of Enonic XP project markers

Enonic Controller Generator Skill

skills/enonic-controller-generator generates Enonic XP controller files (TypeScript/JavaScript) and paired XML descriptors for pages, parts, and layouts.

Install with APM:

apm install webmaxru/enonic-agent-skills/skills/enonic-controller-generator

Install with npm:

npx skills add webmaxru/enonic-agent-skills --skill enonic-controller-generator

It covers:

• scaffolding page controllers with regions, part controllers with config access, and layout controllers with multi-region support
• generating paired XML descriptors with display names, forms, and region definitions
• generating Thymeleaf or Mustache view templates with proper region wiring
• creating response processors for site-level HTTP response modification
• updating build.gradle with required library dependencies

Its support files are split by purpose:

• references/controller-reference.md for XML descriptor schema and Portal API surface
• references/examples.md for known-good controller patterns
• references/compatibility.md for TypeScript vs JavaScript differences
• references/troubleshooting.md for descriptor mismatches and rendering issues
• assets/page-controller.template.ts for a reusable page controller template
• assets/part-controller.template.ts for a reusable part controller template
• assets/layout-controller.template.ts for a reusable layout controller template
• scripts/find-enonic-targets.mjs for deterministic scanning of Enonic XP project markers

Repository Conventions

When adding or revising a skill here, keep these rules intact:

1. The skill directory name must match the YAML name exactly.
2. Skill descriptions should be precise enough to route correctly and include both positive and negative triggers.
3. SKILL.md should stay lean, procedural, and agent-oriented.
4. Large examples, verbose rules, and schemas belong in references/ or assets/.
5. File paths inside skills should stay relative and use forward slashes.
6. Skill folders should remain flat under scripts/, references/, and assets/.
7. Human-oriented files such as per-skill README.md or CHANGELOG.md should not be added inside skill directories.

Common Workflows

Scan a Workspace for Enonic XP Targets

node skills/enonic-content-management/scripts/find-enonic-targets.mjs .

The scanner locates Enonic XP project markers: build.gradle with com.enonic.xp dependencies, src/main/resources/ directory structure, and gradle.properties with xpVersion.

Scan a Workspace for Guillotine Targets

node skills/enonic-guillotine-query-builder/scripts/find-guillotine-targets.mjs .

The scanner inventories files containing Guillotine markers such as query strings, library imports, queryDsl, queryDslConnection, and /lib/guillotine references.

References

• Enonic XP documentation: https://developer.enonic.com/docs
• agentskills.io best practices: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices