← Back to Skills Marketplace
laolaoqi

Linux systemd Doctor

by new · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
33
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install linux-systemd-doctor
Description
Diagnose and fix failed Linux systemd services. Check service status, read journalctl logs, analyze unit files, fix dependencies, port conflicts, and permiss...
README (SKILL.md)

Linux systemd Doctor

Troubleshoot and fix broken systemd services.

Quick Diagnosis

# Check service status
systemctl status SERVICE --no-pager -l

# View full journal
journalctl -u SERVICE -n 100 --no-pager

# Follow live logs
journalctl -u SERVICE -f

Common Fixes

Service won't start

  1. Check syntax
    systemctl cat SERVICE
    
  2. View full error
    journalctl -u SERVICE -n 50 --no-pager -x
    
  3. Test the ExecStart command directly
  4. Check ExecStartPre failures
  5. Verify file permissions on all referenced paths

Service keeps restarting (Restart=always loop)

# Stop the restart loop
systemctl stop SERVICE

# Check the actual error
journalctl -u SERVICE -n 200 --no-pager

# Temporary fix: set Restart=no to debug
systemctl edit SERVICE
# Add:
# [Service]
# Restart=no

Service File Reference

Directive Purpose
ExecStart Main command
ExecStartPre Pre-start checks
ExecReload Reload command
Restart=on-failure Auto-restart strategy
RestartSec=5 Wait time between restarts
StartLimitIntervalSec=60 Rate limiting
User= Unprivileged user
WorkingDirectory= CWD for service
Environment= Env variables
LimitNOFILE= File descriptor limit

Port Conflict Check

# Check if service port is occupied
systemctl cat SERVICE | grep -i port
ss -tlnp | grep ":\x3CPORT> "
Usage Guidance
Review this skill before enabling it for an agent with shell or sudo access. It is suitable for systemd troubleshooting, but require the agent to ask before stopping services or editing unit overrides, and make sure it provides a clear rollback plan.
Capability Analysis
Type: OpenClaw Skill Name: linux-systemd-doctor Version: 1.0.0 The skill bundle provides standard administrative commands (systemctl, journalctl, ss) for troubleshooting Linux systemd services. The instructions in SKILL.md are well-aligned with the stated purpose of diagnosing service failures and do not contain any indicators of malicious intent, data exfiltration, or prompt injection attacks.
Capability Assessment
Purpose & Capability
The commands match the stated purpose of diagnosing and fixing failed systemd services, including status checks, journal review, port checks, and service-file inspection.
Instruction Scope
The guide includes state-changing service operations such as stopping a service and editing its restart behavior, but it does not explicitly require user confirmation, backups, or rollback steps before making those changes.
Install Mechanism
This is an instruction-only skill with no install spec, no code files, and no static scan findings.
Credentials
The skill is Linux/systemd-specific and the instructions are aligned with that environment; there is no evidence of unrelated environment access.
Persistence & Privilege
Using systemctl edit can create persistent systemd override configuration, and service control/editing may require administrative privileges. The skill does not describe containment or how to revert the override.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install linux-systemd-doctor
  3. After installation, invoke the skill by name or use /linux-systemd-doctor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: diagnose and fix systemd services
Metadata
Slug linux-systemd-doctor
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Linux systemd Doctor?

Diagnose and fix failed Linux systemd services. Check service status, read journalctl logs, analyze unit files, fix dependencies, port conflicts, and permiss... It is an AI Agent Skill for Claude Code / OpenClaw, with 33 downloads so far.

How do I install Linux systemd Doctor?

Run "/install linux-systemd-doctor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Linux systemd Doctor free?

Yes, Linux systemd Doctor is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Linux systemd Doctor support?

Linux systemd Doctor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Linux systemd Doctor?

It is built and maintained by new (@laolaoqi); the current version is v1.0.0.

💬 Comments