skill git - version control for your skills

skill-git is a version control system for AI agent skills. It gives each skill folder its own independent git history, tagged with semantic versions (v1.0.0, v1.1.0, …), so you can commit snapshots and revert to any previous version at any time.

Six commands are available:

• init — set up version tracking for all skills under an agent directory
• commit — snapshot changed skills with a version bump and commit message
• revert — roll back one or more skills to a previous version
• check — check a skill for internal rule conflicts, agent config conflicts, and security issues
• scan — scan registered skills for semantic overlap and get merge suggestions
• merge — merge two or more similar skills into one stronger, more complete skill

Prerequisites

Before using any command, ensure these tools are installed:

• git — git --version (install: brew install git on macOS, apt install git on Linux)
• jq — jq --version (install: brew install jq on macOS, apt install jq on Linux)

The init command will check for git automatically. If jq is missing, commit and revert will fail when updating config.json.

Intent Routing

Parse $ARGUMENTS. If $ARGUMENTS is empty, infer intent from the user's natural language message.

Menu (show only when intent is unclear)

skill-git — version control for your AI skills

Available commands:

  1. init      Set up version tracking for your skills
  2. commit    Snapshot changed skills with a new version
  3. revert    Roll back a skill to a previous version
  4. check     Check a skill for conflicts and security issues
  5. scan      Scan all skills for overlap and merge candidates
  6. merge     Merge two or more similar skills into one

Which would you like to run? (enter a number, name, or describe what you want)

Wait for the user's response, then route to the appropriate .md file above.

Asset Skills

The check, scan, and merge commands depend on two internal library skills located in assets/:

• assets/rule-extraction/SKILL.md — extracts structured rule lists from skill markdown files
• assets/conflict-patterns/SKILL.md — detects conflicts between two rule lists (direct contradiction, semantic contradiction, overlap, security patterns)