skills_sync 0.0.2

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.

---

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 global configuration to add your favorite skill sources.
3. Sync: Run skills_sync sync to install and update skills in your project.

---

---

Installation

dart pub global activate skills_sync

Quick Start

Detailed Usage

1. Initialization

Run this in your project root:

skills_sync init

This generates ~/.config/skills_sync/skills.yaml. By default, skills_sync uses this global configuration to manage skills across all your projects.

Note

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. Synchronization

Sync your skills based on skills.yaml:

skills_sync sync

---

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: Installs and syncs skills.
• 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