deployment-diagnosis-agent

Diagnose deployment and runtime failures by tracing image, config, port, network, health-check, and environment mismatches.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/harkers/forge-email-server --skill deployment-diagnosis-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deployment-diagnosis-agent
Source: https://github.com/harkers/forge-email-server/tree/main/skills/deployment-diagnosis-agent
Command: npx skills add https://github.com/harkers/forge-email-server --skill deployment-diagnosis-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Diagnose deployment and runtime failures by tracing image, config, port, network, health-check, and environment mismatches.

Core Features & Use Cases

  • Identify why a deployment is unhealthy or unreachable.
  • Trace config/image/runtime mismatches and verify health-check behavior.
  • Narrow the failure to the smallest useful cause and propose concrete next steps.

Quick Start

Run the deployment-diagnosis-agent against the failing service to generate a diagnosis, evidence, root cause, and recommended fix.

Frequently Asked Questions about deployment-diagnosis-agent

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

FAQPage Schema
How do I troubleshoot a container deployment that is unhealthy or unreachable?

To troubleshoot an unhealthy container deployment, trace image, config, port, network, health-check, and environment mismatches to identify why the service is unreachable and narrow the failure to the smallest useful cause.

Why does my service behave differently in deployment than in development?

A service behaves differently in deployment than in development due to config, image, port, network, or environment mismatches introduced during the deployment process that alter runtime behavior.

What is the best way to diagnose runtime failures when a service fails to bind ports or returns bad responses?

The best way to diagnose runtime failures where a service fails to bind or returns bad responses is to trace health-check behavior and verify environment and network configurations to locate mismatches.

How do I find the root cause of a deployment failure to apply a concrete next step?

To find the root cause of a deployment failure, trace configuration and runtime mismatches to generate a structured diagnosis containing gathered evidence, a likely root cause, confidence level, and a recommended fix.

Can I diagnose health-check and network mismatches without external dependencies?

Yes, you can diagnose health-check and network mismatches without external dependencies by tracing the deployment configuration directly to verify behavior and identify mismatches causing the failure.