skills.rest
chujianyun
chujianyunCOMMUNITY
Explore all skills by this author →
GitHub

hermes-ops

Diagnose and repair Hermes Agent gateway, configuration, and scheduling issues through CLI commands.

733|99|Updated Dec 19, 2025
Search Tags:#CLI#Troubleshooting#Diagnostics#gateway#ops#Hermes#agent maintenance
One-click install
npx skills add https://github.com/chujianyun/skills --skill hermes-ops
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-ops
Source: https://github.com/chujianyun/skills/tree/main/skills/operations/hermes-ops
Command: npx skills add https://github.com/chujianyun/skills --skill hermes-ops

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

When a Hermes Agent deployment misbehaves—gateway going offline, cron jobs not firing, profiles clashing, or tools and skills failing to load—this Skill gives an agent a disciplined check-diagnose-fix-verify workflow instead of guesswork or blind reinstalls.

Core Features & Use Cases

  • Structured Troubleshooting Workflow: A six-step process covering problem scoping, status collection, root-cause analysis, repair, verification, and reporting.
  • Command Reference: Curated Hermes CLI commands for health checks, config migration, gateway control, profiles, skills/tools, cron, auth, and memory.
  • Layered Root-Cause Order: Checks configuration first, then service processes, then auth/external dependencies, and only lastly source code or platform adapters.
  • Use Case: A user reports that a messaging platform stopped receiving messages after an upgrade. The agent runs hermes status --all, hermes doctor, and hermes gateway status, identifies a config migration gap, runs hermes config migrate, restarts the gateway, and verifies recovery.

Quick Start

Ask the agent to run a Hermes health check and diagnose why the gateway keeps disconnecting, following the check-diagnose-fix-verify workflow.

Frequently Asked Questions about hermes-ops

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

FAQPage Schema
How do I troubleshoot Hermes Agent gateway problems?▼

Start with hermes status --all, hermes doctor, and hermes gateway status to see whether the gateway process is running. If it is down or unstable, run hermes gateway restart and re-check status before investigating logs or source code.

How to fix Hermes cron jobs not executing?▼

List scheduled jobs with hermes cron list --all and check hermes cron status to confirm the scheduler state. You can manually trigger a job with hermes cron run <job_id> to verify whether the issue is scheduling or the job itself.

Why do Hermes skills or tools stop working after an upgrade?▼

Upgrades often cause configuration drift. Run hermes config check and hermes config migrate to fix missing or outdated options, then confirm loading with hermes skills list and hermes tools list.

Can I manage multiple Hermes profiles without config conflicts?▼

Yes. Use hermes profile list and hermes profile show <name> to inspect each profile, and prefix commands with hermes -p <name> to check gateway status or skills under a specific profile before switching.

When should I reinstall Hermes to fix a problem?▼

Reinstalling is a last resort. Most issues are configuration or process-level and resolve with hermes doctor --fix, config migrate, or a gateway restart. Only suspect source code after config, process, and auth causes are ruled out.

Related Skills

Explore More Software Engineering Skills→
passionseedpassionseed
2

status

Verify TrueFoundry connectivity and credential presence via environment variables and API call.

Official
Intermediate
ilove323ilove323

runbook

Create step-by-step operational runbooks with verification and rollback steps.

Community
Intermediate
huidgehuidge
2

cron-job-troubleshooting

Diagnose cron job failures by analyzing status, logs, and gateway errors.

Community
Advanced
PsychQuantPsychQuant

claude-docs-guide

Fetch official Claude Code CLI and API documentation for configuration and development queries.

Official
Basic