linux-service-triage

Diagnose Linux service failures by analyzing logs, systemd/PM2 status, and Nginx configurations.

61|11|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/viralcode/openwhale --skill linux-service-triage-viralcode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linux-service-triage
Source: https://github.com/viralcode/openwhale/tree/main/skills/linux-service-triage
Command: npx skills add https://github.com/viralcode/openwhale --skill linux-service-triage-viralcode

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve common issues with Linux services, ensuring applications are running correctly and accessible.

Core Features & Use Cases

  • Log Analysis: Examines system logs (journalctl, PM2 logs) to identify error patterns.
  • Service Status Checks: Verifies the status of systemd services or PM2 processes.
  • Configuration Validation: Checks Nginx reverse proxy configurations and DNS resolution.
  • Permission Auditing: Identifies and suggests fixes for file permission issues.
  • Use Case: When a web application becomes unresponsive, this Skill can pinpoint whether the issue lies with the service itself, its configuration, network access, or underlying system permissions.

Quick Start

Use the linux-service-triage skill to diagnose why my web app is returning a 502 error.

Frequently Asked Questions about linux-service-triage

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

FAQPage Schema
How do I diagnose a 502 error on my Linux server with Nginx?

To diagnose a 502 error on your Linux server with Nginx, you need to analyze systemd service status, PM2 process logs, and Nginx reverse proxy configurations to identify the failing upstream application. This process checks service availability and connection routing.

Why does my systemd service fail to start after a deployment?

Your systemd service fails to start due to application errors, file permission mismatches, or invalid configurations. Analyzing journalctl logs and auditing file paths will reveal the specific startup error pattern preventing execution.

What's the best way to troubleshoot an unreachable web application on Linux?

The best way to troubleshoot an unreachable web application on Linux is to perform a comprehensive triage: verify DNS records, inspect Nginx proxy settings, check systemd or PM2 status, and examine system logs for errors.

Can I check Nginx reverse proxy and DNS configurations for service issues?

Yes, you can check Nginx reverse proxy and DNS configurations to resolve service issues. Validating these settings ensures external requests correctly route to the internal application ports and domain names resolve properly.

How do I find file permission errors causing Linux service failures?

To find file permission errors causing Linux service failures, audit the file paths and system permissions required by the application. Identifying incorrect read, write, or execute permissions helps restore service availability and functionality.

What information do I need to troubleshoot a failing Linux service?

To troubleshoot a failing Linux service, you need the service details, observed symptoms, and optionally Nginx configurations or file paths. Providing this information enables comprehensive log analysis and configuration validation.