mcpField
S
sync-plugin-skills

sync-plugin-skills

github.com/s-hiraokuAgent workflows1756 installsUpdated 2w ago
Repository

About sync-plugin-skills

A maintenance skill for keeping the synapse-a2a plugin’s skill files aligned with the Synapse implementation and documentation. It guides agents through checking for gaps, updating references, and verifying consistency before releases or after changes.

Key features

  1. 01Compare implementation and documentation
  2. 02Find outdated or missing skill details
  3. 03Update command and API references
  4. 04Verify syntax, options, and endpoints

Use cases

  1. 01After adding CLI options or features
  2. 02After README or guide changes
  3. 03Before releasing a version

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/s-hiraoku/synapse-a2a --skill sync-plugin-skills

After installing, type/sync-plugin-skillsin Claude Code to confirm it loaded.

Details

From the project README

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/

Comments

Markdown supported