Skills
.Work. You
Rest

swarm-agent-troubleshooting

Community

Diagnose and fix swarm agent startup failures.

Software Engineering#troubleshooting#claude#agent#tmux#swarm#startup#container
Authorstevengonsalvez
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Diagnose and fix swarm agent spawn failures when agents fail to start processing tasks.

Core Features & Use Cases

  • Guided diagnosis of common startup issues for swarm agents, with steps to attach to sessions, check prompts, and verify Claude readiness.
  • Manual recovery steps to regain agent operation, upgrade shell prompts, and ensure task delivery.
  • Use cases include stuck tmux sessions, non-responsive agents, and timeouts in wait_for_claude_ready.

Quick Start

Attach to the swarm agent session and follow the guided recovery steps to restore Claude readiness.

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: swarm-agent-troubleshooting
Download link: https://github.com/stevengonsalvez/nanoclaw-standalone/archive/main.zip#swarm-agent-troubleshooting

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 471,000+ vetted skills library on demand.