sync-plugin-skills

name	sync-plugin-skills
description	This skill synchronizes plugin skills (plugins/synapse-a2a/skills/) with the current implementation, README.md, and guides folder. Use this skill when implementation changes have been made, new features added, or documentation updated, to ensure plugin skills stay up-to-date. Triggered by /sync-plugin-skills command or when significant code changes are detected.

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:

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

2. Documentation:

   • README.md - Main documentation
   • guides/usage.md - Usage guide
   • guides/settings.md - Settings documentation

3. 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:

1. Files that were updated
2. Specific changes made
3. 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/