Skill Sync

A CLI tool to mirror and sync skills and subagents between different AI coding assistant directories (.cursor, .claude, .codex, etc.)

Installation

Global Installation

npm install -g @mattastovall/skill-sync

Using npx (no installation)

npx @mattastovall/skill-sync <command>

Usage

Commands

mirror <source> <target>

Mirror skills and subagents from one tool to another.

# Mirror Cursor skills to Claude
@mattastovall/skill-sync mirror cursor claude

# Mirror with options
@mattastovall/skill-sync mirror cursor claude --skills-only --force

sync

Sync all detected tools bidirectionally.

# Sync all tools
@mattastovall/skill-sync sync

# Dry run to preview changes
@mattastovall/skill-sync sync --dry-run

list

List all detected AI tool directories and their contents.

@mattastovall/skill-sync list

init <tool>

Initialize a new AI tool directory structure.

# Initialize .cursor directory
@mattastovall/skill-sync init cursor

# Initialize .claude directory
@mattastovall/skill-sync init claude

Options

• --skills-only - Only sync skills (not subagents)
• --subagents-only - Only sync subagents (not skills)
• --dry-run - Show what would be synced without making changes
• --force - Overwrite existing files without prompting
• -v, --verbose - Show detailed output

Supported Tools

• Cursor (.cursor/) - Cursor IDE
• Claude (.claude/) - Claude Code
• Codex (.codex/) - OpenAI Codex CLI
• Windsurf (.windsurf/) - Windsurf IDE
• Aider (.aider/) - Aider coding assistant
• Opencode (.opencode/) - Opencode CLI

Directory Structure

Each AI tool follows this structure:

.<tool>/
├── skills/           # Skill definitions
│   ├── skill1.md
│   └── skill2.json
├── subagents/        # Subagent configurations
│   ├── agent1.md
│   └── agent2.json
└── config.json       # Tool-specific settings

Examples

Example 1: Mirror Cursor to Claude

# First, initialize both directories
@mattastovall/skill-sync init cursor
@mattastovall/skill-sync init claude

# Add some skills to Cursor
# (manually create .cursor/skills/my-skill.md)

# Mirror to Claude
@mattastovall/skill-sync mirror cursor claude

Example 2: Sync All Tools

# Preview what would be synced
@mattastovall/skill-sync sync --dry-run

# Actually sync all tools
@mattastovall/skill-sync sync

Example 3: List Current Setup

@mattastovall/skill-sync list

Output:

Detected AI Tool Directories:

  cursor:
    Path: /project/.cursor
    Skills: 5 files
    Subagents: 2 files

  claude:
    Path: /project/.claude
    Skills: 3 files
    Subagents: 1 file

License

MIT