skills_sync 0.0.4

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 install and update 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

Running sync will delete all existing skills in the target directories before installing the ones defined in your configuration.

Use the -y or --yes flag to skip the confirmation prompt in non-interactive environments.

Apply your configuration changes by running:

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