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.

TriggerActioninit / "initialize" / "set up" / "track my skills" / "start tracking"Read $CLAW_SKILL_DIR/init.md and follow it exactlycommit / "save" / "snapshot" / "new version" / "save skill changes"Read $CLAW_SKILL_DIR/commit.md and follow it exactlyrevert / "roll back" / "undo" / "restore" / "go back to"Read $CLAW_SKILL_DIR/revert.md and follow it exactlycheck / "check skill" / "validate skill" / "find conflicts" / "skill conflicts"Read $CLAW_SKILL_DIR/check.md and follow it exactlyscan / "scan skills" / "find overlapping skills" / "which skills can I merge"Read $CLAW_SKILL_DIR/scan.md and follow it exactlymerge / "merge skills" / "combine skills" / "consolidate skills"Read $CLAW_SKILL_DIR/merge.md and follow it exactlyNo args or ambiguous intentShow the menu below and wait for user input

Menu (show only when intent is unclear)#

text

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)