Agent skill
synapse-a2a
This skill provides comprehensive guidance for inter-agent communication using the Synapse A2A framework. Use this skill when sending messages to other agents, routing @agent patterns, understanding priority levels, handling A2A protocol operations, managing task history, configuring settings, or using File Safety features for multi-agent coordination. Automatically triggered when agent communication, A2A protocol tasks, history operations, or file safety operations are detected.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/synapse-a2a-s-hiraoku-synapse-a2a
SKILL.md
Synapse A2A Communication
Inter-agent communication framework via Google A2A Protocol.
Quick Reference
| Task | Command |
|---|---|
| List agents | synapse list |
| Watch agents | synapse list --watch |
| Send message | synapse send <agent> "<message>" --from <sender> |
| Check file locks | synapse file-safety locks |
| View history | synapse history list |
| Initialize settings | synapse init |
Tip: Run synapse list before sending to verify the target agent is READY.
Sending Messages (Recommended)
Use synapse send command for inter-agent communication. This works reliably from any environment including sandboxed agents.
synapse send gemini "Please review this code" --from claude
synapse send claude "What is the status?" --from codex
synapse send codex-8120 "Fix this bug" --priority 3 --from gemini
Important: Always use --from to identify yourself so the recipient knows who sent the message and can reply.
Target Resolution:
- Type only:
claude,gemini,codex(if single instance) - Type-port:
claude-8100,codex-8120 - Exact ID:
synapse-claude-8100
Priority Levels
| Priority | Description | Use Case |
|---|---|---|
| 1-2 | Low | Background tasks |
| 3 | Normal | Standard tasks |
| 4 | Urgent | Follow-ups, status checks |
| 5 | Interrupt | Emergency (sends SIGINT first) |
# Normal priority (default)
synapse send gemini "Analyze this"
# Higher priority
synapse send claude "Urgent review needed" --priority 4
# Emergency interrupt
synapse send codex "STOP" --priority 5
Agent Status
| Status | Meaning |
|---|---|
| READY | Idle, waiting for input |
| PROCESSING | Busy handling a task |
Verify before sending: Run synapse list and confirm the target agent's Status column shows READY:
synapse list
# Output:
# NAME TYPE STATUS PORT
# synapse-claude-8100 claude READY 8100
# synapse-codex-8120 codex PROCESSING 8120 # <- busy, wait or use --priority 5
If the agent is PROCESSING, either wait for it to become READY or use --priority 5 for emergency interrupt.
Key Features
- Agent Communication: @agent pattern, priority control, response handling
- Task History: Search, export, statistics (
synapse history) - File Safety: Lock files to prevent conflicts (
synapse file-safety) - Settings: Configure via
settings.json(synapse init)
References
For detailed documentation, read:
references/commands.md- Full CLI command referencereferences/file-safety.md- File Safety detailed guidereferences/api.md- A2A endpoints and message formatreferences/examples.md- Multi-agent workflow examples
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?