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/
2. synapse/tools/a2a.py - CLI tool implementation
3. synapse/a2a_client.py - A2A client
4. synapse/cli.py - Main CLI entry point

5. synapse/commands/*.py - Command implementations

6. Documentation:

7. README.md - Main documentation
8. guides/usage.md - Usage guide
9. guides/settings.md - Settings documentation

10. guides/delegation.md - Delegation guide

11. Current Skills:

12. plugins/synapse-a2a/skills/synapse-a2a/SKILL.md
13. plugins/synapse-a2a/skills/synapse-a2a/references/*.md
14. plugins/synapse-a2a/skills/delegation/SKILL.md
15. 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

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)
- --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

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/