skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
s-hiraoku/synapse-a2a56 installs

sync-plugin-skills

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.

How do I install this agent skill?

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

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is intended for synchronizing documentation with code within its repository. It is generally safe but presents a potential surface for indirect prompt injection because it reads and writes files based on repository content that could be influenced by external contributors.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerpass

    1 file scanned · No issues

What does this agent skill do?

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/

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/s-hiraoku/synapse-a2a/sync-plugin-skills">View sync-plugin-skills on skillZs</a>