Agent skill · operations · aiskillstore
agent-communication-debugger
Diagnoses and debugs A2A agent communication issues including agent status, message routing, transport connectivity, and log analysis. Use when agents aren't responding, messages aren't being delivered, routing is incorrect, or when debugging orchestrator, coder-agent, tester-agent communication problems.
Why this skill is useful
Provides specific Bash commands and scripts for diagnosing A2A agent communication issues that the AI wouldn't reliably generate on its own.
What it needs
Requires python installed locally. About 6k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Agent Communication Debugger Debug and diagnose issues with the A2A (Agent-to-Agent) communication system, including the orchestrator, coder-agent, tester-agent, and message transport layers. Prerequisites A2A agent system located in a2acommunicatingagents/ Python 3.10+ environment Access to agent logs in logs/ directory Agent configurations in respective agent.json files Instructions 1. Check Agent Status First, determine which agents are running: Look for: orchestratoragent/main.py coderagent/main.py testeragent/main.py websocketserver.py Common issues: Agent process not found → Agent isn't running, needs to be started Multiple instances → Duplicate processes causing conflicts 2. Inspect Agent Configurations Read the agent configuration files to verify capabilities and topics: Verify: Agent names match expected values Topics are correctly defined Capabilities describe what the agent does No JSON syntax errors 3. Check Agent Logs Examine logs for errors and message flow: Look for: Connection errors Routing decisions showing wrong agent selection JSON parsing errors Message processing failures 4. Verify Message Transport Check if the message transport (WebSocket or RAG board) is working: Expected: WebSocket server on port 8765 (if using WebSocket transport) Recent messages in storage/messageboard.jsonl (if using RAG transport) No permission errors accessing storage 5. Test Message Sending Use the provided test script to send a message and verify delivery: This script will: 1. Send a test message to the orchestrator topic 2. Wait for response 3. Show message delivery status 4. Display any responses received 6. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/agent-communication-debugger