gateway-startup-retry-recovery

Diagnose and mitigate Hermes gateway startup failures by classifying retryable adapter errors.

1|Updated Apr 30, 2025
One-click install
npx skills add https://github.com/lucasfth/config --skill gateway-startup-retry-recovery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gateway-startup-retry-recovery
Source: https://github.com/lucasfth/config/tree/main/.hermes/skills/software-development/gateway-startup-retry-recovery
Command: npx skills add https://github.com/lucasfth/config --skill gateway-startup-retry-recovery

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debug and fix Hermes gateway startup failures where one or more platform adapters fail to connect. Distinguish retryable vs non-retryable errors, keep the gateway alive when recovery is possible, and add regression tests.

Core Features & Use Cases

  • Identify retryable vs non-retryable startup errors and classify them during gateway initialization.
  • Keep the gateway running when recovery is possible, queuing failed platforms for automatic reconnection.
  • Add regression tests to ensure runtime status reflects running and failed platforms are retried.

Quick Start

Reproduce a gateway startup path with a retryable adapter failure in a local harness and verify the gateway remains running.

Frequently Asked Questions about gateway-startup-retry-recovery

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

FAQPage Schema
How do I keep a gateway running when a platform adapter fails on startup?

To keep a gateway running during adapter startup failures, classify the error as retryable or non-retryable, queue failed platforms for automatic reconnection, and update runtime status to retrying while the gateway stays alive.

Why does my gateway crash when one adapter fails to connect during initialization?

Your gateway crashes on adapter initialization failures because non-retryable errors halt the process. Distinguishing retryable connection errors allows the gateway to isolate failed adapters, maintain a retry queue, and preserve overall gateway uptime.

How do I distinguish retryable from non-retryable adapter startup errors?

Distinguishing retryable from non-retryable adapter startup errors involves classifying connection failures during gateway initialization, queuing retryable platforms for automatic reconnection, and preserving failure reasons for non-retryable errors in runtime status.

Can I add regression tests for gateway startup retry and recovery behavior?

Yes, you can add regression tests for gateway startup retry behavior by reproducing a startup path with a retryable adapter failure in a local harness and verifying that runtime status reflects running and failed platforms are retried.

Does this gateway recovery approach work with Slack, Telegram, and Discord adapters?

Yes, this gateway recovery approach works with platform adapters like Slack, Telegram, and Discord by diagnosing their specific startup failures, queuing retryable connection errors, and maintaining gateway runtime status during recovery attempts.

What is the best way to handle platform adapter connection failures in a Hermes gateway?

The best way to handle platform adapter connection failures in a Hermes gateway is to classify startup errors, maintain a retry queue for failed adapters, and update runtime status to running or retrying while preserving failure reasons.