KnowledgeXLab / skill-git

Git, but for your
AI agent skills.

Track changes, roll back bad edits, and merge overlapping skills — across Claude, Gemini, Codex, and OpenClaw.

$
$
Get Started View on GitHub
Features

Everything your skills need

Stop managing messy, fragmented agent capabilities.

📦

Version Control

Each skill gets its own independent git repo with semantic versioning. Full history, always.

⏪

Safe Rollback

Roll back any skill to any previous version. Atomic operation — backup first, restore on failure.

🛡️

Conflict Detection

Audit skills for internal rule conflicts, contradictions, and security issues before they cause problems.

🔀

Smart Merge

Scan for overlapping skills and merge them into one stronger, unified tool. No more duplicates.

🌐

Multi-Platform

Works across Claude, OpenClaw, Gemini, and Codex out of the box.

🚀

Portable

Each skill folder is self-contained. Move or share it — the full history travels with it.

skill-git in action
Commands

Six commands. Full control.

Everything you need, nothing you don't.

/skill-git:initInitialize version tracking for all your skills across one or more agents.
/skill-git:commitSnapshot changes with an auto-bumped semver tag. You confirm before anything is written.
/skill-git:revertRoll back a skill to any previous version. Defaults to the previous tag if no version given.
/skill-git:checkAudit a skill for rule conflicts, contradictory configs, and security issues.
/skill-git:scanFind semantically overlapping skills. Each pair is rated and cached for merge to pick up.
/skill-git:mergeCombine two similar skills into one. Conflicts resolved interactively. Nothing written until you confirm.
Installation

Up and running in seconds

Pick your platform and paste one command.

claude plugin marketplace add KnowledgeXLab/skill-git
claude plugin install skill-git@knowledgexlab
# Then initialize
/skill-git:init

# Or specify the agent
/skill-git:init -a claude
clawhub install skill-git
# Then initialize
/skill-git:init -a openclaw
gemini extensions install https://github.com/KnowledgeXLab/skill-git
# Then initialize
/skill-git:init -a gemini
npx skills add KnowledgeXLab/skill-git -a codex
# Then initialize
/skill-git:init -a codex
Best Practices

Get the most out of skill-git

Workflow guides and recommendations.

🚀 Version-control your skill library from scratch

You just set up a few skills and want to start tracking them properly.

/skill-git:init
/skill-git:commit

→ Every skill folder gets its own .git repo, tagged v1.0.0. Future changes are one commit away.

🔖 Save a new version after improving a skill

You've refined your humanizer skill and want to snapshot the update.

/skill-git:commit

→ The agent diffs the changes, recommends a patch or minor bump, and tags the new version (e.g. v1.0.2). You confirm before anything is written.

🔀 Merge two overlapping skills into one

You notice code-review and critic feel redundant and want to consolidate.

/skill-git:scan code-review critic
/skill-git:merge code-review critic

→ scan rates the overlap (★★★ / ★★☆ / ★☆☆). merge combines them interactively — nothing is written until you confirm.

⏪ Roll back a skill that broke your workflow

Your latest planner update introduced conflicts and you want to undo it.

/skill-git:revert planner
/skill-git:revert planner v1.0.2

→ Reverts to the previous version (or a specific tag). A backup is taken first and restored automatically if anything fails.