zes-build-fix

Diagnose and resolve ZES service startup failures, dependency errors, and port conflicts.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/ZESCODE/Zes-Orchestration-System --skill zes-build-fix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zes-build-fix
Source: https://github.com/ZESCODE/Zes-Orchestration-System/tree/main/.agents/skills/ZES-build-fix
Command: npx skills add https://github.com/ZESCODE/Zes-Orchestration-System --skill zes-build-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves operational bottlenecks and service startup failures within the ZES orchestration environment, including port conflicts, missing dependencies, and supervision errors.

Core Features & Use Cases

  • Service Diagnostics: Quickly identify why a ZES service or agent is failing to initialize using standard runit status checks.
  • Environment Troubleshooting: Automatically detect missing Python or Node modules and resolve port contention issues.
  • Use Case: When the ZES dashboard fails to load, use this skill to inspect the service logs and identify the specific import error or port conflict preventing the process from running.

Quick Start

Use the zes-build-fix skill to diagnose the current status and logs for the failing service.

Frequently Asked Questions about zes-build-fix

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

FAQPage Schema
How do I troubleshoot runit service startup failures in a ZES orchestration system?

To troubleshoot runit service startup failures in the ZES orchestration system, inspect system logs and run standard runit status checks to identify the specific initialization error preventing the process from running.

Why does my ZES dashboard fail to load when an agent proxy starts?

Your ZES dashboard may fail to load due to port conflicts, missing Python or Node environment dependencies, or supervision errors that block agent proxy configurations from initializing properly.

What's the best way to diagnose port conflicts and missing dependencies for ZES services?

The best way to diagnose port conflicts and missing dependencies for ZES services is to perform root cause analysis using system logs and process management utilities to detect environment errors.

Do I need system log access to resolve ZES agent proxy configuration errors?

Yes, resolving ZES agent proxy configuration errors requires access to system logs and process management utilities to perform root cause analysis and execute proper service recovery.

How do I fix missing Python or Node module errors preventing ZES services from running?

To fix missing Python or Node module errors in ZES services, run environment troubleshooting procedures to automatically detect the missing dependencies and resolve the import errors within the orchestration environment.

When should I perform service diagnostics on a failing runit-managed process?

You should perform service diagnostics on a failing runit-managed process immediately when it fails to initialize, using status checks to identify the specific import error or port conflict preventing it from running.