sync-droids

Transform Garura skills and agents into Factory Droid deployment formats.

3|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/kapilvirenahuja/garura --skill sync-droids
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-droids
Source: https://github.com/kapilvirenahuja/garura/tree/main/core/components/skills/sync-droids
Command: npx skills add https://github.com/kapilvirenahuja/garura --skill sync-droids

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill solves the problem of keeping Garura skills, plays, and agent definitions aligned with Factory Droid requirements so deployments don’t break due to format differences.

Core Features & Use Cases

  • Transforms Claude Code agents to Factory Droids: Converts agent .md definitions into Factory Droid .md files, including mapping model IDs and tool names.
  • Deploys skills/plays with frontmatter cleanup: Copies skills and plays into the target Factory directories while stripping unsupported fields.
  • Synchronizes Garura memory alongside deployments: Copies the framework’s memory directory to the matching destination used by the deployment.

Quick Start

Run the sync script in global mode (default) to deploy components into your home Factory directories.

Frequently Asked Questions about sync-droids

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

FAQPage Schema
How do I convert Claude Code agent definitions into Factory Droid formats?

This Skill converts Claude Code agent .md definitions into Factory Droid .md files by mapping model IDs and tool names to match Factory Droid requirements. It ensures deployments do not break due to format differences between the two frameworks.

How do I deploy Garura skills and plays into Factory directories?

You can deploy Garura skills and plays into Factory directories by running the sync script, which copies the source markdown files while stripping unsupported frontmatter fields. This process cleans target directories and applies deterministic filesystem operations.

Does the deployment process synchronize Garura memory files alongside skills?

Yes, the deployment process synchronizes Garura memory files by copying the framework's memory directory to the configured Factory memory destination. This ensures that memory is available alongside deployed skills and droids in the target environment.

Can I deploy Factory Droids in project-scoped or global installation modes?

Yes, you can deploy Factory Droids in either project-scoped or global installation modes by using the --project or --global flags. Running the sync script in global mode deploys components into your home Factory directories by default.

What is the best way to keep Garura agent definitions aligned with Factory Droid requirements?

The best way to keep Garura agent definitions aligned with Factory Droid requirements is to use a transformation script that cleans targets, copies markdown sources, and maps frontmatter fields. This guarantees deterministic synchronization during environment setup.

Why do my Factory Droid deployments break due to frontmatter format differences?

Factory Droid deployments break when Garura skills, plays, or agent definitions contain unsupported frontmatter fields or mismatched model identifiers. Applying frontmatter cleanup and model ID mapping before deployment resolves these format inconsistencies.