skills.rest
Und3rf10w
Und3rf10wCOMMUNITY
Explore all skills by this author →
Website𝕏@und3rf10wGitHub

swarm-troubleshooting

Diagnose and recover swarm coordination issues in Claude Code teams.

8|1|Updated Dec 16, 2025
Search Tags:#troubleshooting#tmux#swarm#diagnostics#recovery#spawn#kitty
One-click install
npx skills add https://github.com/Und3rf10w/claude-litter --skill swarm-troubleshooting
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: swarm-troubleshooting
Source: https://github.com/Und3rf10w/claude-litter/tree/main/plugins/claude-swarm/skills/swarm-troubleshooting
Command: npx skills add https://github.com/Und3rf10w/claude-litter --skill swarm-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides comprehensive diagnostic and recovery guidance for swarm coordination issues in Claude Code environments. It helps teams diagnose spawn failures, reconcile status mismatches, recover from crashed sessions, and troubleshoot multiplexer problems across kitty and tmux.

Core Features & Use Cases

  • Diagnostic workflow for spawn failures, status issues, and messaging problems.
  • Structured recovery strategies including soft, partial, and hard recovery with step-by-step guidance.
  • Troubleshooting guidance for kitty and tmux configuration and session management.

Quick Start

Begin by diagnosing a non-working team with /claude-swarm:swarm-diagnose <team> and follow the recommended steps to restore operation.

Frequently Asked Questions about swarm-troubleshooting

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

FAQPage Schema
How do I diagnose Claude Code swarm spawn failures and session crashes?▼

Diagnose Claude Code swarm spawn failures and session crashes by running structured diagnostic commands to identify status mismatches and coordination errors across managed kitty or tmux environments.

What is the best way to recover a crashed swarm session in tmux or kitty?▼

The best way to recover a crashed swarm session is to apply structured recovery strategies, utilizing soft, partial, or hard recovery steps to restore coordination across tmux or kitty multiplexers.

How do I fix swarm status mismatches in a Claude Code team environment?▼

Fix swarm status mismatches in a Claude Code team environment by following a diagnostic workflow that reconciles messaging problems and restores proper team coordination state.

Does swarm troubleshooting support both kitty and tmux multiplexer configurations?▼

Yes, swarm troubleshooting supports both kitty and tmux configurations, providing targeted troubleshooting guidance for multiplexer session management and setup issues within Claude Code environments.

When should I use hard recovery versus soft recovery for swarm coordination issues?▼

Use hard recovery for severe session crashes where soft or partial recovery steps fail to reconcile spawn failures and status mismatches in the swarm coordination layer.

Related Skills

Explore More Software Engineering Skills→
Und3rf10wUnd3rf10w
8

swarm-orchestration

Coordinate multiple Claude Code agents across tmux or kitty for multi-agent projects.

Community
Advanced
tienchinh21tienchinh21

orchestrator

Coordinate parallel workers executing feature plans with dependency handling.

Community
Advanced
somegeesomegee
3

terminal-swarm

Orchestrate headless terminal sessions for Claude Code workflows with a real-time dashboard.

Community
Advanced
bruno-garciabruno-garcia
1

tmux

Manage interactive and long-running commands in isolated tmux sessions.

Community
Intermediate