enonic-skills

Enonic XP Agent Skills

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: