sync-plugin-skills

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
   • guides/delegation.md - Delegation guide

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

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/