skills_sync 0.2.1

A CLI tool to keep AI Agent Skills (SKILL.md) in sync across your projects based on a central configuration file.

skills_sync 🚀

A CLI tool to keep AI Agent Skills (SKILL.md) in sync across your projects based on a central skills.yaml configuration file.

Key Features

• 📦 Batch Sync: Install and sync multiple skills from various repositories or local folders.
• ⚡ Wildcard Support: Use * for batch selection and ! for exclusions in your configuration.
• 🧐 Optimization: Save AI context window pressure by organizing skills and using security-audited skills.
• 🤖 AI-Ready: Bundled with dedicated AI Agent Skills to help the AI manage your configuration.

---

Core Skills for AI Agents

This repository includes dedicated skills to help AI agents manage your development environment:

• skills-sync: Teaches the AI how to use this CLI tool correctly, ensuring it doesn't make accidental changes.
• skills-optimizer: Enables the AI to analyze your tech stack and propose optimizations for your skills.yaml, including security audits of new skills.

To use them, add mono0926/skills-sync to your skills.yaml.

---

Installation

dart pub global activate skills_sync

Quick Start

1. Initialize: Run skills_sync init to generate the default global configuration at ~/.config/skills_sync/skills.yaml.
2. Configure: Edit the configuration to add your favorite skill sources.
3. Sync: Run skills_sync sync in your project to thoroughly sync skills (deletes extra skills by default).
4. Update: Run skills_sync update for a quick version update of all installed skills.

---

Detailed Usage

1. Initialization

Run the following command to set up your configuration:

skills_sync init

This generates ~/.config/skills_sync/skills.yaml. By default, skills_sync uses this global configuration.

Tip

You can also place a skills.yaml in your project root for project-specific settings. If present, it will take precedence over the global configuration.

2. Configuration

Edit the global or project-local skills.yaml to specify which skills to sync. You can use wildcards (*) and exclusions (!).

3. Synchronization

Warning

By default, sync will delete all existing skills in the target directories before installing the ones defined in your configuration to ensure a clean state.

Use the -y or --yes flag to skip the confirmation prompt.

Apply your configuration changes by running:

skills_sync sync

Options:

• --clean: (Default: true) Delete existing skills before syncing. Use --no-clean to skip this step for a faster sync.
• --agent <name>: Specify the target agent (default: antigravity). Use * to target all agents.

4. Update

For a faster update that only checks for the latest versions of your currently configured skills without reaching for a clean state, use the update command:

skills_sync update

This runs npx skills update across all configured global and local paths.

---

Configuration Example

See example/mono/skills.yaml for a real-world example.

global:
  mono0926/skills:
  anthropics/skills:
    - '*' # All skills
    - '!recipe-*' # Exclude skills starting with 'recipe-'

~/Git/my-project:
  mono0926/skills:
    - flutter-* # Only flutter-related skills

---

Subcommands

• init: Generates configuration files.
• config: Opens configuration in your default editor.
• sync: Thoroughly syncs skills (re-installs).
• update: Quickly updates existing skills in-place.
• list: Shows current configuration and installation status.

Environment Requirements

• Node.js: Required for npx command.
• Git: Required for fetching remote repositories.

Developer Note

To run locally for development:

dart pub get
dart run skills_sync sync

License

MIT