troubleshooting-liferay

Diagnose failing local Liferay runtimes using ldev doctor, status, and logs.

3|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/mordonez/ldev --skill troubleshooting-liferay
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshooting-liferay
Source: https://github.com/mordonez/ldev/tree/main/templates/ai/skills/troubleshooting-liferay
Command: npx skills add https://github.com/mordonez/ldev --skill troubleshooting-liferay

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Use this skill to diagnose failing or unstable local Liferay runtimes when the root cause is not obvious, enabling safe, structured analysis before attempting fixes.

Core Features & Use Cases

  • Guided diagnosis using ldev doctor, status, and logs to surface health signals and failure points.
  • Isolated reproduction workflows via worktrees to reproduce issues without contaminating the main environment.
  • Portal inventory, OSGi, and content checks to narrow down the responsible subsystem and validate suspected defects.

Quick Start

Execute a guided diagnostic sequence using ldev tools to identify and reproduce the issue safely.

Frequently Asked Questions about troubleshooting-liferay

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose a failing Liferay runtime when the root cause is unclear?

Diagnose an unstable Liferay runtime by running guided diagnostic sequences with ldev doctor and status commands, then inspecting logs to surface health signals and identify failure points before attempting fixes.

How do I safely reproduce a Liferay portal issue without contaminating my main environment?

Safely reproduce a Liferay portal issue by using isolated git worktrees, which create a contained environment for production-like reproduction workflows without contaminating your main development setup.

What's the best way to check OSGi bundle health and portal inventory in Liferay?

Check OSGi bundle health and portal inventory in Liferay by running targeted diagnostic commands that inspect subsystem states, narrowing down the responsible module and validating suspected defects.

Why does my local Liferay portal startup fail with OSGi errors?

Local Liferay portal startup failures with OSGi errors often stem from unstable runtime states; inspect OSGi module status and runtime logs to isolate the failing subsystem and identify the root cause.

Can I use ldev tools to troubleshoot Liferay worktree environments?

Yes, you can use ldev tools to troubleshoot Liferay worktree environments by executing diagnostic sequences and applying guardrails that enforce safe isolation during issue reproduction and analysis.

What should I do before attempting fixes on an unstable Liferay runtime?

Before attempting fixes on an unstable Liferay runtime, perform structured analysis by gathering runtime health signals, reviewing logs, and checking portal inventory to ensure safe and accurate diagnosis.