liferay-fragments

Activate this skill whenever you are running E2E tests, capturing screenshots, promoting visual baselines, or interpreting E2E test results for Liferay fragments. It specifies the exact commands for full-suite runs, targeted fragment runs, and visual baseline promotion, and documents the current known platform blocker.

Activate this skill when a task is large enough to benefit from splitting work across concurrent or hierarchical subagents — for example, running research and implementation in parallel, or delegating lint/test execution to a background agent while the coordinator continues planning. It defines the collaboration patterns, spawn constraints, output integration rules, and conflict resolution protocol.

Activate this skill when executing any multi-phase fragment development task — scaffolding, linting, compatibility build, E2E testing, or documentation update — where the output of one phase is the required input to the next. It defines the canonical pipeline phases, their inputs/outputs, and the active constraints that prevent a downstream phase from starting before its upstream gate has passed.

Activate this skill whenever you are creating a branch, opening a Pull Request, merging code, or performing any Git / GitHub CLI operation in the liferay-fragments repository. It enforces branch naming conventions, pre-commit validation gates, the PR auto-merge protocol, and the code-review requirement.

Activate this skill whenever you are planning a new feature, bug fix, enhancement, or any tracked piece of work. It mandates issue-first development and prescribes the exact workflow for creating, syncing, and closing GitHub Issues using the gh-issue-sync.cjs automation tool.

Activate this skill whenever you are building, packaging, or releasing fragment ZIP collections. It defines the mandatory three-target build strategy that produces separate ZIPs for Liferay 2026.Q1+, pre-2026.Q1, and pre-2025.Q3, and specifies the exact dataType and checkbox default-value transformation rules for each target.

Activate this skill after completing any implementation task — code change, configuration update, bug fix, or refactor. It mandates an active documentation review pass before the PR is opened, ensuring all affected markdown files are kept in sync with the codebase and their timestamps accurately reflect when they were last reviewed or changed.

Activate this skill whenever you are creating, modifying, or committing a Liferay fragment. It enforces the three project-level quality rules that every fragment must satisfy before it can be committed: localization coverage, documentation completeness, and theme fidelity (no hardcoded colours).

This skill is ALWAYS active. It is a foundational behavioural constraint that applies to every task, every skill, and every response. It expressly forbids making any unverified technical statement about this repository — how a system behaves, what a file contains, what an API does, or what a value is — without first executing a verification tool and waiting for the result.

Activate this skill whenever you encounter code smells, excessive complexity, duplication, or any other technical debt signal during your work — regardless of what your primary task is. It mandates recording tech debt as a labelled GitHub Issue and defines a clear threshold for whether to fix it inline or defer it.

Guidelines and workflows for creating, structuring, developing, and mapping properties for page fragments in Liferay DXP.

Expert guidance for developing Liferay Form Fragments. Use when creating, modifying, or auditing Form Fragments that map to Object fields via Form Containers.

Expert guidance for developing Liferay Fragments. Use when creating, modifying, or auditing Liferay Fragments to ensure compliance with architectural, accessibility, responsiveness, and multi-theme (Classic, Dialect, Meridian) standards.

Single entry point for all Liferay Fragment skills. Routes requests to specialized skills for scaffolding, linting, compatibility transformation, and E2E testing.

Instructions on building, maintaining, and extending the Liferay DXP build-time configuration compatibility transformations (create-fragment-zips.sh) using jq.

Instructions for running, analyzing, and satisfying the Liferay fragments quality gate and linter rules.

Instructions for capturing responsive screenshots of page fragments and updating the project's visual gallery markdown.

Instructions for zipping, seeding, E2E testing, and capturing visual snapshots of fragments in Liferay DXP using the workspace's custom bootstrap framework.

Guidelines and step-by-step instructions for generating, capturing, verifying, and committing updated visual screenshots of Liferay page fragments.