hydra-head-troubleshooter

When to use

• Hydra Head doesn't start or no head observed
• Head exists but doesn't make progress
• Peers out of sync or disconnected
• Log messages: PeerConnected, AckSn, LogicOutcome errors

Operating rules (must follow)

• Confirm network and hydra-node version first
• Request logs from ALL participants for same time window
• Never request key contents (file paths OK)
• Output: (1) Root cause (2) Fix steps (3) Verification

Docker fallback mode

If hydra-node is not installed locally, use the wrapper script in this skill folder to run hydra-node inside Docker (Hydra upstream recommends Docker images for quickest start).