Sync Plugin Skills

Synchronize plugin skills with the current implementation and documentation.

Purpose

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

• Current implementation in synapse/ directory

• README.md documentation

• Guides in guides/ folder

When to Use

• After implementing new features or parameters

• After updating README.md or guides

• Before releasing a new version

• When /sync-plugin-skills is invoked

Workflow

Step 1: Gather Current State

Read the following files to understand current implementation and documentation:

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

Documentation:

• README.md

• Main documentation

• guides/usage.md

• Usage guide

• guides/settings.md

• Settings documentation

Current Skills:

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

• plugins/synapse-a2a/skills/synapse-a2a/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

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

Key Areas to Check

Command Options

Check synapse/tools/a2a.py for current options

synapse send <target> <message> [options]

Key options to verify:

• --from / -f : Sender identification

• --priority / -p : Priority levels (1-5)

• --wait / --notify / --silent : Response mode 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

synapse init # Initialize .synapse/ synapse config # Interactive TUI synapse config show # View settings synapse reset # Reset to defaults

Output

After synchronization, report:

• Files that were updated

• Specific changes made

• Any manual review needed

Notes

• 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/