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-skillsIs 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-skillsis invoked
Workflow
Step 1: Gather Current State
Read the following files to understand current implementation and documentation:
-
Implementation: Key files in
synapse/synapse/tools/a2a.py- CLI tool implementationsynapse/a2a_client.py- A2A clientsynapse/cli.py- Main CLI entry pointsynapse/commands/*.py- Command implementations
-
Documentation:
README.md- Main documentationguides/usage.md- Usage guideguides/settings.md- Settings documentation
-
Current Skills:
plugins/synapse-a2a/skills/synapse-a2a/SKILL.mdplugins/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:
- Files that were updated
- Specific changes made
- 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/
How can the creator link this skill?
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>