Safe, read-only diagnostic tool for troubleshooting self-hosted stacks, port conflicts, and service failures. Use when: Identify port conflicts between Docker containers and host services; Debug Cloudflare Tunnel configuration and credential path issues; Detect Nginx default_server collisions and syntax errors.
64%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./skills/selfhosted-env-doctor/SKILL.mdFree skill by Nex AI. This file is the public guide from Agensi. Scripts, extension source, and templates from the original package are not in this folder.
Self-Hosted Env Doctor is a non-destructive diagnostic engine designed to identify why local services on Linux stacks (like Raspberry Pi) fail to launch. It systematically scans for port conflicts, misconfigured Nginx blocks, Cloudflare Tunnel errors, and database authentication failures without making any changes to your system.
The skill performs a comprehensive audit across multiple layers of your infrastructure. It checks systemd unit health, validates Nginx configuration syntax, audits listening sockets against your documentation, and verifies file permissions for sensitive items like .env files. Instead of generic error messages, it provides the specific root cause and the exact command needed to fix the issue manually.
Manually debugging a broken home lab or production server is time-consuming. This skill automates the "triage" phase by cross-referencing system state with common failure patterns (like port drift or disk space exhaustion). Because it is strictly read-only, it is safe to run on critical systems where you don't want an AI accidentally modifying configuration files or restarting services without supervision.
Request
My nginx service won't start after I added the new dashboard. Can you run a diagnosis on the server?
Result
Found 1 Critical Issue:
[Nginx] Port Conflict: Port 80 is already bound by 'apache2'.
Fix: Run sudo systemctl stop apache2 && sudo systemctl disable apache2 or change the listen port in /etc/nginx/sites-available/dashboard.
No, this skill is strictly read-only. It identifies the root cause of service failures and provides you with the exact command to fix it manually, ensuring you maintain full control over your server configuration.
This skill is optimized for Linux-based environments, including Raspberry Pi (Debian/Ubuntu), and supports diagnostic checks for Nginx, Cloudflare Tunnels, systemd, and PostgreSQL databases.
Env Doctor automates the 'triage' phase of troubleshooting, instantly spotting common issues like port conflicts, disk space exhaustion, and permission errors that usually take hours of manual log-checking to find.
Setup is minimal; once the skill is added to your AI agent, you simply provide the agent with the necessary read access to your terminal or logs to begin the diagnostic scan.
Your purchase includes the full diagnostic engine, all current service modules (Nginx, Systemd, etc.), and lifetime access to any future logic updates or new service modules added to the skill.
Built by Nex AI. More skills, including the paid catalog: https://www.agensi.io/creators/ch1n4-g3nd4x
NexaiGuy/nex-ai-skills
4034c84
Also appears in
since Nov 6, 2026
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.