sync-plugin-skills

Ensure that skills in plugins/synapse-a2a/skills/ accurately reflect:

• Current implementation in synapse/ directory
• README.md documentation
• Guides in guides/ folder

• After implementing new features or parameters
• After updating README.md or guides
• Before releasing a new version
• When /sync-plugin-skills is invoked

Step 1: Gather Current State

Read the following files to understand current implementation and documentation:

1. Implementation: Key files in synapse/

- synapse/tools/a2a.py - CLI tool implementation

- synapse/a2a_client.py - A2A client

- synapse/cli.py - Main CLI entry point

- synapse/commands/*.py - Command implementations

1. Documentation:

- README.md - Main documentation

- guides/usage.md - Usage guide

- guides/settings.md - Settings documentation

- guides/delegation.md - Delegation guide

1. Current Skills:

- plugins/synapse-a2a/skills/synapse-a2a/SKILL.md

- plugins/synapse-a2a/skills/synapse-a2a/references/*.md

- plugins/synapse-a2a/skills/delegation/SKILL.md

- plugins/synapse-a2a/skills/delegation/references/*.md

Step 2: Identify Gaps

Compare and identify:

• New CLI options/parameters not documented in skills
• Changed command syntax or behavior
• New features mentioned in README but missing from skills
• Deprecated or removed features still in skills
• Endpoint path inconsistencies

Step 3: Update Skills

Update skill files to match current state:

synapse-a2a/SKILL.md:

• Quick Reference table
• Command examples
• Feature descriptions

synapse-a2a/references/commands.md:

• Full CLI command documentation
• All options and parameters
• Example usage

synapse-a2a/references/api.md:

• Endpoint paths
• Request/response formats
• Extension endpoints

delegation/SKILL.md:

• Delegation patterns
• Command examples

delegation/references/modes.md:

• Communication methods
• A2A patterns

Step 4: Verify Consistency

Ensure consistency across:

• Endpoint paths match between README and skills
• Command syntax is identical
• Option names and defaults match implementation
• Examples use correct syntax

Command Options

```bash

# Check synapse/tools/a2a.py for current options

synapse send [options]

```

Key options to verify:

• --from / -f: Sender identification
• --priority / -p: Priority levels (1-5)
• --response / --no-response: Roundtrip control
• --reply-to: Reply to specific task

API Endpoints

```

/.well-known/agent.json # Agent Card

/tasks/send # Standard A2A

/tasks/send-priority # Synapse extension

/tasks/{id} # Task status

/status # Agent status

```

Settings Commands

```bash

synapse init # Initialize .synapse/

synapse config # Interactive TUI

synapse config show # View settings

synapse reset # Reset to defaults

```

After synchronization, report:

1. Files that were updated
2. Specific changes made
3. Any manual review needed

• Preserve skill file structure (YAML frontmatter + markdown)
• Keep descriptions concise and actionable
• Use imperative form for instructions
• Avoid duplicating content between SKILL.md and references/