Skills
.Work. You
Rest

hermes-fix

Community

Repair broken Hermes agents over SSH.

Software Engineering#troubleshooting#ssh#repair#vps#gateway#hermes
Authorpaarths-collab
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill fixes broken self-hosted Hermes deployments on a remote VPS when the agent is unreachable, misconfigured, silent, or failing health checks. It turns a confusing post-deploy outage into a guided, safe recovery workflow with diagnosis, repair, verification, and rollback.

Core Features & Use Cases

  • Remote diagnosis over SSH: Checks Hermes version, gateway status, logs, and doctor output directly on the VPS.
  • Targeted repair flows: Handles common failures such as PATH issues, gateway restart loops, bot silence, model misconfiguration, missing provider keys, Docker permission problems, and memory leaks.
  • Safe recovery and validation: Uses dry-run planning, applies only the matching fix, reloads the gateway correctly, verifies health, and preserves existing Hermes state.
  • Use case: An AI coding agent can use this Skill to restore a VPS-hosted Hermes instance after deployment breaks or the bot stops responding.

Quick Start

Ask the skill to diagnose and repair the Hermes installation on your VPS over SSH, then follow its dry-run preview and let it apply the safest matching fix.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: hermes-fix
Download link: https://github.com/paarths-collab/hstack/archive/main.zip#hermes-fix

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 537,000+ vetted skills library on demand.