Sync Agents

Mirror plugin skills and commands into a flat .agents directory.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mberto10/mberto-compound --skill sync-agents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Sync Agents
Source: https://github.com/mberto10/mberto-compound/tree/main/plugins/tooling/skills/sync-agents
Command: npx skills add https://github.com/mberto10/mberto-compound --skill sync-agents

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill ensures that external agent platforms have an up-to-date and correctly formatted copy of all available plugin skills and commands, bridging the gap between the internal plugin structure and external discovery mechanisms.

Core Features & Use Cases

  • Mirrors Plugin Skills: Copies skills from plugins/<plugin>/skills/<skill>/ to .agents/skills/<plugin>-<skill>/.
  • Mirrors Commands: Copies commands from plugins/<plugin>/commands/<cmd>.md to .agents/workflows/<plugin>-<cmd>.md.
  • Standalone Directory: Creates a flat, portable .agents/ directory that external platforms can easily scan.
  • Use Case: After adding a new skill to the compound-engineering plugin, use this skill to sync it so that external agent platforms like Antigravity can discover and utilize it.

Quick Start

Run the sync-agents.sh script to update the .agents directory with the latest skills and commands.

Frequently Asked Questions about Sync Agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync plugin skills to a portable directory for external agent platforms?

You can sync plugin skills by running a script that mirrors them from `plugins/<plugin>/skills/` to a flat `.agents/skills/` directory, ensuring external agent platforms can easily discover and utilize them.

What is the best way to mirror plugin commands for external agent discovery?

Mirroring plugin commands involves copying them from `plugins/<plugin>/commands/<cmd>.md` to `.agents/workflows/<plugin>-<cmd>.md`. This creates a standalone directory structure that external platforms can easily scan.

Can I preview skill synchronization before overwriting the agents directory?

Yes, you can preview skill synchronization before making changes. The sync process supports dry-run previews, allowing you to see exactly what files will be mirrored or updated before executing the actual copy.

How do I clean stale entries from a synced agents directory?

To clean stale entries from a synced agents directory, you can use the cleaning functionality built into the synchronization script. This removes outdated files, keeping only the current skills and commands.

Does this skill sync work with external platforms like Antigravity?

Yes, this skill sync works with external platforms like Antigravity. It bridges the internal plugin structure to external discovery mechanisms by creating a flat, portable `.agents/` directory for scanning.

Why does my external agent platform fail to discover newly added plugin skills?

Your external agent platform fails to discover newly added plugin skills because they are not mirrored to the standalone `.agents/` directory. Running the sync script updates this directory, bridging the gap for discovery.