[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75WGSZMPTPBC7WR04EBV11H":3,"skill-same:01M75WGSZMPTPBC7WR04EBV11H":45},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":14,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":44},"01M75WGSZMPTPBC7WR04EBV11H","swarm-agent-troubleshooting",null,"Diagnose and fix swarm agent spawn failures when agents don't start processing tasks","stevengonsalvez\u002Fainb-toolkit","stevengonsalvez","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F9320602?v=4","01M75W59QRYZYANWY3XG8CJB1P","Steven Gonsalvez","01M75W59RD5YW1RT67BDV0EAZF",1,"MIT","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fswarm-agent-troubleshooting\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: swarm-agent-troubleshooting\ndescription: Diagnose and fix swarm agent spawn failures when agents don't start processing tasks\nuser-invocable: true\n---\n\n# Swarm Agent Troubleshooting\n\nDiagnose and fix swarm agent spawn failures when agents don't start processing tasks.\n\n## When to Use\n\n- Agent tmux session created but stuck at shell prompt\n- Agent not responding to inbox messages\n- `wait_for_claude_ready()` times out\n- Symptoms: dotenv prompt, zsh theme loading, or no Claude banner visible\n\n## Quick Diagnosis\n\n```bash\n# 1. List swarm sessions\ntmux list-sessions | grep swarm\n\n# 2. Attach to stuck agent\ntmux attach -t swarm-XXXX-agent-1\n\n# 3. Check what's showing:\n#    - Shell prompt (zsh\u002Fbash) = Claude didn't start\n#    - \"dotenv: found '.env'\" = Blocked by prompt\n#    - Claude banner = Ready (check if task was sent)\n```\n\n## Common Causes\n\n| Symptom | Cause | Fix |\n|---------|-------|-----|\n| `dotenv: found '.env' file. Source it?` | dotenv plugin prompt | Send `a` (always) then restart claude |\n| Shell prompt showing | Claude command never ran | Manually run `claude --dangerously-skip-permissions` |\n| Claude banner but idle | Task not sent after spawn | Resend the task prompt |\n| \"command not found: claude\" | Claude not in PATH | Check `which claude` or use full path |\n\n## Manual Recovery Steps\n\n```bash\n# Step 1: Attach to the stuck session\ntmux attach -t swarm-XXXX-agent-1\n\n# Step 2: If at dotenv prompt, answer it\n# (type 'a' for always, then Enter)\n\n# Step 3: If at shell, start Claude manually\nclaude --dangerously-skip-permissions\n\n# Step 4: Once Claude is ready, send the task\n# (paste the agent's task prompt)\n\n# Step 5: Detach (Ctrl+B, D) and continue monitoring\n```\n\n## Prevention\n\n### Update Shell Config\n\nAdd to `~\u002F.zshrc` or `~\u002F.bashrc`:\n```bash\n# Auto-accept dotenv in non-interactive contexts\nexport DOTENV_ASSUME_YES=1\n```\n\n### Increase Detection Timeout\n\nIn `spawn-agent-lib.sh`, increase the timeout:\n```bash\nwait_for_claude_ready \"$SESSION\" 60  # Increase from 30 to 60 seconds\n```\n\n### Add Detection Patterns\n\nThe `wait_for_claude_ready()` function looks for these patterns:\n- \"Claude Code\"\n- \"Welcome back\"\n- \"──────\" (horizontal rule)\n- \"Style:\"\n- \"bypass permissions\"\n\nIf your terminal has different output, add patterns to the grep regex.\n\n## Debug Logs\n\nFailed spawn attempts save debug output:\n```bash\ncat \u002Ftmp\u002Fspawn-agent-swarm-XXXX-agent-1-failure.log\n```\n\n## Related\n\n- `\u002Fswarm-status` - Check overall swarm health\n- `\u002Fswarm-shutdown` - Clean up stuck swarm\n- `spawn-agent-lib.sh` - Core spawning library\n","# Swarm Agent Troubleshooting\n\nDiagnose and fix swarm agent spawn failures when agents don't start processing tasks.\n\n## When to Use\n\n- Agent tmux session created but stuck at shell prompt\n- Agent not responding to inbox messages\n- `wait_for_claude_ready()` times out\n- Symptoms: dotenv prompt, zsh theme loading, or no Claude banner visible\n\n## Quick Diagnosis\n\n```bash\n# 1. List swarm sessions\ntmux list-sessions | grep swarm\n\n# 2. Attach to stuck agent\ntmux attach -t swarm-XXXX-agent-1\n\n# 3. Check what's showing:\n#    - Shell prompt (zsh\u002Fbash) = Claude didn't start\n#    - \"dotenv: found '.env'\" = Blocked by prompt\n#    - Claude banner = Ready (check if task was sent)\n```\n\n## Common Causes\n\n| Symptom | Cause | Fix |\n|---------|-------|-----|\n| `dotenv: found '.env' file. Source it?` | dotenv plugin prompt | Send `a` (always) then restart claude |\n| Shell prompt showing | Claude command never ran | Manually run `claude --dangerously-skip-permissions` |\n| Claude banner but idle | Task not sent after spawn | Resend the task prompt |\n| \"command not found: claude\" | Claude not in PATH | Check `which claude` or use full path |\n\n## Manual Recovery Steps\n\n```bash\n# Step 1: Attach to the stuck session\ntmux attach -t swarm-XXXX-agent-1\n\n# Step 2: If at dotenv prompt, answer it\n# (type 'a' for always, then Enter)\n\n# Step 3: If at shell, start Claude manually\nclaude --dangerously-skip-permissions\n\n# Step 4: Once Claude is ready, send the task\n# (paste the agent's task prompt)\n\n# Step 5: Detach (Ctrl+B, D) and continue monitoring\n```\n\n## Prevention\n\n### Update Shell Config\n\nAdd to `~\u002F.zshrc` or `~\u002F.bashrc`:\n```bash\n# Auto-accept dotenv in non-interactive contexts\nexport DOTENV_ASSUME_YES=1\n```\n\n### Increase Detection Timeout\n\nIn `spawn-agent-lib.sh`, increase the timeout:\n```bash\nwait_for_claude_ready \"$SESSION\" 60  # Increase from 30 to 60 seconds\n```\n\n### Add Detection Patterns\n\nThe `wait_for_claude_ready()` function looks for these patterns:\n- \"Claude Code\"\n- \"Welcome back\"\n- \"──────\" (horizontal rule)\n- \"Style:\"\n- \"bypass permissions\"\n\nIf your terminal has different output, add patterns to the grep regex.\n\n## Debug Logs\n\nFailed spawn attempts save debug output:\n```bash\ncat \u002Ftmp\u002Fspawn-agent-swarm-XXXX-agent-1-failure.log\n```\n\n## Related\n\n- `\u002Fswarm-status` - Check overall swarm health\n- `\u002Fswarm-shutdown` - Clean up stuck swarm\n- `spawn-agent-lib.sh` - Core spawning library\n",{"name":5,"description":7,"user-invocable":24},true,"main","9cf32d1e636db09530158af14ba301bfa5d401e9","skills\u002Fswarm-agent-troubleshooting","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez","stevengonsalvez.com","2026-11-12 00:50:59",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":24},[34,37,40],{"tool":35,"command":36},"npx","npx skills add stevengonsalvez\u002Fainb-toolkit --skill swarm-agent-troubleshooting",{"tool":38,"command":39},"bunx","bunx skills add stevengonsalvez\u002Fainb-toolkit --skill swarm-agent-troubleshooting",{"tool":41,"command":42},"pnpm","pnpm dlx skills add stevengonsalvez\u002Fainb-toolkit --skill swarm-agent-troubleshooting","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fswarm-agent-troubleshooting\u002FSKILL.md",[],[46,53,60,66,73,80],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":19},"01M75WK9B8DKVJBJJ4CX2QMJMX","well-formed","Fixture skill that satisfies every mechanical rule, used to prove the conformance check passes a clean tree instead of failing everything.","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fagentskills\u002Fclean\u002Fwell-formed\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M75WK6ZGDXJJN8879K49QEYG","underscore-tools","Fixture skill that spells the tool allowlist key with an underscore instead of the hyphen the spec requires.","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fagentskills\u002Fbroken\u002Funderscore-tools\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M75WK524MVT2H9E27ZCEA3HR","no-frontmatter","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fagentskills\u002Fbroken\u002Fno-frontmatter\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M75WJWZBMKR8R60PG3T3MCCC","long-description","Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling.","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fagentskills\u002Fbroken\u002Flong-description\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M75WJVRH3J22WKED7E5D01S8","some-other-name","Fixture skill whose frontmatter name does not match its parent directory name.","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fagentskills\u002Fbroken\u002Fdir-mismatch\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M75WJTC7H5FRP6S129VBSMZC","bad_Name","Fixture skill whose name uses an underscore and a capital letter, so it violates the agentskills.io name pattern.","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fagentskills\u002Fbroken\u002Fbad_Name\u002FSKILL.md",[],[]]